Algunos lectores me han preguntado si podrían automatizar la toma de notas a partir de videos de Bilibili. Creé una habilidad para eso y ahora la estoy publicando como código abierto.
La habilidad hace lo siguiente: dale un enlace de Bilibili, descarga automáticamente el audio del video, lo envía a una IA para transcribirlo, usa otra IA para generar un resumen y, finalmente, guarda tanto la transcripción completa como el resumen en la bandeja de entrada de Obsidian.
Todo el proceso no requiere ninguna operación manual; solo espera un poco y estará listo.
Herramientas necesarias
Esta habilidad requiere que varias herramientas trabajen juntas.
yt-dlp
Es una herramienta de línea de comandos para descargar audio/video de varias plataformas. La habilidad la usa para descargar el flujo de audio de los videos de Bilibili como archivos M4A.
Instalación en macOS (recomendada):
brew install yt-dlp
Si no tienes Homebrew, también puedes instalarlo mediante pip:
pip install yt-dlp
ffmpeg
yt-dlp depende de ffmpeg para el procesamiento de audio; sin él pueden ocurrir errores.
brew install ffmpeg
Python 3
La habilidad incluye un script de Python que maneja las llamadas a la API, el procesamiento de archivos y el renderizado de plantillas. macOS normalmente viene con Python 3; verifícalo con:
python3 -V
Mientras veas un número de versión, está bien. No se requiere una versión específica.
API de Gemini (Transcripción de audio)
La transcripción usa el modelo Gemini de Google, específicamente gemini-3-flash-preview.
Este modelo tiene una cuota gratuita diaria para cuentas regulares de Google, suficiente para el uso diario. Si superas la cuota, recibirás un error 429; solo espera hasta el día siguiente cuando se restablezca la cuota.
Obtén una clave de API en: aistudio.google.com
Una vez dentro, haz clic en Get API key a la izquierda y crea una.
API de DeepSeek (Resumen de contenido)
El resumen usa DeepSeek, que considero que se adapta a mis hábitos de resumen.
Obtén una clave de API en: platform.deepseek.com
Regístrate, luego crea una clave de API. La API de DeepSeek es muy económica; una pequeña recarga dura mucho tiempo.
Instalación y uso
Paso 1: Descargar el paquete de la habilidad
Descárgalo desde mi blog: https://blog.discoverlabs.ac.cn/downloads/bili-to-obsidian-skill/
Después de extraerlo, coloca la carpeta en ~/.claude/skills/, asegurándote de que la ruta sea ~/.claude/skills/bili_to_obsidian/.
Paso 2: Completar la configuración
Abre ~/.claude/skills/bili_to_obsidian/scripts/bili_to_obsidian.py y busca las primeras líneas:
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")
Modifica estos campos:
YOUR_GEMINI_API_KEY: Reemplázalo con la clave que obtuviste de aistudio.google.comYOUR_DEEPSEEK_API_KEY: Reemplázalo con la clave que obtuviste de DeepSeekTEMPLATE_PATH: Reemplázalo con la ruta completa a tu plantilla de nota de ObsidianOUTPUT_DIR: Reemplázalo con la ruta completa a tu bandeja de entrada de Obsidian
Si no usas una plantilla de nota de Obsidian, puedes establecer TEMPLATE_PATH en cualquier ruta que no exista; el script generará un formato básico si no se encuentra la plantilla, lo cual sigue funcionando.
Paso 3: Invocar
En Claude Code, ingresa:
/bili_to_obsidian paste-the-Bilibili-video-link-here
Luego espera a que termine; normalmente se completa en unos minutos.
Notas importantes
La cuota gratuita de Gemini está limitada por día. Si procesas muchos videos en un día y encuentras un error 429, has superado la cuota. Espera hasta el día siguiente para que se restablezca. Si la superas con frecuencia, registra varias cuentas de Google y rota las claves de API.
Las líneas de ruta deben cambiarse por las tuyas. Las que vienen en el paquete de descarga son de mi computadora; usarlas directamente causará errores.
El formato se basa en mi plantilla de Obsidian. Si la estructura de tu plantilla es diferente, el contenido de la transcripción podría colocarse incorrectamente. En ese caso, simplemente dale el script a una IA, describe la estructura de tu plantilla y pídele que ajuste los puntos de anclaje.
Descarga
Descárgalo desde mi blog (he eliminado mis propias claves de API):
https://blog.discoverlabs.ac.cn/downloads/bili-to-obsidian-skill/
He estado usando esta habilidad por un tiempo. Es especialmente conveniente para transcribir videos educativos de Bilibili y guardarlos directamente en Obsidian para consultarlos.
Además, la descarga de audio usa yt-dlp, que no solo admite Bilibili, sino también cientos de sitios de video como YouTube, Twitter, Douyin, etc. Por lo tanto, esta habilidad no se limita a Bilibili; puedes usarla con enlaces de otras plataformas también. Siéntete libre de probarla y extenderla aún más.