Cross-Network Analytics & Live Social Listening
analytics_queryQuery cross-network engagement analytics (account_overview, post_metrics, audience_growth), compute AI-recommended optimal posting windows (best_times), or execute live real-time social listening (social_listen) across Bluesky, Hacker News, Dev.to, Reddit, and X. Use social_listen to discover live community threads, competitor mentions, and high-intent buyer questions matching any keyword query. Returns aggregated engagement metrics, X Smart Link cost savings, optimal CET/UTC posting slots, or live upstream social signals with direct thread URLs and author handles.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "analytics_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search keyword, brand name, competitor handle, or buyer-intent phrase when running live `action: 'social_listen'` (e.g. 'MCP server social media API' or 'n8n AI agent workflow'). | |
| action | Yes | Analytics or listening mode: 'account_overview' for cross-network KPIs, 'post_metrics' or 'post_detail' for individual post performance (including live YouTube viewCount, likeCount, commentCount, and publishedAt age in hours), 'audience_growth' for follower velocity, 'best_times' for highest-lift publishing windows, or 'social_listen' for live keyword/intent discovery. | |
| postId | No | Optional post identifier (`post_...`) when inspecting granular metrics via `action: 'post_metrics'` or `'post_detail'`. | |
| platform | No | Optional social network filter to scope metrics or listening to a single platform. | |
| accountId | No | Connected account id (`acc_...`). For Instagram/Facebook/Threads, returns live account insights plus recent posts with per-post insights. | |
| postLimit | No | Max recent posts (1-25) with per-post insights for Instagram/Facebook/Threads overviews. | |
| profileId | No | Brand profile identifier (`prof_...`) to aggregate analytics for. | prof_allometrik |
| periodDays | No | Lookback window in days (e.g. 7, 30, 90) for aggregating impressions, engagements, and follower growth. | |
| externalPostId | No | Optional native platform video/post ID (e.g. YouTube `videoId`) to fetch live `viewCount`, `likeCount`, `commentCount`, and `publishedAt` age in hours. |