Herramientas de YouTube
Resumen del canal, vídeos principales, fuentes de tráfico, tendencia de suscriptores y comparación con Google Ads. Solo lectura.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura7 herramientas
youtube_channels
Lectura1 créditosCanales de YouTube de la cuenta de Google conectada: id del canal, título, URL personalizada, suscriptores, visualizaciones totales y número de vídeos. Solo lectura.
Esta herramienta no recibe parámetros.
youtube_channel_overview
Lectura1 créditosCanal(es) de la cuenta conectada con suscriptores, visualizaciones totales y número de vídeos, además de visualizaciones, tiempo de visualización, duración media y variación de suscriptores del periodo frente al anterior. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–730) | — |
startOpcional | string | YYYY-MM-DD |
endOpcional | string | YYYY-MM-DD |
channelOpcional | string | channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them) |
youtube_top_videos
Lectura1 créditosMejores vídeos del periodo ordenados por tiempo de visualización (por defecto) o visualizaciones, con duración media y porcentaje de visualización. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–730) | — |
startOpcional | string | YYYY-MM-DD |
endOpcional | string | YYYY-MM-DD |
channelOpcional | string | channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them) |
byOpcional | watch_time | views | — |
limitOpcional | integer (1–200) | — |
youtube_traffic_sources
Lectura1 créditosCómo encontraron los espectadores el canal o un vídeo: búsqueda de YouTube, vídeos sugeridos, sitios externos, listas de reproducción, suscripciones, anuncios… con cuota de visualizaciones y reparto orgánico frente a pagado. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–730) | — |
startOpcional | string | YYYY-MM-DD |
endOpcional | string | YYYY-MM-DD |
channelOpcional | string | channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them) |
video_idOpcional | string | — |
top_videoOpcional | boolean | analiza el vídeo más visto del periodo |
youtube_subscriber_trend
Lectura1 créditosSuscriptores ganados/perdidos por semana (y por día si se solicita) durante el periodo; con since=fecha compara la media diaria antes y después del inicio de una campaña. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–730) | — |
startOpcional | string | YYYY-MM-DD |
endOpcional | string | YYYY-MM-DD |
channelOpcional | string | channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them) |
sinceOpcional | string | fecha de inicio de campaña YYYY-MM-DD para comparar antes/después |
dailyOpcional | boolean | — |
youtube_high_retention_videos
Lectura2 créditosVídeos con pocas visualizaciones pero alto porcentaje medio de visualización (por encima de la mediana del canal): candidatos para replicar o promocionar. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–730) | — |
startOpcional | string | YYYY-MM-DD |
endOpcional | string | YYYY-MM-DD |
channelOpcional | string | channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them) |
min_viewsOpcional | integer | — |
limitOpcional | integer (1–50) | — |
youtube_vs_google_ads
Lectura2 créditosVisualizaciones y tiempo de visualización orgánicos de YouTube frente al gasto y las visualizaciones pagadas de campañas VIDEO de Google Ads en el mismo periodo. Cada fuente informa con honestidad si no está conectada. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–730) | — |
startOpcional | string | YYYY-MM-DD |
endOpcional | string | YYYY-MM-DD |
channelOpcional | string | channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them) |
Herramientas de escritura1 herramientas
connect_youtube
Escritura0 créditosInicia la conexión de YouTube (analíticas de canal y vídeo de solo lectura): devuelve un enlace de autorización de un solo uso que el usuario abre (el mismo flujo que connect_account). Nada se conecta hasta que el usuario inicie sesión.
Esta herramienta no recibe parámetros.
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.