CDCStream/skills

Resumo de conteúdo de concorrentes

Colete as últimas postagens públicas de cada concorrente nas plataformas que eles usam, classifique-as por engajamento em relação à própria linha de base da conta e resuma o que mudou no conteúdo deles neste período.

O que isso pode e não pode dizer

• Apenas dados públicos (logged-out). Sem alcance, salvamentos, cliques ou dados de audiência — nunca estime esses valores.
• As plataformas diferem no que uma listagem retorna:
  • X user-tweets retorna os tweets recentes mais populares da conta (cerca de 100), não um feed cronológico.
  • LinkedIn company-posts retorna as postagens que uma página da empresa mostra a visitantes não logados — cerca das 10 mais recentes.
  • Facebook profile-posts geralmente retorna apenas 1–2 das últimas postagens que uma página mostra a visitantes não logados. Trate o Facebook como uma verificação pontual, não como um feed completo, e mencione isso no resumo.
• Compare o engajamento dentro de uma mesma conta e plataforma. Curtidas brutas entre plataformas não são comparáveis.

Entradas a coletar primeiro

1. Concorrentes e suas URLs de perfil por plataforma. Não adivinhe handles — pule uma plataforma que o usuário não forneceu.
2. Período (padrão: últimos 7 dias) e postagens a puxar por plataforma (padrão 10; Facebook profile-posts aceita no máximo limit=4).
3. Arquivo de resumo anterior, se houver, para relatar a mudança semana a semana.

Estimativa de créditos — mostrar antes de executar

Por concorrente, uma chamada de listagem por plataforma:

Plataforma	Endpoint	Créditos
TikTok	/v1/tiktok/channel-posts	2
Instagram	/v1/instagram/channel-posts (0,3 por post; 10 postagens)	3
YouTube	/v1/youtube/channel-videos	2
X	/v1/twitter/user-tweets	2
Threads	/v1/threads/user-posts	2
LinkedIn	/v1/linkedin/company-posts	1
Facebook	/v1/facebook/profile-posts	2

Todas as sete plataformas: cerca de 14 créditos por concorrente; ~16 com algumas chamadas de detalhe opcionais. Imprima o total para os concorrentes e plataformas solicitados, verifique GET /v1/account/balance (gratuito) e peça confirmação.

Como chamar a Captapi

• MCP: tiktok_channel_posts, instagram_channel_posts, youtube_channel_videos, twitter_user_tweets, threads_user_posts, linkedin_company_posts, facebook_profile_posts.
• REST: GET https://api.captapi.com<path>?url=<URL do perfil>&limit=<N> com cabeçalho Authorization: Bearer $CAPTAPI_API_KEY. Use limit=4 para Facebook; um valor maior resulta em erro de validação 422.

Chamadas com falha não custam créditos. Repita uma vez se retryable: true; registre um erro retryable: false como a resposta para aquela plataforma.

Etapas

1. Puxe as listagens para cada concorrente × plataforma que o usuário forneceu.
2. Filtre pelo período usando o publishedAt de cada postagem — uma listagem retorna as postagens mais recentes, independentemente da idade. Relate "nenhuma postagem neste período" separadamente de uma chamada com falha. Para X, mantenha os tweets dentro do período e observe que a fonte é um conjunto classificado por popularidade.
3. Mescle postagens cruzadas: postagens de um concorrente em diferentes plataformas com timestamps com alguns minutos de diferença e texto sobreposto são um único item.
4. Pontue cada postagem em relação à sua própria conta na mesma plataforma: engajamento = curtidas + comentários (+ compartilhamentos/republiques quando presentes); lift = engajamento / mediana do engajamento das postagens puxadas daquela conta. Postagens com lift ≥ 2 são "outperformers".
5. Marque cada postagem com formato (vídeo curto, vídeo longo, imagem, carrossel, texto, link) e um tópico de 2–4 palavras inferido a partir da legenda.
6. Compare com o resumo anterior, se fornecido: mudança na frequência de postagem, novos tópicos, formatos abandonados ou adicionados.

Formato do resumo

1. Tabela de atividade: concorrente × plataforma → postagens neste período (e variação em relação ao período anterior).
2. Outperformers: até 5 por concorrente — plataforma, data, formato, primeira linha da legenda, engajamento e lift, link e endpoint de origem.
3. Temas [necessita revisão humana]: 3–5 tópicos ou formatos que os concorrentes estão adotando, cada um apoiado por pelo menos duas postagens linkadas.
4. Lacunas e observações: plataformas não fornecidas ou com falha, as notas sobre Facebook e X acima, e contagens aproximadas.
5. Total de créditos da execução.

Onde um humano deve revisar

• Marcadores de tópicos e temas — eles são inferidos a partir das legendas.
• Qualquer interpretação "estratégica" dos dados; o resumo mostra o que foi postado e como teve desempenho em relação à conta, não o porquê.