Qué necesita Meta (una vez)
Antes de que Claude Code pueda tocar tus métricas, Meta necesita unas cuantas cosas conectadas. Es tedioso, es una tarde, y lo hacés una sola vez. Después el sistema solo lee.
No dejes que este paso te espante — es toda la razón por la que existe la ventaja. Los que abandonan acá son la razón por la que conectar tu propia cuenta sigue siendo raro.
Las cuatro cosas que pide Meta
Todo lo de abajo existe para que Meta confíe en que vos sos dueño de la cuenta que estás consultando.
- Una cuenta de Instagram Business o Creator. Las cuentas personales no pueden pegarle a los endpoints de insights. Cambiar es gratis — app de Instagram → Configuración → Tipo de cuenta → pasate a Business o Creator.
- Esa cuenta ligada a una página de Facebook. La Graph API llega a Instagram a través de una página. Sin página, no hay data. Ligala desde la app de Instagram o en Meta Business Suite.
- Una app en Facebook Developers. Andá a developers.facebook.com, creá una app, y agregá el producto Instagram. Eso es lo que emite tu token.
- El permiso
instagram_manage_insights. Este es el permiso exacto que desbloquea reach, saves, shares y watch time. Sin él te da campos básicos pero nada de la señal owner-only que hace que valga la pena armar este sistema.
El token — y la trampa
Tu app emite un token de acceso: el string que Claude Code manda con cada request para probar que sos vos. Hay dos tipos, y la diferencia importa.
- Un token de usuario de larga duración funciona 60 días, después muere.
- Un System User token, creado en Business Manager, no expira.
Los tokens de larga duración expiran a los 60 días. Si conectás un token de usuario normal y te vas, tu puller deja de funcionar en silencio a los dos meses y vas a pensar que el sistema se rompió. Para cualquier cosa que no quieras estar cuidando, creá un System User token en Business Manager — es permanente — y guardalo una sola vez.
Para un primer pass, un token de 60 días sirve para probar que el loop entero funciona. Solo tené en cuenta que el reloj corre, y pasate a un System User token antes de que te olvides de que existe.
La barrera de los 1.000 followers
Un requisito más que hace tropezar a la gente: Meta solo devuelve insights para cuentas con 1.000+ followers. Por debajo de eso, los endpoints existen pero vuelven vacíos en los campos interesantes.
Si todavía no llegaste, no te frenes — armá primero el competitor tracker (esa data es pública y no tiene barrera de followers), y conectá tu propia cuenta el momento que cruzás los 1.000. El sistema está diseñado para que las dos mitades compartan un mismo schema de datos; tu lado se enchufa después.
¿Por qué conviene usar un System User token en vez de un token de larga duración normal?
Lo que te llevás
Setup de Meta una sola vez: cuenta Business/Creator ligada a una página de Facebook, una app en Facebook Developers, un token, y el permiso instagram_manage_insights — más 1.000+ followers para que los insights devuelvan data. Usá un System User token para que nunca expire. Hacelo una vez; el sistema lee para siempre después.