YouTube Data Skill

O caminho de leitura determinístico para dados públicos do YouTube via UnifAPI. Este é um Data Skill: ele não executa um trabalho de marketing por conta própria — ele nomeia as operações youtube/... concretas, os formatos de resposta e os limites reais de cobertura para que qualquer fluxo de trabalho voltado a canais ou conteúdo (vetting de criadores, recepção de concorrentes, demanda de conteúdo) leia a partir 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 YouTube e retorna registros citados; ele nunca faz upload, comenta ou se inscreve, e a UnifAPI nunca guarda credenciais do YouTube.

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. Canais são indexados por {channel_id} e vídeos por {video_id} — resolva primeiro um handle ou uma URL para um channel id (veja Pegadinhas). Preserve qualquer metadado de billing para que a saída possa informar o custo por registro.

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 for verdadeiro, passe pagination.next_cursor como o cursor da próxima requisição. Sempre preserve billing ao informar o custo.

Operações principais

Precisa de um campo que não está 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. Enquadre a consulta. Chame youtube/search?q=... para quem domina um tópico, ou youtube/trending para o que está surgindo agora.
2. Resolva um canal. Chame youtube/resolve/channel-id?url=... para obter o channel_id e depois youtube/channels/{channel_id} para subscriber_count, video_count e view_count.
3. Leia a produção de um canal. Chame youtube/channels/{channel_id}/videos (e .../shorts); o view_count de cada vídeo é o sinal de demanda. Pagine via next_cursor. youtube/channels/{channel_id}/playlists mapeia como o catálogo está organizado; youtube/channels/{channel_id}/community lê anúncios e engajamento fora dos vídeos; youtube/channels/{channel_id}/search?q=... encontra a cobertura de um criador sobre um tópico sem varrer o catálogo inteiro.
4. Leia um vídeo e sua vizinhança. Chame youtube/videos/{video_id} para os metadados (agora incluindo like_count, category, published_at, has_captions) e depois youtube/videos/{video_id}/related para mapear a demanda adjacente e o conteúdo concorrente.
5. Leia a audiência e a transcrição. Chame youtube/videos/{video_id}/comments (sort_by top/newest) para o que a audiência diz — texto bruto dos comentários, contagens de like e reply; qualquer agrupamento de sentimento ou FAQ é você quem calcula, a API retorna apenas texto. Chame youtube/videos/{video_id}/captions para as faixas de legenda (url de timed-text por idioma) para ler ou analisar a transcrição.
6. Percorra uma playlist ou hashtag. Chame youtube/playlists/{playlist_id} e depois .../videos para ingerir uma série curada em ordem; youtube/hashtags/{tag}/videos acompanha uma campanha ou tendência entre criadores.
7. Dimensione a demanda de um tópico. Agregue view_count entre os resultados de busca e relacionados de um tópico; title, description e keywords mostram como o tópico é enquadrado.
8. Cite tudo. Cada número remete ao vídeo ou canal de onde veio; informe billing.records_charged (ou estime quando o metadado de billing estiver ausente).

Notas de formato

• YouTubeChannel — indexado por {channel_id}. subscriber_count, video_count, view_count, handle, keywords, links, country, created_at. is_verified não é populado pelo upstream e é sempre false — não informe uma verificação que você não consegue ler.
• YouTubeVideo — indexado por {video_id}. view_count, like_count (best-effort; 0 quando o criador o oculta), category, channel_id, author, duration_seconds, keywords, published_at, has_captions, is_live, is_private.
• YouTubeVideoPreview — linhas de search/related/list: adiciona published_time. category faz parte do formato mas está vazio nas linhas de lista (somente o detalhe YouTubeVideo o carrega).
• YouTubeComment — text, author, author_channel_id, like_count, reply_count, published_time, is_verified, is_creator. Apenas texto — sem campo de sentimento.
• YouTubeCaptions — video_id, tracks[] (language_code, url de timed-text url, is_translatable), translation_languages[]. Objeto único, cobrado como um registro. As urls das faixas têm tempo limitado.
• YouTubePlaylist / YouTubePlaylistPreview — playlist title, channel_id, author, video_count (o detalhe adiciona view_count, last_updated; o preview adiciona first_video_id).
• YouTubeChannelPreview — linhas de search-channels: title, handle, description, subscriber_count, video_count.
• YouTubeCommunityPost — text, author, vote_count, reply_count, attachment_type, image_url.

Pegadinhas

• O resolve só chega a channel ids. youtube/resolve/channel-id?url=... resolve um handle ou URL para um {channel_id} — chame-o antes de qualquer chamada youtube/channels/{channel_id}/.... Não há resolver de video- ou playlist-id; passe um {video_id} / {playlist_id} conhecido (extraia-o você mesmo da URL).
• Comentários são texto bruto. youtube/videos/{video_id}/comments retorna o texto do comentário mais contagens de like/reply — sem sentimento, sem agrupamento de FAQ. Calcule isso você mesmo a partir do texto; não afirme um campo de sentimento que a API não retorna.
• like_count é best-effort. YouTubeVideo.like_count é 0 quando o criador oculta os likes — trate 0 como "oculto ou nenhum", não como autoritativo.
• is_verified é sempre false para canais (o upstream não o expõe) — não informe a verificação de canal.
• As legendas podem estar vazias. Um vídeo com legendas desativadas retorna tracks: []; verifique antes de prometer uma transcrição. As urls das faixas têm tempo limitado.
• Hashtags aceitam a tag com ou sem um # inicial (youtube/hashtags/lofi/videos).
• Um saldo baixo pode truncar silenciosamente as páginas de lista: verifique billing.truncated_due_to_balance — quando verdadeiro, a página está parcial.

Saída

Retorne os registros de que o fluxo de trabalho chamador precisa, cada um citado ao seu vídeo ou canal, mais uma nota de custo de uma linha (records_charged). Quando este skill é usado diretamente, um resumo compacto de demanda é o padrão:

**{Channel}** — {subscribers} subscribers, {videos} videos, {totalViews} views. Top videos for {topic}: {title} ({views} views). Related/competitors: {channels}. Evidence: {URLs}. Records: ~{N}.

Skills relacionados

• kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — precifique e avalie canais do YouTube sobre este caminho de leitura.
• competitor-profiling (Competitive Intelligence), content-opportunity-brief (Content Strategy) — trabalho de recepção e demanda de conteúdo que lê o YouTube primeiro.
• unifapi — o data skill compartilhado: conecte o MCP e consulte os schemas exatos com get_operation.