Threads Data Skill

O caminho de leitura determinístico para dados públicos do Threads (Meta) 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 threads/... concretas, formatos de resposta e armadilhas para que qualquer fluxo de trabalho text-first de listening ou conteúdo leia de uma receita conhecida em vez de redescobrir a superfície a cada vez.

Somente leitura — olhos, não mãos. Ele pesquisa dados públicos do Threads e retorna registros citados; ele nunca posta ou responde, e a UnifAPI nunca guarda credenciais do Threads.

Use o skill unifapi para evidências ao vivo

Conecte-se uma vez através do skill compartilhado unifapi (OAuth MCP) e depois chame as operações abaixo. Os perfis são indexados por {username}. Preserve 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 relatar 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 corresponde ao trabalho; cada uma nomeia exatamente o que chamar.

1. Defina o termo. Para listening de marca ou categoria, chame threads/search/recent?q=... (mais novos) e threads/search/top?q=... (mais vistos) juntos — recent captura a conversa ao vivo, top captura as opiniões que de fato se espalham. Pagine via next_cursor.
2. Encontre handles. Chame threads/search/profiles?q=... para revelar contas sobre o termo, depois threads/users/{username} para o tamanho de seguidores e a biography.
3. Leia a atividade de um perfil. Chame threads/users/{username}/posts, .../replies e .../reposts para o que um handle diz, responde e amplifica.
4. Agrupe opiniões. Agrupe o text nos resultados recent e top em perguntas e opiniões; like_count classifica quais opiniões ressoam.
5. Cite tudo. Cada citação se vincula de volta ao seu post ou perfil; relate billing.records_charged (ou estime quando o metadado de billing estiver ausente).

Notas de formato

• ThreadsUser — indexado por {username}. full_name, biography, follower_count, is_verified, is_private.
• ThreadsPost — code (o segmento da URL), text, taken_at, like_count, image_url, video_url, user.

Armadilhas

• search/recent é o mais novo e search/top é o mais visto — use ambos para uma leitura equilibrada; qualquer um sozinho enviesa recência ou popularidade.
• Posts expõem apenas like_count — não há contagens de reply/repost no objeto do post. Avalie o alcance pela classificação de search/top, não por um número de repost.
• Um handle privado (is_private) limita o que você pode ler — revele isso.
• Um saldo baixo pode truncar silenciosamente as páginas de lista: verifique billing.truncated_due_to_balance — quando true, a página é parcial.

Saída

Retorne os registros que o fluxo de trabalho chamador 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 brief de listening compacto é o padrão:

**"{term}" on Threads** — {N} recent / {N} top posts. Takes: {themes}. Loudest: "{quote}" ({likes} likes, by @handle). Evidence: {post URLs}. Records: ~{N}.

Skills relacionados

• social-listening-brief (Social Listening), content-opportunity-brief (Content Strategy) — trabalho de listening e ideias de conteúdo sobre este caminho de leitura.
• unifapi — o data skill compartilhado: conecte o MCP e consulte os schemas exatos com get_operation.