YouTube Data Skill

La vía de lectura determinista para datos públicos de YouTube a través de UnifAPI. Esta es una Data Skill: no ejecuta un trabajo de marketing por sí sola — nombra las operaciones youtube/... concretas, las formas de respuesta y los límites reales de cobertura para que cualquier workflow channel-first o content-first (vetting de creadores, recepción de competidores, demanda de contenido) lea de una receta conocida en lugar de redescubrir la superficie cada vez.

Solo lectura — ojos, no manos. Investiga datos públicos de YouTube y devuelve registros citados; nunca sube vídeos, comenta ni se suscribe, y UnifAPI nunca guarda credenciales de YouTube.

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 canales se identifican por {channel_id} y los vídeos por {video_id} — resuelve primero un handle o URL a un channel id (ver Trampas). 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. Encuadra la consulta. Llama a youtube/search?q=... para saber quién es dueño de un tema, o youtube/trending para lo que está surgiendo ahora.
2. Resuelve un canal. Llama a youtube/resolve/channel-id?url=... para obtener el channel_id, luego youtube/channels/{channel_id} para subscriber_count, video_count y view_count.
3. Lee el output de un canal. Llama a youtube/channels/{channel_id}/videos (y .../shorts); el view_count de cada vídeo es la señal de demanda. Pagina vía next_cursor. youtube/channels/{channel_id}/playlists mapea cómo está organizado el catálogo; youtube/channels/{channel_id}/community lee anuncios y engagement fuera de los vídeos; youtube/channels/{channel_id}/search?q=... encuentra la cobertura de un creador sobre un tema sin escanear todo el catálogo.
4. Lee un vídeo y su vecindario. Llama a youtube/videos/{video_id} para los metadatos (ahora incluyendo like_count, category, published_at, has_captions), luego youtube/videos/{video_id}/related para mapear la demanda adyacente y el contenido competidor.
5. Lee la audiencia y la transcripción. Llama a youtube/videos/{video_id}/comments (sort_by top/newest) para lo que dice la audiencia — texto de comentarios en bruto, contadores de likes y respuestas; cualquier agrupación de sentimiento o de FAQ corre por tu cuenta, la API devuelve solo texto. Llama a youtube/videos/{video_id}/captions para las pistas de subtítulos (url de timed-text por idioma) para leer o analizar la transcripción.
6. Recorre una playlist o un hashtag. Llama a youtube/playlists/{playlist_id} luego .../videos para ingerir una serie curada en orden; youtube/hashtags/{tag}/videos rastrea una campaña o tendencia a través de creadores.
7. Dimensiona la demanda de un tema. Agrega view_count en los resultados de búsqueda y relacionados de un tema; title, description y keywords muestran cómo está encuadrado el tema.
8. Cita todo. Cada cifra se ata al vídeo o canal del que provino; reporta billing.records_charged (o estima cuando falte el metadato de billing).

Notas de forma

• YouTubeChannel — identificado por {channel_id}. subscriber_count, video_count, view_count, handle, keywords, links, country, created_at. is_verified no lo puebla el upstream y siempre es false — no reportes una verificación que no puedes leer.
• YouTubeVideo — identificado por {video_id}. view_count, like_count (best-effort; 0 cuando el creador lo oculta), category, channel_id, author, duration_seconds, keywords, published_at, has_captions, is_live, is_private.
• YouTubeVideoPreview — filas de search/related/list: añade published_time. category es parte de la forma pero está vacío en las filas de lista (solo el detalle de YouTubeVideo lo lleva).
• YouTubeComment — text, author, author_channel_id, like_count, reply_count, published_time, is_verified, is_creator. Solo texto — sin campo de sentimiento.
• YouTubeCaptions — video_id, tracks[] (language_code, url de timed-text url, is_translatable), translation_languages[]. Objeto único, facturado como un registro. Las urls de las pistas tienen tiempo limitado.
• YouTubePlaylist / YouTubePlaylistPreview — title de la playlist, channel_id, author, video_count (el detalle añade view_count, last_updated; el preview añade first_video_id).
• YouTubeChannelPreview — filas de search-channels: title, handle, description, subscriber_count, video_count.
• YouTubeCommunityPost — text, author, vote_count, reply_count, attachment_type, image_url.

Trampas

• Resolve solo llega a channel ids. youtube/resolve/channel-id?url=... resuelve un handle o URL a un {channel_id} — llámalo antes de cualquier llamada a youtube/channels/{channel_id}/.... No hay resolver de video-id ni de playlist-id; pasa un {video_id} / {playlist_id} conocido (extráelo tú mismo de la URL).
• Los comentarios son texto en bruto. youtube/videos/{video_id}/comments devuelve el texto del comentario más los contadores de likes/respuestas — sin sentimiento, sin agrupación de FAQ. Calcula eso tú mismo a partir del texto; no afirmes un campo de sentimiento que la API no devuelve.
• like_count es best-effort. YouTubeVideo.like_count es 0 cuando el creador oculta los likes — trata 0 como «oculto o ninguno», no como autoritativo.
• is_verified siempre es false para los canales (el upstream no lo expone) — no reportes verificación de canal.
• Los subtítulos pueden estar vacíos. Un vídeo con los subtítulos desactivados devuelve tracks: []; comprueba antes de prometer una transcripción. Las urls de las pistas tienen tiempo limitado.
• Los hashtags toman el tag con o sin un # inicial (youtube/hashtags/lofi/videos).
• 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 vídeo o canal, más una nota de coste de una línea (records_charged). Cuando esta skill se usa directamente, un brief de demanda compacto es el predeterminado:

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

Related skills

• kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — tarifica y haz vetting de canales de YouTube sobre esta vía de lectura.
• competitor-profiling (Competitive Intelligence), content-opportunity-brief (Content Strategy) — trabajo de recepción y demanda de contenido que lee YouTube primero.
• unifapi — la skill de datos compartida: conecta MCP y busca esquemas exactos con get_operation.