MCPMCP-Tools/Beiträge/get_post_analytics

get_post_analytics

Readposts:read

Post analytics rollup for a client: engagement summary, per-platform breakdown, trends, top posts. Use for social media performance, content effectiveness. channel `brand` (default) is the client's brand-level pages; `local` is its locations' own profiles, optionally narrowed to the locations carrying one tag (a name from list_location_tags). The result says which slice it covers (`scope`). Brand and local are separate numbers — add them yourself if you want a combined figure, and note a page can appear in only one. Pass postId (a published YouTube video) to get that video's YouTube Analytics report instead — the post page's analytics panel — filtered by `report` (daily, totals, retention, traffic, searches, geography, demographics, devices, subscribers, content, revenue; default daily) and from/to (YYYY-MM-DD, required with postId).

Parameter
clientIdstringerforderlich
Client id (from list_clients). Accepts the database ID or public cli- ID. IDs must belong to the authenticated agency and permitted client.
fromstringoptional
From (ISO; YYYY-MM-DD for a video report).
tostringoptional
To (ISO; YYYY-MM-DD for a video report).
channel"brand" | "local"optional
brand (default): the client's brand-level pages. local: its locations' own profiles.
tagstringoptional
With channel local only: narrow to the locations carrying this tag (by name, from list_location_tags).
postIdstringoptional
Optional: a YouTube post id — returns that video's YouTube Analytics report. Accepts the database ID or public post- ID. IDs must belong to the authenticated agency and permitted client.
report"daily" | "totals" | "retention" | "traffic" | "searches" | "geography" | "demographics" | "devices" | "subscribers" | "content" | "revenue"optional
Video report (with postId).
submissionIdstringoptional
Optional: which YouTube submission of the post.
Beispielanfrage
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_post_analytics",
    "arguments": {
      "clientId": "string"
    }
  }
}
Beispielantwort
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Die Antwortform dient nur zur Veranschaulichung — der tatsächliche Inhalt hängt vom Tool und Ihren Daten ab.