Instagram Data Skill

La vía de lectura determinista para datos públicos de Instagram a través de UnifAPI. Esta es una Data Skill: no ejecuta un trabajo de marketing por sí sola — nombra las operaciones instagram/... concretas, las formas de respuesta y los gotchas para que cualquier workflow creator-first (shortlisting, audience-fit, contexto de pricing) lea de una receta conocida en lugar de redescubrir la superficie cada vez.

Solo lectura — ojos, no manos. Investiga datos públicos de Instagram y devuelve registros citados; nunca publica, comenta ni envía DMs, y UnifAPI nunca guarda credenciales de Instagram.

Usa la skill unifapi para obtener evidencia en vivo

Conecta una vez a través de la skill compartida unifapi (OAuth MCP), luego llama a las operaciones de abajo. Los perfiles están indexados por {username} y los posts por su {shortcode} (el segmento de la URL) — instagram/resolve/* mapea entre username↔user-id y shortcode↔media-id cuando lo necesites. Conserva cualquier metadato de billing para que el output pueda indicar el coste por registro.

Contrato de respuesta

Los endpoints de entidad única devuelven el objeto en data:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

Los endpoints de lista devuelven un array en data más pagination:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

Cuando pagination.has_more es true, pasa pagination.next_cursor como el cursor de la siguiente petición. Conserva siempre billing al reportar el coste.

Operaciones core

¿Necesitas un campo que no esté listado aquí? Usa get_operation de la skill unifapi para leer el esquema exacto antes de llamar — pero elige la operación de esta tabla, no descubras a ciegas.

Workflow

Las recetas deterministas. Elige la que coincida con el trabajo; cada una nombra exactamente qué llamar.

1. Resuelve un perfil. Llama a instagram/users/{username} para follower_count, media_count, is_private e is_verified.
2. Lee contenido y engagement. Llama a instagram/users/{username}/posts y .../reels; cada InstagramPost lleva like_count, comment_count y play_count/view_count para vídeo — e is_paid_partnership para señalar contenido patrocinado. Pagina vía next_cursor.
3. Lee la reacción. Llama a instagram/posts/{shortcode}/comments (y el endpoint de respuestas) para el sentimiento sobre un post top.
4. Descubre nuevos handles. Llama a instagram/search?q=..., instagram/explore o instagram/locations/{id}/posts, luego resuelve los handles que aparecen y vuelve al paso 1.
5. Mapea una red o audiencia. Llama a instagram/users/{username}/followers, .../following o .../tagged-posts (quién los presenta) para trabajo de alcance.
6. Cita todo. Cada cifra se ata al post o perfil del que vino; reporta billing.records_charged (o estima cuando falte el metadato de billing).

Notas de forma

• InstagramUser — indexado por {username}. follower_count, following_count, media_count, is_verified, is_private.
• InstagramPost — indexado por {shortcode}. caption, like_count, comment_count, play_count, view_count, taken_at, media_type, is_paid_partnership, user, location, carousel.
• InstagramComment — text, like_count, child_comment_count.
• InstagramLocation — name, lat, lng, media_count.

Gotchas

• Los perfiles están indexados por {username}, los posts por {shortcode} — ambos se leen de la URL pública de IG. Usa instagram/resolve/* solo cuando necesites el user-id o media-id numérico.
• Una cuenta privada (is_private) expone el perfil pero limita los medios — sácalo a la superficie, no encubras una cobertura escasa.
• is_paid_partnership marca los posts patrocinados divulgados — evidencia útil para pricing y brand-safety, repórtalo.
• Un saldo bajo puede truncar silenciosamente páginas de lista: comprueba billing.truncated_due_to_balance — cuando es true la página es parcial.

Output

Devuelve los registros que el workflow que llama necesita, cada uno citado a su post o perfil, más una nota de coste de una línea (records_charged). Cuando esta skill se usa directamente, un resumen de creador compacto es el predeterminado:

**@handle** — {followers} followers, {media} posts, verified {yes/no}. Recent posts: avg {likes} likes / {comments} comments. Paid partnerships: {N}. Evidence: {post URLs}. Records: ~{N}.

Related skills

• kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — tarifica y evalúa creadores de Instagram sobre esta vía de lectura.
• unifapi — la skill de datos compartida: conecta MCP y busca esquemas exactos con get_operation.