TranscriptAPI YouTube Skills
Obtenha transcrições do YouTube, pesquise vídeos, navegue por canais e extraia playlists de qualquer agente de IA — com tecnologia da TranscriptAPI.com, sem necessidade de chave de API.
Documentação
YouTube Skills para Agentes de IA 🎬
Obtenha transcrições do YouTube, pesquise vídeos, navegue por canais e extraia playlists — de qualquer agente de IA.
YouTube Skills dá ao seu agente de IA acesso instantâneo a transcrições do YouTube, pesquisa de vídeos, dados de canais e extração de playlists. Sem yt-dlp (o YouTube bloqueia todos os principais IPs de nuvem), sem navegadores headless, sem binários — apenas uma chamada de API rápida que funciona em qualquer lugar. Desenvolvido pela TranscriptAPI, o mesmo backend por trás do YouTubeToTranscript.com.
Funciona com 🦞 OpenClaw (ClawdBot/Moltbot), 
Hermes Agent, Claude Code, Cursor, Antigravity e qualquer agente que suporte o formato Agent Skills.
Plano gratuito · Sem cartão de crédito · 100 créditos no cadastro
TranscriptAPI.com · Servidor MCP · Documentação
Instalação
A maioria dos usuários quer o youtube-full — ele cobre transcrições, pesquisa, canais e playlists em uma única 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
Todas as 12 skills de uma 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/
Não é desenvolvedor? Basta colar este prompt no 🦞 OpenClaw,
Instale as skills do YouTube deste repositório GitHub: https://github.com/ZeroPointRepo/youtube-skills Quero poder obter transcrições do YouTube, pesquisar no YouTube e navegar por vídeos de canais pelo meu agente. Configure tudo para mim.O agente cuidará do resto.
O que você pode fazer
Basta instalar e pedir. Sem configuração, sem código — fale com seu agente em português simples.
| Tarefa | Exemplo de Prompt |
|---|---|
| Obter uma transcrição do YouTube | "Resuma este vídeo: [URL]" |
| Pesquisar no YouTube | "Encontre vídeos sobre machine learning" |
| Navegar por um canal | "O que o TED publicou esta semana?" |
| Obter conteúdo de playlist | "Liste todos os vídeos desta playlist" |
| Extrair legendas de vídeo | "Obtenha legendas deste vídeo em espanhol" |
| Transcrições em massa | "Obtenha transcrições de todos os vídeos deste canal" |
| Pesquisar um tópico | "Encontre e resuma os 5 melhores vídeos sobre computação quântica" |
| Obter uploads recentes | "Mostre os vídeos recentes da NASA" |
| Pesquisar dentro de um canal | "Pesquise no canal TED por 'inteligência artificial'" |
Configuração — Chave de API
Quando você instala uma skill e executa seu agente pela primeira vez, o agente configurará sua chave de API gratuita automaticamente. Veja o que acontece:
- O agente pede seu endereço de e-mail e registra você na TranscriptAPI
- Você receberá um código OTP no seu e-mail — o agente pedirá que você o insira
- Após a verificação, o agente salva a chave de API no seu shell e na configuração do agente automaticamente
É isso. 100 créditos gratuitos, sem cartão de crédito.
Configuração manual (se preferir fazer você mesmo)
-
Cadastre-se em transcriptapi.com — gratuito, sem cartão de crédito
-
Copie sua chave de API do painel (começa com
sk_) -
Peça ao seu agente para armazená-la:
"Minha chave TranscriptAPI é
sk_...— armazene-a para que persista entre sessões."
Ou defina você mesmo como uma variável de ambiente:
export TRANSCRIPT_API_KEY="sk_your_key_here"
Onde a chave é salva?
Seu agente armazena a chave de API aqui (depende do runtime):
| Local | Arquivo |
|---|---|
| OpenClaw/Moltbot | ~/.openclaw/openclaw.json ou ~/.clawdbot/moltbot.json |
| Hermes Agent | Armazenamento secreto do Hermes (TRANSCRIPT_API_KEY declarado via required_environment_variables no frontmatter da skill) |
| Shell macOS | ~/.zshenv, ~/.zprofile |
| Shell Linux | ~/.profile, ~/.bashrc, ~/.zshenv |
| Shell Fish | ~/.config/fish/config.fish |
| Fallback | ~/.transcriptapi (modo 600) |
Seu agente detecta automaticamente após salvar.
Skills
youtube-full é a skill recomendada para a maioria dos usuários. Ela inclui tudo: transcrições, pesquisa, canais, playlists.
Se preferir skills menores e focadas (contexto menor = melhor desempenho do agente para tarefas específicas), escolha o que você precisa:
| Skill | O que faz | Instalação |
|---|---|---|
| youtube-full | Tudo — transcrições, pesquisa, canais, playlists | --skill youtube-full |
| transcript | Obter transcrições de vídeo com timestamps | --skill transcript |
| youtube-search | Pesquisar vídeos e canais no YouTube | --skill youtube-search |
| youtube-channels | Navegar por uploads, obter vídeos recentes, resolver @handles | --skill youtube-channels |
| youtube-playlist | Extrair todos os vídeos de uma playlist | --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
Todas as 12 skills
Enviamos 12 skills no total. Muitas são variantes mais restritas ou aliases das 5 principais acima — para que seu agente encontre a skill certa independentemente de como você formula sua solicitação.
| Skill | Descrição |
|---|---|
| youtube-full | Kit completo do YouTube — transcrições + pesquisa + canais + playlists |
| transcript | Extrair transcrição de qualquer vídeo do YouTube com timestamps |
| captions | Obter legendas ocultas / CC de vídeos do YouTube |
| subtitles | Extrair subtítulos de vídeos do YouTube |
| youtube-search | Pesquisar vídeos e canais no YouTube |
| youtube-channels | Navegar por uploads de canais, obter vídeos recentes, resolver @handles |
| youtube-playlist | Buscar todos os vídeos de uma playlist do YouTube |
| youtube-data | Obter dados de vídeos e canais do YouTube (alternativa leve à API do Google) |
| youtube-api | Acesso à API do YouTube para agentes de IA — sem complicações de cota do Google |
| transcriptapi | Acesso completo à TranscriptAPI com todos os endpoints |
| video-transcript | Converter vídeos do YouTube em transcrições de texto |
| yt | Utilitário rápido do YouTube para consultas rápidas |
Preços
| Plano | Preço | Créditos | Limite de taxa |
|---|---|---|---|
| Gratuito | $0 | 100 créditos no cadastro | 300 req/min |
| Starter | $5/mês | 1.000 créditos/mês | 300 req/min |
| Starter Anual | $54/ano ($4,50/mês) | 1.000 créditos/mês | 300 req/min |
A maioria das operações custa 1 crédito. Resolução de canal e vídeos recentes são gratuitos. Sem cartão de crédito para o plano gratuito.
Agentes Suportados
Funciona com qualquer agente de IA que suporte o formato Agent Skills:
| Agente | Comando de Instalação |
|---|---|
| 🦞 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 |
| Outros | Goose, AMP, Kiro, Roo, OpenCode, Gemini, GitHub Copilot... |
FAQ
Como obtenho uma transcrição do YouTube?
Instale youtube-full (ou transcript) e peça ao seu agente:
"Obtenha a transcrição deste vídeo: https://youtube.com/watch?v=VIDEO_ID"
O agente busca a transcrição completa com timestamps. Você pode então pedir para resumir, traduzir, citar ou analisar o conteúdo.
Como pesquiso no YouTube pelo meu agente?
Instale youtube-full (ou youtube-search) e peça:
"Encontre vídeos sobre machine learning"
Retorna até 50 resultados com títulos, miniaturas, contagens de visualizações e datas de publicação.
Como obtenho todos os vídeos de um canal do YouTube?
Instale youtube-full (ou youtube-channels) e peça:
"Liste todos os vídeos do canal TED"
O agente resolve o @handle, busca os uploads (paginados, 100/página) e pode então obter transcrições de qualquer um ou de todos eles.
Posso baixar transcrições do YouTube em massa?
Sim. Instale youtube-full e peça:
"Obtenha transcrições de todos os vídeos desta playlist: [URL]"
O agente busca a playlist, percorre os vídeos e extrai cada transcrição.
Preciso de uma chave da API Google YouTube Data?
Não. A TranscriptAPI substitui a API Google YouTube Data para extração de transcrições, pesquisa e operações de canal/playlist. Sem projeto no Google Cloud, sem limites de cota, sem configuração OAuth.
Preciso de uma chave de API?
Sim, mas o cadastro é gratuito e instantâneo — 100 créditos, sem cartão de crédito. Seu agente cuida da configuração automaticamente na primeira execução.
Qual skill devo instalar?
- Quer tudo? →
youtube-full(recomendado) - Apenas transcrições? →
transcript - Apenas pesquisa? →
youtube-search - Apenas dados de canais? →
youtube-channels - Apenas playlists? →
youtube-playlist
O que é a TranscriptAPI?
TranscriptAPI.com é uma API REST e servidor MCP para dados do YouTube. Ela fornece extração de transcrições, pesquisa de vídeos, navegação de canais e operações de playlist — construída para desenvolvedores e agentes de IA. Também disponível como Servidor MCP para integração direta com LLMs (Claude, ChatGPT).
Solução de Problemas
Correções rápidas para os problemas que os usuários realmente encontram. Os códigos de erro vêm da própria API, então seu agente geralmente os reportará literalmente.
| Sintoma | Causa provável | Correção |
|---|---|---|
401 Unauthorized | Chave de API ausente, digitada incorretamente ou não carregada no ambiente | Confirme que TRANSCRIPT_API_KEY está definido no shell em que seu agente executa e que a chave começa com sk_ |
402 Payment Required | A conta está sem créditos | Verifique seu saldo em transcriptapi.com/billing |
403 com código Cloudflare 1010 | Solicitação enviada sem cabeçalho User-Agent | Envie o nome do seu agente como User-Agent, por exemplo HermesAgent/0.11.0 |
404 Not Found | O vídeo não tem legendas, não é público ou o ID está errado | Verifique se a URL abre no navegador e se o player mostra legendas lá |
408 Request Timeout | Pressão temporária upstream no vídeo | Transitório por natureza: tente novamente após alguns segundos |
422 Validation Error | Um parâmetro está malformado, como uma referência inválida de canal ou playlist | Canais aceitam @handle, uma URL de canal ou um ID UC; playlists aceitam prefixos PL, UU, LL, FL e OL |
429 Too Many Requests | Limite de taxa atingido | Aguarde e respeite o cabeçalho Retry-After |
Mais três casos que vale a pena conhecer:
- A chave está salva, mas o agente não consegue vê-la. Os arquivos de configuração do shell carregam por tipo de shell: verifique a tabela em "Onde a chave é salva?" na seção de Configuração e certifique-se de que o arquivo corresponde ao shell em que seu agente realmente executa. Reiniciar o agente após salvar a chave resolve a maioria dos casos.
- Transmissões ao vivo e estreias. As transcrições ficam disponíveis após o término da transmissão e o processamento das legendas, não enquanto está ao vivo.
- A transcrição retorna em um idioma inesperado. Muitos vídeos só possuem legendas no idioma original. Solicite a transcrição com um parâmetro de idioma preferido ou peça ao seu agente para traduzir o resultado.
Desenvolvido pela TranscriptAPI
TranscriptAPI.com — 15M+ transcrições/mês, 99,9% de uptime.
Também disponível: Servidor MCP para integração direta com LLMs usando Claude e ChatGPT.
Documentação completa da API: transcriptapi.com/docs
Listado em awesome-hermes-skills, nosso diretório de skills, plugins, perfis de agente e provedores de memória do Hermes Agent.
Divulgação
A TranscriptAPI é um produto independente e não é afiliada nem endossada pelo YouTube ou Google.
Contribuindo
PRs são bem-vindos. Veja CONTRIBUTING.md.
Licença
MIT © TranscriptAPI