TranscriptAPI YouTube Skills
Obtén transcripciones de YouTube, busca videos, explora canales y extrae listas de reproducción desde cualquier agente de IA — impulsado por TranscriptAPI.com sin necesidad de clave API.
Documentación
YouTube Skills para Agentes de IA 🎬
Obtén transcripciones de YouTube, busca videos, explora canales y extrae listas de reproducción — desde cualquier agente de IA.
YouTube Skills le da a tu agente de IA acceso instantáneo a transcripciones de YouTube, búsqueda de videos, datos de canales y extracción de listas de reproducción. Sin yt-dlp (YouTube bloquea todas las IPs principales de la nube), sin navegadores headless, sin binarios — solo una llamada API rápida que funciona en todas partes. Impulsado por TranscriptAPI, el mismo backend detrás de YouTubeToTranscript.com.
Funciona con 🦞 OpenClaw (ClawdBot/Moltbot), 
Hermes Agent, Claude Code, Cursor, Antigravity, y cualquier agente que soporte el formato Agent Skills.
Plan gratuito · Sin tarjeta de crédito · 100 créditos al registrarte
TranscriptAPI.com · MCP Server · Docs
Instalación
La mayoría de los usuarios quieren youtube-full — cubre transcripciones, búsqueda, canales y listas de reproducción en una sola skill.
🦞 OpenClaw (ClawdBot/Moltbot):
npx clawhub@latest install youtube-full
Hermes Agent:
hermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full
Claude Code / Cursor / Antigravity / Cline / Codex:
npx skills add ZeroPointRepo/youtube-skills --skill youtube-full
Las 12 skills a la vez:
npx skills add ZeroPointRepo/youtube-skills
Manual (git clone):
git clone https://github.com/ZeroPointRepo/youtube-skills.git
cp -r youtube-skills/skills/youtube-full ~/.claude/skills/
¿No eres desarrollador? Simplemente pega este prompt en 🦞 OpenClaw,
Instala las skills de youtube de este repositorio de GitHub: https://github.com/ZeroPointRepo/youtube-skills Quiero poder obtener transcripciones de YouTube, buscar en YouTube y explorar videos de canales desde mi agente. Configura todo por mí.El agente se encargará del resto.
Lo que puedes hacer
Solo instala y pregunta. Sin configuración, sin código — habla con tu agente en lenguaje natural.
| Tarea | Ejemplo de prompt |
|---|---|
| Obtener una transcripción de YouTube | "Resume este video: [URL]" |
| Buscar en YouTube | "Encuentra videos sobre machine learning" |
| Explorar un canal | "¿Qué ha publicado TED esta semana?" |
| Obtener contenido de una lista de reproducción | "Lista todos los videos de esta lista de reproducción" |
| Extraer subtítulos de video | "Obtén los subtítulos de este video en español" |
| Transcripciones masivas | "Obtén transcripciones de todos los videos de este canal" |
| Investigar un tema | "Encuentra y resume los 5 mejores videos sobre computación cuántica" |
| Obtener últimas subidas | "Muéstrame los videos recientes de NASA" |
| Buscar dentro de un canal | "Busca en el canal de TED 'inteligencia artificial'" |
Configuración — Clave API
Cuando instalas una skill y ejecutas tu agente por primera vez, el agente configurará tu clave API gratuita automáticamente. Esto es lo que sucede:
- El agente te pide tu dirección de correo electrónico y te registra en TranscriptAPI
- Recibirás un código OTP en tu correo — el agente te pedirá que lo ingreses
- Una vez verificado, el agente guarda la clave API en tu shell y configuración del agente automáticamente
Eso es todo. 100 créditos gratuitos, sin tarjeta de crédito.
Configuración manual (si prefieres hacerlo tú mismo)
-
Regístrate en transcriptapi.com — gratis, sin tarjeta de crédito
-
Copia tu clave API del panel de control (empieza con
sk_) -
Pide a tu agente que la guarde por ti:
"Mi clave de TranscriptAPI es
sk_...— guárdala para que persista entre sesiones."
O configúrala tú mismo como variable de entorno:
export TRANSCRIPT_API_KEY="sk_your_key_here"
¿Dónde se guarda la clave?
Tu agente guarda la clave API aquí (depende del runtime):
| Ubicación | Archivo |
|---|---|
| OpenClaw/Moltbot | ~/.openclaw/openclaw.json o ~/.clawdbot/moltbot.json |
| Hermes Agent | Almacén de secretos de Hermes (TRANSCRIPT_API_KEY declarado vía required_environment_variables en el frontmatter de la skill) |
| Shell de macOS | ~/.zshenv, ~/.zprofile |
| Shell de Linux | ~/.profile, ~/.bashrc, ~/.zshenv |
| Shell de Fish | ~/.config/fish/config.fish |
| Respaldo | ~/.transcriptapi (modo 600) |
Tu agente la detecta automáticamente después de guardarla.
Skills
youtube-full es la skill recomendada para la mayoría de los usuarios. Incluye todo: transcripciones, búsqueda, canales, listas de reproducción.
Si prefieres skills más pequeñas y enfocadas (contexto más pequeño = mejor rendimiento del agente para tareas específicas), elige lo que necesites:
| Skill | Qué hace | Instalación |
|---|---|---|
| youtube-full | Todo — transcripciones, búsqueda, canales, listas de reproducción | --skill youtube-full |
| transcript | Obtén transcripciones de video con marcas de tiempo | --skill transcript |
| youtube-search | Busca videos y canales en YouTube | --skill youtube-search |
| youtube-channels | Explora subidas, obtén videos recientes, resuelve @handles | --skill youtube-channels |
| youtube-playlist | Extrae todos los videos de una lista de reproducción | --skill youtube-playlist |
# Install a specific skill
npx skills add ZeroPointRepo/youtube-skills --skill transcript
# Install multiple specific skills
npx skills add ZeroPointRepo/youtube-skills --skill transcript --skill youtube-search
Las 12 skills
Enviamos 12 skills en total. Muchas son variantes más específicas o alias de las 5 principales — para que tu agente pueda encontrar la skill correcta sin importar cómo formules tu solicitud.
| Skill | Descripción |
|---|---|
| youtube-full | Kit completo de YouTube — transcripciones + búsqueda + canales + listas de reproducción |
| transcript | Extrae la transcripción de cualquier video de YouTube con marcas de tiempo |
| captions | Obtén subtítulos cerrados / CC de videos de YouTube |
| subtitles | Extrae subtítulos de videos de YouTube |
| youtube-search | Busca videos y canales en YouTube |
| youtube-channels | Explora subidas de canales, obtén videos recientes, resuelve @handles |
| youtube-playlist | Obtén todos los videos de una lista de reproducción de YouTube |
| youtube-data | Obtén datos de videos y canales de YouTube (alternativa ligera a la API de Google) |
| youtube-api | Acceso a la API de YouTube para agentes de IA — sin problemas de cuotas de Google |
| transcriptapi | Acceso completo a TranscriptAPI con todos los endpoints |
| video-transcript | Convierte videos de YouTube en transcripciones de texto |
| yt | Utilidad rápida de YouTube para búsquedas rápidas |
Precios
| Plan | Precio | Créditos | Límite de velocidad |
|---|---|---|---|
| Gratis | $0 | 100 créditos al registrarte | 300 req/min |
| Starter | $5/mes | 1,000 créditos/mes | 300 req/min |
| Starter Anual | $54/año ($4.50/mes) | 1,000 créditos/mes | 300 req/min |
La mayoría de las operaciones cuestan 1 crédito. La resolución de canales y los recientes son gratuitos. No se requiere tarjeta de crédito para el plan gratuito.
Agentes compatibles
Funciona con cualquier agente de IA que soporte el formato Agent Skills:
| Agente | Comando de instalación |
|---|---|
| 🦞 OpenClaw (ClawdBot/Moltbot) | npx clawhub@latest install youtube-full |
| Hermes Agent | hermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full |
| Claude Code | npx skills add ZeroPointRepo/youtube-skills |
| Cursor | npx skills add ZeroPointRepo/youtube-skills |
| Antigravity | npx skills add ZeroPointRepo/youtube-skills |
| Cline | npx skills add ZeroPointRepo/youtube-skills |
| Codex | npx skills add ZeroPointRepo/youtube-skills |
| Otros | Goose, AMP, Kiro, Roo, OpenCode, Gemini, GitHub Copilot... |
FAQ
¿Cómo obtengo una transcripción de YouTube?
Instala youtube-full (o transcript) y pide a tu agente:
"Obtén la transcripción de este video: https://youtube.com/watch?v=VIDEO_ID"
El agente obtiene la transcripción completa con marcas de tiempo. Luego puedes pedirle que la resuma, traduzca, cite o analice el contenido.
¿Cómo busco en YouTube desde mi agente?
Instala youtube-full (o youtube-search) y pregunta:
"Encuentra videos sobre machine learning"
Devuelve hasta 50 resultados con títulos, miniaturas, conteos de vistas y fechas de publicación.
¿Cómo obtengo todos los videos de un canal de YouTube?
Instala youtube-full (o youtube-channels) y pregunta:
"Lista todos los videos del canal de TED"
El agente resuelve el @handle, obtiene las subidas (paginadas, 100/página), y luego puede obtener transcripciones de cualquiera o todos ellos.
¿Puedo descargar transcripciones de YouTube en masa?
Sí. Instala youtube-full y pregunta:
"Obtén transcripciones de todos los videos de esta lista de reproducción: [URL]"
El agente obtiene la lista de reproducción, itera a través de los videos y extrae cada transcripción.
¿Necesito una clave de Google YouTube Data API?
No. TranscriptAPI reemplaza la Google YouTube Data API para extracción de transcripciones, búsqueda y operaciones de canales/listas de reproducción. Sin proyecto de Google Cloud, sin límites de cuota, sin configuración de OAuth.
¿Necesito una clave API?
Sí, pero el registro es gratuito e instantáneo — 100 créditos, sin tarjeta de crédito. Tu agente maneja la configuración automáticamente en la primera ejecución.
¿Qué skill debería instalar?
- ¿Quieres todo? →
youtube-full(recomendado) - ¿Solo transcripciones? →
transcript - ¿Solo búsqueda? →
youtube-search - ¿Solo datos de canales? →
youtube-channels - ¿Solo listas de reproducción? →
youtube-playlist
¿Qué es TranscriptAPI?
TranscriptAPI.com es una API REST y servidor MCP para datos de YouTube. Proporciona extracción de transcripciones, búsqueda de videos, exploración de canales y operaciones de listas de reproducción — construido para desarrolladores y agentes de IA. También disponible como MCP Server para integración directa con LLM (Claude, ChatGPT).
Solución de problemas
Soluciones rápidas para los problemas que los usuarios realmente encuentran. Los códigos de error provienen de la propia API, por lo que tu agente generalmente los reportará textualmente.
| Síntoma | Causa probable | Solución |
|---|---|---|
401 Unauthorized | Clave API faltante, mal escrita o no cargada en el entorno | Confirma que TRANSCRIPT_API_KEY esté configurada en el shell donde se ejecuta tu agente y que la clave empiece con sk_ |
402 Payment Required | La cuenta no tiene créditos | Verifica tu saldo en transcriptapi.com/billing |
403 con código de Cloudflare 1010 | Solicitud enviada sin encabezado User-Agent | Envía el nombre de tu agente como User-Agent, por ejemplo HermesAgent/0.11.0 |
404 Not Found | El video no tiene subtítulos, no es público, o el ID es incorrecto | Verifica que la URL se abra en un navegador y que el reproductor muestre subtítulos allí |
408 Request Timeout | Presión temporal ascendente en el video | Transitorio por naturaleza: reintenta una vez después de un par de segundos |
422 Validation Error | Un parámetro está mal formado, como una referencia de canal o lista de reproducción incorrecta | Los canales aceptan @handle, una URL de canal, o un ID de UC; las listas de reproducción aceptan prefijos PL, UU, LL, FL y OL |
429 Too Many Requests | Límite de velocidad alcanzado | Espera y respeta el encabezado Retry-After |
Tres casos más que vale la pena conocer:
- La clave está guardada pero el agente no puede verla. Los archivos de configuración del shell se cargan según el tipo de shell: revisa la tabla bajo "¿Dónde se guarda la clave?" en la sección de Configuración y asegúrate de que el archivo coincida con el shell en el que realmente se ejecuta tu agente. Reiniciar el agente después de guardar la clave resuelve la mayoría de los casos.
- Transmisiones en vivo y estrenos. Las transcripciones están disponibles después de que la transmisión termina y los subtítulos se procesan, no mientras está en vivo.
- La transcripción llega en un idioma inesperado. Muchos videos solo tienen subtítulos en su idioma original. Solicita la transcripción con un parámetro de idioma preferido, o pide a tu agente que traduzca el resultado.
Impulsado por TranscriptAPI
TranscriptAPI.com — 15M+ transcripciones/mes, 99.9% de tiempo de actividad.
También disponible: MCP Server para integración directa con LLM con Claude y ChatGPT.
Documentación completa de la API: transcriptapi.com/docs
Listado en awesome-hermes-skills, nuestro directorio de skills de Hermes Agent, plugins, perfiles de agente y proveedores de memoria.
Divulgación
TranscriptAPI es un producto independiente y no está afiliado ni respaldado por YouTube o Google.
Contribuciones
Se aceptan PRs. Consulta CONTRIBUTING.md.
Licencia
MIT © TranscriptAPI