YouTube MCP by TranscriptAPI

YouTube Transcript + YouTube Search MCP para Agentes de IA

El MCP de transcripciones de YouTube más rápido + búsqueda en YouTube para agentes de IA. Pruébalo gratis.
12 herramientas: transcripciones, metadatos de videos y canales, búsqueda de videos, exploración de canales, búsqueda dentro de canales, extracción de listas de reproducción y sondeo de nuevas subidas, para Claude, ChatGPT, Cursor, VS Code, Claude Code y más de 20 clientes.

Impulsando más de 15 millones de transcripciones cada mes · Más de 500K transcripciones procesadas diariamente · Tiempo de respuesta medio de 49 ms Confiable en producción por youtubetotranscript.com (~11M/mes) y recapio.com (~2.8M/mes).

Por qué TranscriptAPI MCP

La mayoría de los servidores MCP de YouTube hacen una sola cosa: obtener una transcripción individual. TranscriptAPI MCP es un kit de herramientas completo: transcripciones, búsqueda de videos, búsqueda de canales, exploración de canales, extracción de listas de reproducción y seguimiento de subidas basado en RSS gratuito, todo desde un único endpoint remoto, diseñado para agentes de IA.

Prueba rápida:

Find @NASA's three most-viewed videos about the Moon landing,
get the transcript of each, and write a 5-bullet comparison.

Ese único prompt utiliza 3 de nuestras 12 herramientas (search_youtube, search_channel_videos, get_youtube_transcript) sin que escribas una línea de código.

🧩 Instalar como Plugin de Agente _{· lo más fácil}

La raíz de este repositorio es un paquete conforme a Agent Plugins 1.0.0: el formato portátil publicado el 2026-08-06 y compatible con ChatGPT, Codex, Cursor, GitHub Copilot, Kiro y VS Code. Una sola instalación te da el servidor MCP y una habilidad youtube incluida que enseña a tu agente cuándo usar cada herramienta y cómo no desperdiciar créditos.

plugin.json                    # Agent Plugins 1.0.0 manifest
mcp.json                       # hosted MCP server, streamable-http, OAuth (no keys)
skills/youtube/SKILL.md        # when + how to use the 12 tools
.cursor-plugin/plugin.json     # Cursor plugin manifest, same MCP + skill (+ marketplace.json)

VS Code: Paleta de comandos → Chat: Instalar Plugin desde Fuente, luego pega:

https://github.com/ZeroPointRepo/youtube-mcp

O registra un clon local en settings.json:

"chat.pluginLocations": { "/absolute/path/to/youtube-mcp": true }

Cursor: Personalizar en la barra lateral → encuentra el plugin → Instalar. Para un clon local:

git clone https://github.com/ZeroPointRepo/youtube-mcp ~/.cursor/plugins/local/transcriptapi

Luego Desarrollador: Recargar Ventana.

Agregar a Cursor: solo servidor MCP, sin clon. Pega este enlace profundo en tu navegador:

cursor://anysphere.cursor-deeplink/mcp/install?name=transcriptapi&config=eyJ1cmwiOiJodHRwczovL3RyYW5zY3JpcHRhcGkuY29tL21jcCJ9

ChatGPT, Codex, GitHub Copilot, Kiro, cualquier otro cliente: apunta el mecanismo de plugins de tu cliente a este repositorio, o a un clon local. Agent Plugins 1.0.0 estandariza el formato del paquete, no la instalación, por lo que cada cliente tiene su propio flujo de instalación.

Ejemplo de 30 segundos

Summarize this video for me: https://youtu.be/UF8uR6Z6KLc

El agente llama a get_youtube_transcript, obtiene la transcripción completa con marcas de tiempo y la resume. No hay clave API que configurar: la primera llamada abre un inicio de sesión OAuth (cuenta gratuita, 100 créditos, sin tarjeta). Luego prueba:

What has @TED posted in the last month?     → get_channel_latest_videos (free)
Find talks on protein folding, summarize the best three.
                                             → search_youtube, then transcripts

No hay credenciales en este paquete: Agent Plugins 1.0.0 prohíbe secretos incrustados, y la autorización es gestionada por el cliente. Verifica el paquete tú mismo:

curl -sO https://agent-plugins.org/schemas/1.0.0/plugin.schema.json
curl -sO https://agent-plugins.org/schemas/1.0.0/mcp.schema.json
npx ajv-cli@5 validate --spec=draft2020 -s plugin.schema.json -d plugin.json
npx ajv-cli@5 validate --spec=draft2020 -s mcp.schema.json    -d mcp.json

🛠️ Instalación rápida

Requisitos:

• Una cuenta de TranscriptAPI (regístrate gratis, primeros 100 créditos gratis)
• Una clave API de tu panel de control O usa OAuth (Claude, ChatGPT)

Recomendado: Agrega una Regla para Invocar TranscriptAPI Automáticamente

Agrega esta regla a tu cliente de IA para que no necesites pedir transcripciones explícitamente:

Cuando comparta una URL de YouTube, usa automáticamente la herramienta MCP de TranscriptAPI
para obtener la transcripción antes de responder. Esto aplica a cualquier análisis de video,
resumen o pregunta sobre contenido de YouTube.

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

claude mcp add --transport http transcript-api https://transcriptapi.com/mcp

"mcp.servers": {
  "transcript-api": {
    "type": "http",
    "url": "https://transcriptapi.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "serverUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "context_servers": {
    "transcript-api": {
      "source": "remote",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "type": "streamable-http",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

amp mcp add transcript-api https://transcriptapi.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

"augment.advanced": {
  "mcpServers": [
    {
      "name": "transcript-api",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  ]
}

{
  "mcpServers": {
    "transcript-api": {
      "type": "streamable-http",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "httpUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "httpUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "serverUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "transcript-api": {
    "url": "https://transcriptapi.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "url": "https://transcriptapi.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

🔐 Autenticación

Clave API

Simple y universal. Funciona con todos los clientes MCP.

1. Obtén tu clave API desde tu panel de control
2. Las claves comienzan con el prefijo sk_
3. Agrega a la configuración como token Bearer:

"headers": {
  "Authorization": "Bearer sk_your_api_key_here"
}

Seguridad: Almacena las claves en variables de entorno cuando sea posible y nunca las confirmes en el control de versiones.

OAuth 2.1

Autenticación automática y segura sin gestión manual de claves.

Registro Dinámico de Clientes (DCR):

• Compatible con: Claude Desktop, Claude Web, ChatGPT
• Solo agrega la URL del MCP: el cliente se registra automáticamente
• No se necesitan credenciales
• Autorizarás una vez a través de la redirección del navegador

Registro Estático de Clientes:

• Compatible con: ChatGPT (opcional)
• Obtén el ID de cliente + Secreto desde el Panel de Integración MCP
• Más control sobre la identidad del cliente

Referencia completa: Documentación de autenticación →

🧰 Herramientas disponibles

Las 12 herramientas se exponen automáticamente una vez que te conectas. Las llamadas exitosas cuestan 1 crédito a menos que una herramienta indique lo contrario a continuación. Las llamadas fallidas o con límite de velocidad no consumen créditos.

¿Qué herramienta de video? Usa get_youtube_video_info (gratis) para descubrir los idiomas de transcripción antes de obtener una transcripción. Usa get_video_metadata (1 crédito) para conteos de vistas/me gusta, fecha de publicación, descripción, duración, etiquetas o videos relacionados.

1. get_youtube_transcript

Obtén la transcripción de cualquier video de YouTube, como markdown (con metadatos) o JSON estructurado. Coloca la salida directamente en resumidores, índices de búsqueda o pipelines de IA.

Costo: 1 crédito por solicitud exitosa.

Ejemplo de salida (markdown):

# Metadata

## Title: Rick Astley - Never Gonna Give You Up
## Author: RickAstleyVEVO

# Transcript

[0.0s] Never gonna give you up
[4.12s] Never gonna let you down

Ejemplo de salida (JSON):

{
  "transcript": [
    { "text": "Never gonna give you up", "start": 0.0, "duration": 4.12 },
    { "text": "Never gonna let you down", "start": 4.12, "duration": 3.85 }
  ],
  "metadata": { "title": "Rick Astley...", "author_name": "RickAstleyVEVO" }
}

2. get_youtube_video_info _{· GRATIS}

Metadatos básicos (título, autor, miniatura) más la lista de idiomas de transcripción disponibles: llama a esto antes de get_youtube_transcript para elegir un idioma.

Costo: Gratis.

Para contar vistas/me gusta, fecha de publicación, descripción, duración, etiquetas o videos relacionados, usa get_video_metadata en su lugar.

3. get_video_metadata

Metadatos ricos del video sin necesidad de subtítulos: título, texto de conteo de vistas/me gusta, fecha de publicación, descripción estructurada + enlaces, resumen del canal que subió, y miniaturas. Los extras opcionales de include obtienen datos más pesados provenientes del reproductor (duración, categoría, etiquetas, inventario de pistas de subtítulos) y videos relacionados.

Costo: 1 crédito por solicitud exitosa.

Ejemplo de prompt:

Get the view count, publish date, and tags for https://youtu.be/UF8uR6Z6KLc.

4. search_youtube

Busca en YouTube videos, canales, listas de reproducción o películas. Filtra por tipo, orden, fecha de subida o duración, y pagina con un token de continuación, perfecto para descubrimiento, investigación y construcción de pipelines de contenido.

Costo: 1 crédito por página (~20 resultados por página).

Ejemplo de prompt:

Search YouTube for "transformer architecture explained" and pick the
top 3 results by relevance.

5. get_channel_info

El perfil de un canal: título, @handle, indicador de verificado, texto de conteo de suscriptores/videos, descripción, palabras clave, etiquetas, miniaturas, banners y las pestañas que expone. No está paginado.

Costo: 1 crédito por solicitud exitosa.

Revisa las pestañas devueltas antes de llamar a get_channel_sections o list_channel_videos con un tab.

6. get_channel_latest_videos _{· GRATIS}

Obtén las ~15 subidas más recientes de cualquier canal vía RSS. Perfecto para monitoreo, resúmenes diarios o activar pipelines posteriores.

Costo: Gratis.

Ejemplo de prompt:

Every morning, list new uploads from @NASA and @natgeo.

7. search_channel_videos

Busca dentro de un canal específico videos que coincidan con una consulta. Ideal para investigar el contenido de un creador o encontrar temas específicos en canales grandes.

Costo: 1 crédito por página (~30 resultados por página).

Ejemplo de prompt:

On @NASA's channel, find every video about the Moon landing.

8. list_channel_videos

Lista el feed de un canal con paginación. Usa tab para elegir el feed de subidas (predeterminado, ~100/página), Shorts o transmisiones en vivo (~48/página), y el opcional sort para ordenar la pestaña Videos por más reciente, popular o más antiguo. Ideal para construir bases de datos, extracción masiva de transcripciones o auditar la biblioteca completa de contenido de un canal.

Ordenamiento. Agrega sort=latest, popular o oldest a channel/videos para obtener los videos de un canal en el orden que quieras, por ejemplo sus subidas más populares primero. Una página ordenada devuelve alrededor de 30 videos (una página sin ordenar devuelve alrededor de 100), y cada página cuesta el mismo 1 crédito.

Los resultados ordenados provienen de la pestaña Videos de YouTube (solo formato largo); los Shorts tienen su propio feed tab=shorts.

Al paginar, envía el mismo orden en cada solicitud.

Cada elemento lleva members_only: true solo cuando YouTube etiqueta el video como "Solo miembros", y esos elementos no tienen viewCountText, porque YouTube no publica conteos de vistas para contenido de membresía. Siempre es false en el feed de subidas, en tab: "shorts" y en listas de reproducción.

Los elementos de tab: "streams" llevan lengthText y publishedTimeText (por ejemplo Streamed 2 years ago, o LIVE y un conteo de espectadores mientras la transmisión está en vivo). tab: "shorts" devuelve null para ambos, porque la cuadrícula de Shorts de YouTube no publica ni duración ni fecha de publicación. En los feeds de pestañas de canal (tab: "videos" con sort, tab: "shorts", tab: "streams") channelId, channelTitle, channelHandle y index son null.

Costo: 1 crédito por página.

9. list_channel_playlists

Lista paginada de las listas de reproducción de un canal (id, título, URL, texto de conteo de videos, miniaturas). Pasa un id de lista devuelto a list_playlist_videos para obtener sus videos.

Costo: 1 crédito por página.

10. list_channel_posts

Lista paginada del contenido de la comunidad de un canal (pestaña Posts): texto, hora de publicación, texto de conteo de me gusta y adjuntos (imagen, múltiples imágenes, video, lista de reproducción o encuesta). Los canales sin pestaña de comunidad devuelven una lista de resultados vacía, no un error.

Costo: 1 crédito por página.

11. get_channel_sections

Las secciones curadas y agrupadas de una página de canal: estantes titulados de videos, listas de reproducción, shorts o canales destacados, en el orden propio del canal. No está paginado.

Costo: 1 crédito por solicitud exitosa.

podcasts y releases existen solo en canales que los tienen (resultados vacíos en caso contrario).

12. list_playlist_videos

Obtén todos los videos de una lista de reproducción de YouTube (IDs PL/UU/LL/FL/OL compatibles). Procesa cursos completos, series de conferencias o colecciones curadas en una sola llamada.

Costo: 1 crédito por página (~100 resultados por página).

💡 Casos de Uso y Prompts

💳 Precios y límites de tarifa

• 1 Crédito = 1 solicitud exitosa (HTTP 200)
• Las solicitudes fallidas y limitadas por tarifa no consumen créditos.
• get_channel_latest_videos es gratis (sin cargo de créditos).
• Ver precios · Gestionar créditos

🚨 Solución de problemas

🔗 También disponible como API REST

¿Estás construyendo una aplicación en lugar de un agente? El mismo backend se ofrece como una API REST JSON.

URL base: https://transcriptapi.com/api/v2

🤝 Conéctate

• 🌐 Sitio web: transcriptapi.com
• 📚 Documentación: transcriptapi.com/docs
• 🔧 Referencia de API: transcriptapi.com/docs/api
• 🤖 Guías de configuración de MCP: Claude · ChatGPT · OpenAI Agent Builder
• 💬 Contacto: transcriptapi.com/contact
• 📂 Listado en: awesome-agent-plugins, nuestro directorio de complementos de agentes verificados en el estándar abierto

📋 Registro MCP

Este servidor está publicado en el Registro de Protocolo de Contexto de Modelo oficial bajo el nombre:

com.transcriptapi/youtube-transcript-and-youtube-search

_{© 2026 Zero Point Studio d.o.o. · Publicado bajo la Licencia MIT}