Communitygithub.com

DoTheWorkNow/podcast-transcriber

Converta áudios do Bilibili / YouTube / Xiaoyuzhou / links diretos em transcrições Markdown com diarização de falantes. Skill para Claude Code — ASR Volcengine BigModel + fallback Groq Whisper.

O que é podcast-transcriber?

Esta skill permite que desenvolvedores e criadores de conteúdo convertam automaticamente arquivos de áudio de plataformas como Bilibili (B站), YouTube, Xiaoyuzhou (小宇宙) e links diretos em transcrições detalhadas no formato Markdown, com suporte à separação de falantes (diarização). Ideal para podcasts, entrevistas, palestras e qualquer conteúdo em áudio que precise ser transformado em texto legível e estruturado. A skill é compatível com o Claude Code e utiliza o modelo ASR da Volcengine BigModel como mecanismo principal de reconhecimento de fala, com fallback automático para o modelo Whisper da Groq caso o primeiro falhe. Isso garante alta precisão e resiliência em diferentes tipos de áudio. O processo é simples: forneça o link do conteúdo ou o arquivo de áudio, e a skill gera um documento Markdown com timestamps e identificação de quem falou, facilitando a revisão, edição e busca posterior. É uma ferramenta essencial para quem trabalha com documentação de áudio, legendagem ou análise de conteúdo falado.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add DoTheWorkNow/podcast-transcriber

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que podcast-transcriber faz?

Converta áudios do Bilibili / YouTube / Xiaoyuzhou / links diretos em transcrições Markdown com diarização de falantes. Skill para Claude Code — ASR Volcengine BigModel + fallback Groq Whisper.

Descrição

Esta skill permite transformar arquivos de áudio de diversas fontes (Bilibili, YouTube, Xiaoyuzhou ou links diretos) em transcrições completas no formato Markdown, com identificação automática de cada falante. É especialmente útil para podcasts, entrevistas, vídeos de palestras ou qualquer outro conteúdo em áudio onde seja necessário obter uma transcrição precisa e organizada.

Como funciona

  1. Forneça o URL ou caminho do áudio (Bilibili, YouTube, Xiaoyuzhou ou link direto).
  2. A skill baixa e processa o áudio.
  3. Utiliza o motor ASR da Volcengine BigModel como primeira opção para reconhecimento de fala e diarização.
  4. Caso haja falha, automaticamente recorre ao modelo Whisper da Groq.
  5. Gera um arquivo Markdown com timestamps e separação de falantes.

Pré-requisitos

  • Conta e credenciais para o serviço Volcengine BigModel (ASR).
  • (Opcional) Chave de API para Groq Whisper, se desejar usar o fallback.
  • Claude Code configurado e com acesso à internet.

Uso

Exemplo de comando (via Claude Code):

# Transcrever um episódio do YouTube
claude use DoTheWorkNow/podcast-transcriber --input "https://youtube.com/watch?v=example"
# Usar um link direto para um arquivo de áudio
claude use DoTheWorkNow/podcast-transcriber --input "https://exemplo.com/audio.mp3"

Resultado

O resultado é um arquivo .md com transcrição completa, seguindo o formato:

# Transcrição - Nome do Episódio

**[00:00:05] - Falante A:** Bem-vindos ao podcast!

**[00:00:10] - Falante B:** Obrigado por nos receber.

**[00:00:15] - Falante A:** Hoje vamos falar sobre...

Variáveis de ambiente

VariávelDescriçãoObrigatória
VOLC_ACCESS_KEYChave de acesso para VolcengineSim
VOLC_SECRET_KEYChave secreta para VolcengineSim
GROQ_API_KEYChave de API para Groq Whisper (fallback)Não

Licença

MIT

Habilidades Relacionadas