Crie uma Skill de Transcrição de Vídeos do Bilibili

Alguns leitores me perguntaram se seria possível automatizar anotações a partir de vídeos do Bilibili. Criei uma Skill para isso e agora estou disponibilizando-a como código aberto.

A Skill funciona assim: você fornece um link do Bilibili, ela baixa automaticamente o áudio do vídeo, envia para uma IA fazer a transcrição, usa outra IA para gerar um resumo e, por fim, salva tanto a transcrição completa quanto o resumo em uma caixa de entrada do Obsidian.

Todo o processo não requer operação manual; basta esperar um pouco e está pronto.

Ferramentas Necessárias

Esta Skill requer algumas ferramentas trabalhando juntas.

yt-dlp

Esta é uma ferramenta de linha de comando para baixar áudio/vídeo de várias plataformas. A Skill a utiliza para baixar o fluxo de áudio de vídeos do Bilibili como arquivos M4A.

Instalação no macOS (recomendada):

brew install yt-dlp

Se você não tiver o Homebrew, também pode instalar via pip:

pip install yt-dlp

ffmpeg

O yt-dlp depende do ffmpeg para processamento de áudio; sem ele, podem ocorrer erros.

brew install ffmpeg

Python 3

A Skill inclui um script Python que lida com chamadas de API, processamento de arquivos e renderização de modelos. O macOS geralmente vem com Python 3; verifique com:

python3 -V

Contanto que você veja um número de versão, está ok. Nenhuma versão específica é necessária.

Gemini API (Transcrição de Áudio)

A transcrição usa o modelo Gemini do Google, especificamente o gemini-3-flash-preview.

Este modelo tem uma cota gratuita diária para contas normais do Google, suficiente para uso diário. Se você exceder a cota, receberá um erro 429; basta esperar até o dia seguinte quando a cota for redefinida.

Obtenha uma chave de API em: aistudio.google.com

Ao entrar, clique em Get API key à esquerda e crie uma.

DeepSeek API (Resumo de Conteúdo)

O resumo usa o DeepSeek, que considero adequado aos meus hábitos de resumo.

Obtenha uma chave de API em: platform.deepseek.com

Registre uma conta e crie uma chave de API. A API do DeepSeek é muito acessível; uma pequena recarga dura muito tempo.

Instalação e Uso

Passo 1: Baixar o Pacote da Skill

Baixe do meu blog: https://blog.discoverlabs.ac.cn/downloads/bili-to-obsidian-skill/

Após extrair, coloque a pasta em ~/.claude/skills/, garantindo que o caminho seja ~/.claude/skills/bili_to_obsidian/.

Passo 2: Preencher a Configuração

Abra ~/.claude/skills/bili_to_obsidian/scripts/bili_to_obsidian.py e encontre as primeiras linhas:

API_KEY = "YOUR_GEMINI_API_KEY"
DEEPSEEK_API_KEY = "YOUR_DEEPSEEK_API_KEY"

TEMPLATE_PATH = Path("/path/to/your/Obsidian-vault/02-Templates/Note.md")
OUTPUT_DIR = Path("/path/to/your/Obsidian-vault/00-Inbox")

Modifique estes campos:

1. YOUR_GEMINI_API_KEY: Substitua pela chave que você obteve em aistudio.google.com
2. YOUR_DEEPSEEK_API_KEY: Substitua pela chave que você obteve no DeepSeek
3. TEMPLATE_PATH: Substitua pelo caminho completo do seu modelo de nota do Obsidian
4. OUTPUT_DIR: Substitua pelo caminho completo da sua caixa de entrada do Obsidian

Se você não usa um modelo de nota do Obsidian, pode definir TEMPLATE_PATH para qualquer caminho inexistente; o script gerará um formato básico se o modelo não for encontrado, o que ainda funciona.

Passo 3: Invocar

No Claude Code, digite:

/bili_to_obsidian paste-the-Bilibili-video-link-here

Depois, aguarde a conclusão; geralmente leva alguns minutos.

Notas Importantes

A cota gratuita do Gemini é limitada por dia. Se você processar muitos vídeos em um dia e encontrar um erro 429, você excedeu a cota. Aguarde até o dia seguinte para a cota ser redefinida. Se você exceder frequentemente, registre várias contas do Google e alterne as chaves de API.

As linhas de caminho devem ser alteradas para as suas. As que estão no pacote de download são do meu computador; usá-las diretamente causará erros.

O formato é baseado no meu modelo do Obsidian. Se a estrutura do seu modelo for diferente, o conteúdo da transcrição pode ser colocado incorretamente. Nesse caso, basta fornecer o script a uma IA, descrever a estrutura do seu modelo e pedir que ela ajuste os pontos de ancoragem.

Download

Baixe do meu blog (removi minhas próprias chaves de API):

https://blog.discoverlabs.ac.cn/downloads/bili-to-obsidian-skill/

Estou usando esta Skill há algum tempo. É especialmente conveniente para transcrever vídeos educacionais do Bilibili e salvá-los diretamente no Obsidian para consulta.

Além disso, o download de áudio usa o yt-dlp, que suporta não apenas o Bilibili, mas também centenas de sites de vídeo como YouTube, Twitter, Douyin, etc. Portanto, esta Skill não se limita ao Bilibili; você pode usá-la com links de outras plataformas também. Sinta-se à vontade para testá-la e estendê-la ainda mais.