--- title: "Agent Skills da transcript.im para transcrições e pesquisa" description: "Dê ao Claude Code, Cursor, Codex e outros agentes as Agent Skills da transcript.im para transcrições, descoberta no YouTube e fluxos de pesquisa, com o MCP como primeira via e a API REST como alternativa." canonical: "https://transcript.im/pt-BR/skills" markdown: "https://transcript.im/pt-BR/skills.md" --- # Agent Skills da transcript.im para transcrições e pesquisa Dê ao Claude Code, Cursor, Codex e outros agentes as Agent Skills da transcript.im para transcrições, descoberta no YouTube e fluxos de pesquisa, com o MCP como primeira via e a API REST como alternativa. ## Links - [HTML canônico](https://transcript.im/pt-BR/skills) - [Markdown](https://transcript.im/pt-BR/skills.md) As Agent Skills empacotam os recursos da transcript.im como instruções que um agente carrega quando precisa. Uma skill ensina o agente quando recorrer a uma transcrição, qual ferramenta chamar e como é um bom resultado. As skills chamam o servidor MCP da transcript.im quando ele está configurado e recorrem à API REST quando não está, então o mesmo pacote funciona no Claude Code, Cursor, Codex, Copilot, Gemini CLI e outros ambientes de Agent Skills sem reescrever para cada ferramenta. - Três pacotes por plataforma —YouTube, TikTok e Instagram— mais um pacote de fluxos de trabalho para pesquisa e redação multiplataforma. - As skills chamam primeiro o servidor MCP da transcript.im e recorrem à API REST com a mesma chave. - As transcrições cobrem YouTube, TikTok, Instagram, LinkedIn e Twitter/X. A descoberta do YouTube adiciona busca, canais, envios, playlists e metadados de legendas. - As skills de fluxo de trabalho retornam artefatos —relatórios, notas e conteúdo reaproveitado— com citações das fontes. - Cada pacote são arquivos `SKILL.md` puros, então carrega em qualquer ambiente que aceite o formato Agent Skills. ## O que são as Agent Skills da transcript.im? As Agent Skills são arquivos `SKILL.md` puros que descrevem uma capacidade na linguagem que o agente já entende: quando usar, o que chamar e o que retornar. A transcript.im mantém um conjunto dessas skills para que um agente de código trabalhe com transcrições de vídeo sem uma integração sob medida para cada plataforma. Cada skill é uma camada fina de instruções sobre o plano de dados da transcript.im. A skill não reimplementa a extração; ela diz ao agente qual ferramenta chamar e como moldar a resposta. Essa separação mantém as instruções curtas e o comportamento consistente: o mesmo pipeline de transcrição sustenta uma chamada de skill e uma requisição direta à API. - Instruções, não infraestrutura — uma skill ensina o agente a fazer; a transcript.im faz a extração. - Pacotes por plataforma e pacotes de fluxo de trabalho — um pacote para YouTube, TikTok e Instagram, mais skills para pesquisa e redação em várias etapas. - MCP primeiro, REST como alternativa — a skill prefere o servidor MCP e recorre à API REST quando o MCP não está disponível. - Artefatos com citações — as skills de fluxo de trabalho mantêm o link de origem e as palavras exatas junto do que produzem. ## Pacotes de skills por plataforma Há pacotes dedicados para YouTube, TikTok e Instagram. A extração de transcrições alcança as cinco plataformas que a API aceita; as skills de descoberta —busca, canais, envios, playlists e metadados de legendas— são só do YouTube, porque é a plataforma para a qual a API pública expõe a descoberta. ### Skills do YouTube O pacote mais amplo. Cobre transcrições com ou sem marcações de tempo, além da superfície de descoberta do YouTube: busca de vídeos e canais, resolução de canais, envios de canais, itens de playlist e metadados de legendas, com uma skill de entrada completa que reúne tudo. `youtube-transcript` e `youtube-api` são entradas alias para as formas comuns de pedir, então o agente ativa do mesmo jeito quando alguém diz "YouTube transcript" ou "YouTube API". ### Skills do TikTok As skills do TikTok focam na transcrição: as legendas são lidas primeiro e o reconhecimento de fala cobre o vídeo que não tem nenhuma. Cole um link do TikTok e o agente retorna texto limpo com marcações de tempo que ele pode citar, traduzir ou reaproveitar. Como a skill sabe quando a transcrição é a resposta certa, ela carrega ao colar um link mesmo quando o usuário nunca diz a palavra transcrição. ### Skills do Instagram O Instagram não tem faixa de legendas para ler, então suas skills são construídas em torno do reconhecimento de fala assíncrono. As skills `reel` e `transcript` transformam um Reel ou post de vídeo público em texto com marcações de tempo, e uma skill de entrada completa reúne o pacote. O agente envia o link e consulta o trabalho enquanto faz outra coisa, e depois retorna o texto pronto. ## Skills de fluxo de trabalho que produzem artefatos ### Inteligência de transcrições Resuma e explore transcrições do YouTube, TikTok, Instagram, LinkedIn ou Twitter/X em um relatório com resumos, pontos-chave, citações exatas, ganchos e trechos de conteúdo reaproveitáveis, cada um ligado à sua fonte. Em vez de ler uma hora de gravação, você recebe o argumento, as evidências e as falas que valem reutilizar em uma única passada. ### Pesquisa de concorrência Compare concorrentes ou criadores entre os vídeos que você traz, descubra o que funciona em um nicho e compare temas, formatos, ganchos e argumentos. A descoberta do YouTube fornece as varreduras de canais e playlists; outras plataformas contribuem com as transcrições que você indicar. O resultado é um relatório de concorrência citado, então uma afirmação pode ser rastreada até o vídeo e o momento em que foi dita. ### Reaproveitamento de conteúdo Transforme transcrições ou pesquisa em conteúdo reaproveitável: posts de blog, threads no X/Twitter, roteiros de vídeo curto, newsletters e um calendário de conteúdo, entregues como rascunhos prontos para editar com atribuição da fonte. O rascunho mantém as palavras do falante onde importam, então o resultado soa como a fonte e não como um resumo genérico. O pacote de fluxo de trabalho também inclui três skills de foco: - Notas de reunião — decisões, tarefas com responsáveis, perguntas abertas, riscos e citações da transcrição de uma reunião ou chamada. - Notas de aula — notas de estudo estruturadas, definições, argumentos principais, exemplos e perguntas de revisão de uma aula ou tutorial. - Roteamento da API de transcrições — a skill da camada de dados que todo fluxo de trabalho chama para obter uma transcrição, rodar um lote ou descobrir vídeos, canais e playlists do YouTube. ## Como uma skill chega à transcript.im Uma skill nunca fala diretamente com uma plataforma. Ela chega à transcript.im, e a transcript.im cuida da fonte. - MCP primeiro — quando o servidor MCP da transcript.im está configurado, a skill chama suas ferramentas diretamente e recebe resultados estruturados. - REST como alternativa — sem MCP, a skill chama os mesmos endpoints REST com a mesma chave de API, então o comportamento não depende de o ambiente aceitar MCP. - Uma única credencial — a chave é lida do ambiente ou da configuração MCP do agente, então a skill não gerencia seus próprios segredos nem pede ao usuário um segundo login. - A mesma conta — uma chamada feita por uma skill cai na mesma conta e no mesmo histórico de uma chamada feita pela API ou pelo próprio produto. - Pacotes portáveis — como o roteamento vive na skill, o mesmo pacote se move entre ambientes sem mudar o código. ## O que um pacote contém Cada pacote é um conjunto de arquivos `SKILL.md`: uma skill de entrada completa que reúne as skills do pacote, mais sub-skills focadas que um agente pode carregar por conta própria. Como um pacote segue o formato Agent Skills, ele pode ficar no diretório de skills de um agente junto das outras skills que você já usa, e a skill de entrada continua sabendo quando passar para as mais específicas. - YouTube — uma skill de entrada completa mais skills de transcrição, busca, canal, playlist e legendas, com entradas alias `youtube-transcript` e `youtube-api`. - TikTok — uma skill de entrada completa mais uma skill de transcrição e seu alias, focadas na extração que prioriza legendas e recorre ao reconhecimento de fala. - Instagram — uma skill de entrada completa mais as skills `reel` e `transcript`, construídas em torno do reconhecimento de fala assíncrono. - Fluxo de trabalho — a skill de roteamento `transcript-api` mais inteligência, pesquisa de concorrência, reaproveitamento de conteúdo, notas de reunião e notas de aula. ## Ambientes que carregam estas skills As skills seguem a convenção Agent Skills, então qualquer ambiente que leia esse formato pode carregá-las. Isso inclui Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf, OpenClaw e Hermes Agent, entre outros. Uma skill é uma pasta de Markdown e pequenos scripts, não um binário de plugin, então nada precisa ser compilado para um ambiente novo e um pacote escrito para um se transfere quando você troca. O efeito prático é que o mesmo fluxo de transcrição acompanha você entre ferramentas em vez de ficar preso ao assistente que você configurou primeiro, e você não mantém uma integração separada para cada uma. ## Relacionado - [Documentação da API](/docs) - [API REST](/pt-BR/api) - [Servidor MCP](/pt-BR/mcp) - [Gerador de transcrições do YouTube](/pt-BR/youtube-transcript) - [Resumidor de vídeos do YouTube](/pt-BR/youtube-video-summarizer) - [Gerador de legendas do YouTube](/pt-BR/youtube-subtitle-generator) - [Baixador de legendas do YouTube](/pt-BR/youtube-subtitle-downloader) - [Transcrições de canais do YouTube](/pt-BR/youtube-channel-transcript) - [Transcrições de playlists do YouTube](/pt-BR/youtube-playlist-transcript) ## Perguntas frequentes sobre as Agent Skills ### O que são as Agent Skills da transcript.im? As Agent Skills da transcript.im são pacotes de `SKILL.md` que ensinam um agente de IA quando e como usar a transcript.im para obter transcrições, rodar lotes, descobrir vídeos do YouTube e produzir artefatos de pesquisa. ### Quais ambientes de agente podem carregar estas skills? Qualquer ambiente que aceite o formato Agent Skills, incluindo Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf, OpenClaw e Hermes Agent. ### As skills precisam do servidor MCP? Não. Uma skill chama o servidor MCP quando ele está configurado e, caso contrário, chega diretamente à mesma API REST com a mesma chave de API. ### Quais plataformas as Agent Skills cobrem? Há pacotes dedicados para YouTube, TikTok e Instagram, além de uma coleção de fluxos de trabalho que funciona no YouTube, TikTok, Instagram, LinkedIn e Twitter/X. A extração de transcrições cobre as cinco plataformas; a descoberta do YouTube adiciona busca, canais, envios, playlists e metadados de legendas. ### O que as skills de fluxo de trabalho podem produzir? As skills de fluxo de trabalho produzem relatórios de inteligência, relatórios de concorrência citados, rascunhos de conteúdo reaproveitado, notas de reunião e notas de aula, cada um com suas citações de origem. ### Como um pacote de skills de transcrição é organizado? Cada pacote traz uma skill de entrada completa mais sub-skills focadas, então um agente pode ativar a plataforma inteira ou só a peça que uma tarefa precisa. ### Como uma skill se autentica na transcript.im? A skill lê uma chave de API do ambiente ou da configuração MCP do agente e a envia à transcript.im, então uma chamada por uma skill usa a mesma conta de uma chamada direta à API. ### Posso escrever minha própria skill de fluxo de trabalho sobre a transcript.im? Sim. Os pacotes são arquivos `SKILL.md` puros com pequenos scripts de apoio, então você pode escrever uma skill no mesmo formato, descrever quando ela deve carregar e rodá-la junto dos pacotes de plataforma. ## Dê skills de transcrição ao seu agente Adicione um pacote de plataforma ou o pacote de fluxo de trabalho ao seu agente, forneça uma chave de API e deixe-o obter a transcrição. - [Obter uma chave de API](/app/account/api-keys) - [Ler a documentação](/docs)