Instagram Data Skill

O caminho de leitura determinístico para dados públicos do Instagram através da UnifAPI. Este é um Data Skill: ele não roda um trabalho de marketing por conta própria — ele nomeia as operações instagram/... concretas, os formatos de resposta e as pegadinhas para que qualquer fluxo de trabalho creator-first (shortlisting, audience-fit, contexto de pricing) leia a partir de uma receita conhecida em vez de redescobrir a superfície a cada vez.

Read-only — olhos, não mãos. Ele pesquisa dados públicos do Instagram e retorna registros citados; nunca publica, comenta nem envia DM, e a UnifAPI nunca guarda credenciais do Instagram.

Use o skill unifapi para evidências ao vivo

Conecte uma vez através do skill compartilhado unifapi (OAuth MCP), depois chame as operações abaixo. Os perfis são chaveados por {username} e os posts por seu {shortcode} (o segmento da URL) — instagram/resolve/* mapeia entre username↔user-id e shortcode↔media-id quando você precisar. Mantenha qualquer metadado de billing para que a saída possa declarar o custo em registros.

Contrato de resposta

Endpoints de entidade única retornam o objeto em data:

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

Endpoints de lista retornam um array em data mais pagination:

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

Quando pagination.has_more é true, passe pagination.next_cursor como o cursor da próxima requisição. Sempre preserve billing ao reportar o custo.

Operações principais

Precisa de um campo não listado aqui? Use o get_operation do skill unifapi para ler o schema exato antes de chamar — mas escolha a operação a partir desta tabela, não descubra às cegas.

Fluxo de trabalho

As receitas determinísticas. Escolha a que combina com o trabalho; cada uma nomeia exatamente o que chamar.

1. Resolva um perfil. Chame instagram/users/{username} para follower_count, media_count, is_private e is_verified.
2. Leia conteúdo e engajamento. Chame instagram/users/{username}/posts e .../reels; cada InstagramPost carrega like_count, comment_count e play_count/view_count para vídeo — e is_paid_partnership para sinalizar conteúdo patrocinado. Pagine via next_cursor.
3. Leia a reação. Chame instagram/posts/{shortcode}/comments (e o endpoint de replies) para o sentimento em um post de topo.
4. Descubra novos handles. Chame instagram/search?q=..., instagram/explore ou instagram/locations/{id}/posts, depois resolva os handles que surgirem e volte ao passo 1.
5. Mapeie uma rede ou audiência. Chame instagram/users/{username}/followers, .../following ou .../tagged-posts (quem os apresenta) para trabalho de alcance.
6. Cite tudo. Todo número se vincula de volta ao post ou perfil de onde veio; reporte billing.records_charged (ou estimativa quando o metadado de billing estiver ausente).

Notas de formato

• InstagramUser — chaveado por {username}. follower_count, following_count, media_count, is_verified, is_private.
• InstagramPost — chaveado 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.

Pegadinhas

• Os perfis são chaveados por {username}, os posts por {shortcode} — ambos lidos da URL pública do IG. Use instagram/resolve/* apenas quando você precisar do user-id numérico ou do media-id.
• Uma conta privada (is_private) expõe o perfil mas limita a mídia — exiba isso, não camufle a cobertura rasa.
• is_paid_partnership marca posts patrocinados divulgados — evidência útil para pricing e brand-safety, reporte-a.
• Um saldo baixo pode truncar silenciosamente as páginas de lista: cheque billing.truncated_due_to_balance — quando true, a página está parcial.

Saída

Retorne os registros que o fluxo de trabalho que chama precisa, cada um citado ao seu post ou perfil, mais uma nota de custo de uma linha (records_charged). Quando este skill é usado diretamente, um resumo compacto de criador é o padrão:

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

Skills relacionados

• kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — precifique e avalie criadores do Instagram em cima deste caminho de leitura.
• unifapi — o data skill compartilhado: conecte o MCP e consulte schemas exatos com get_operation.