Analíticas
Una sola herramienta, get_insights, lee las cifras que cada red reporta de tus cuentas: vistas, alcance, interacción, seguidores, tus mejores publicaciones y cuándo publicar. Pregunta con tus propias palabras: tu app de IA elige el informe y la cuenta.
Informes
Tu app de IA pasa report; overview es el predeterminado. No todas las redes tienen todos los informes: la tabla de abajo indica cuáles.
overview predeterminadoVistas, alcance, interacción y seguidores en los últimos days, con los términos de cada red más un resumen común a todas. Sin account, todas las cuentas con analíticas lado a lado.followers El número de seguidores día a día (suscriptores en YouTube), con los seguidores ganados y perdidos.audience Seguidores por país y ciudad, y por edad y género cuando la red lo reporta.top_posts Tus mejores publicaciones del periodo, ordenadas por interacción o por sort (vistas, alcance, me gusta, comentarios, compartidos, fecha). Sin account, en todas las cuentas con analíticas.timing Los días de la semana y franjas horarias que mejor funcionan para tus publicaciones (en UTC), con qué frecuencia publicas frente a la interacción que recibes y lo rápido que llegan a su pico. Instagram: cuándo están conectados tus seguidores.inbox Mensajes recibidos y enviados, la mediana del tiempo hasta la primera respuesta y las horas de más actividad.search_keywords Las búsquedas de Google que mostraron tu Perfil de Empresa, mes a mes.post Las cifras de una publicación, por el post_id de list_posts, de las mejores publicaciones o de create_post. details: true añade su curva día a día y los datos extra de la red.Por red
Qué informe tiene cada red, según el servidor en vivo.
- Threads: las cifras vienen de sus publicaciones, no de la cuenta.
- Hasta 365 días atrás; las cifras de la cuenta llegan hasta 89 días.
- LinkedIn, WhatsApp, Telegram, Instagram, Facebook y WordPress no tienen cifras aquí.
Cómo pregunta tu IA
No tienes que nombrar informes. Pregunta como le preguntarías a un colega; tu app de IA lo convierte en una llamada.
get_insights({ report: "overview", days: 30 })Todas las cuentas con analíticas lado a lado, en los últimos 30 días.
get_insights({ report: "top_posts", provider: "tiktok" })Tus publicaciones de TikTok, ordenadas por interacción. Pide vistas o compartidos y las ordena por eso.
get_insights({ report: "timing", provider: "instagrambusiness" })Los mejores días y horas según tus propias publicaciones, y cuándo están conectados tus seguidores.
get_insights lee lo que reporta cada red y nunca publica, da me gusta ni cambia nada. Necesita el permiso View profiles.Ejemplo
Lo que devuelve un resumen de todas las cuentas: las cifras propias de cada red y un resumen con la misma forma en todas.
metricsLas cifras con el nombre que les da la red (reach, saves, page_media_view…), para que nada se pierda en la traducción.headlinevistas, alcance, interacción y seguidores con la misma forma en todas las redes; null cuando una red no lo reporta.sourceaccount cuando la red reporta cifras de la cuenta; posts cuando se suman a partir de las publicaciones de la cuenta (Threads).{ "report": "overview", "from": "2026-10-11", "to": "2026-11-09", "accounts": [ { "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13", "provider": "instagrambusiness", "name": "Northwind Studio", "source": "account", "metrics": { "reach": 12480, "views": 48210, "accounts_engaged": 1034, "total_interactions": 2876, "likes": 2310, "comments": 184, "saves": 212, "shares": 97, "profile_views": 1920, "website_clicks": 61 }, "headline": { "views": 48210, "reach": 12480, "engagement": 2876, "followers": null, "followers_gained": null, "followers_lost": null } }, { "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48", "provider": "facebookpages", "name": "Northwind Studio", "source": "account", "metrics": { "page_media_view": 21340, "page_total_media_view_unique": 8120, "page_views_total": 640, "page_post_engagements": 1120, "page_video_views": 3010, "page_follows": 3420, "followers_gained": 58, "followers_lost": 9 }, "headline": { "views": 21340, "reach": 8120, "engagement": 1120, "followers": 3420, "followers_gained": 58, "followers_lost": 9 } }, { "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72", "provider": "pinterest", "name": "Northwind Studio", "source": "account", "metrics": { "impressions": 30900, "engagements": 1460, "saves": 380, "pin_clicks": 610, "outbound_clicks": 205, "follower_count": 1288, "followers_gained": 41, "followers_lost": 6 }, "headline": { "views": 30900, "reach": null, "engagement": 1460, "followers": 1288, "followers_gained": 41, "followers_lost": 6 } } ] }
La herramienta
Exactamente lo que tu app de IA recibe de tools/list.
How an account is doing, as its network reports it (Instagram Business, LinkedIn Pages, TikTok, YouTube, Pinterest, Google Business Profile, Threads). report: overview (default): the account's figures over the last `days` (views, reach, engagement, followers… as the network reports them, plus a comparable headline); without account, every analytics account side by side; followers: the follower (YouTube: subscriber) count day by day, with gained and lost; audience: followers by country, city, age and gender, as far as the network reports them; top_posts: the best posts of the last `days` by `sort` (engagement by default), with their figures; without account, across every analytics account; timing: when to post, from the account's own posts (best weekday × hour slots in UTC, posts per week vs engagement, how fast posts reach their final engagement; Instagram: when followers are online); inbox: messages received and sent, median time to first reply and the busiest hours; search_keywords: the Google searches that showed the Business Profile, by month; post: one post's figures (post_id from list_posts, top_posts or create_post); details=true adds its day-by-day curve and the network's extras (Facebook earnings, YouTube retention and daily views). Not every network has every report (followers: Instagram Business, LinkedIn Pages, TikTok, YouTube, Pinterest; audience: Instagram Business, TikTok, YouTube; inbox: Instagram Business; search_keywords: Google Business Profile). The personal LinkedIn, WhatsApp, Telegram and the personal Instagram and Facebook logins have no insights here. Read-only.
accountstringaccount_id from list_accounts. Leave it out for overview or top_posts to cover every analytics account; the other reports need it when several are connected.providerenumreportenumdaysintegerpost_idstringpost_id (or the scheduled_post_id create_post gave)detailsbooleansortenumtop_posts: what ranks the postslimitintegertop_posts: how many postscursorstringsearch_keywords: next_cursor from the previous page{ "structuredContent": { "report": "overview", "from": "2026-10-11", "to": "2026-11-09", "accounts": [ { "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13", "provider": "instagrambusiness", "name": "Northwind Studio", "source": "account", "metrics": { "reach": 12480, "views": 48210, "accounts_engaged": 1034, "total_interactions": 2876, "likes": 2310, "comments": 184, "saves": 212, "shares": 97, "profile_views": 1920, "website_clicks": 61 }, "headline": { "views": 48210, "reach": 12480, "engagement": 2876, "followers": null, "followers_gained": null, "followers_lost": null } }, { "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48", "provider": "facebookpages", "name": "Northwind Studio", "source": "account", "metrics": { "page_media_view": 21340, "page_total_media_view_unique": 8120, "page_views_total": 640, "page_post_engagements": 1120, "page_video_views": 3010, "page_follows": 3420, "followers_gained": 58, "followers_lost": 9 }, "headline": { "views": 21340, "reach": 8120, "engagement": 1120, "followers": 3420, "followers_gained": 58, "followers_lost": 9 } }, { "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72", "provider": "pinterest", "name": "Northwind Studio", "source": "account", "metrics": { "impressions": 30900, "engagements": 1460, "saves": 380, "pin_clicks": 610, "outbound_clicks": 205, "follower_count": 1288, "followers_gained": 41, "followers_lost": 6 }, "headline": { "views": 30900, "reach": null, "engagement": 1460, "followers": 1288, "followers_gained": 41, "followers_lost": 6 } } ] }, "content": [ { "type": "text", "text": "Instagram Business (Northwind Studio): views 48,210, reach 12,480, engagement 2,876; Facebook Pages (Northwind Studio): views 21,340, reach 8,120, engagement 1,120, followers 3,420, followers gained 58, followers lost 9; Pinterest (Northwind Studio): views 30,900, engagement 1,460, followers 1,288, followers gained 41, followers lost 6." } ] }
- Recibida09:41:02
- Dentro de los límites840 de 3000 hoy
- Enviada09:41:03