몇몇 독자분들이 Bilibili 동영상에서 자동으로 노트를 작성할 수 있는지 물어보셨습니다. 그래서 이 스킬을 만들어서 오픈소스로 공개합니다.
이 스킬의 동작 방식은 다음과 같습니다. Bilibili 링크를 주면 자동으로 동영상의 오디오를 다운로드하고, AI에 보내 자막을 추출한 후, 다른 AI로 요약을 생성합니다. 마지막으로 전체 자막과 요약을 Obsidian 인박스에 저장합니다.
전체 과정에 수동 조작이 필요 없으며, 잠시 기다리면 완료됩니다.
필요한 도구
이 스킬을 사용하려면 몇 가지 도구가 함께 작동해야 합니다.
yt-dlp
여러 플랫폼에서 오디오/비디오를 다운로드하는 명령줄 도구입니다. 이 스킬은 Bilibili 동영상의 오디오 스트림을 M4A 파일로 다운로드하는 데 사용합니다.
macOS 설치 (권장):
brew install yt-dlp
Homebrew가 없다면 pip으로도 설치할 수 있습니다.
pip install yt-dlp
ffmpeg
yt-dlp는 오디오 처리에 ffmpeg에 의존합니다. 없으면 오류가 발생할 수 있습니다.
brew install ffmpeg
Python 3
이 스킬에는 API 호출, 파일 처리, 템플릿 렌더링을 처리하는 Python 스크립트가 포함되어 있습니다. macOS에는 보통 Python 3가 함께 제공됩니다. 다음 명령어로 확인하세요.
python3 -V
버전 번호만 보이면 됩니다. 특정 버전이 필요하지는 않습니다.
Gemini API (오디오 자막 추출)
자막 추출에는 Google의 Gemini 모델, 특히 gemini-3-flash-preview를 사용합니다.
이 모델은 일반 Google 계정에 일일 무료 할당량이 있어 일상적인 사용에 충분합니다. 할당량을 초과하면 429 오류가 발생하며, 다음 날 할당량이 초기화될 때까지 기다리면 됩니다.
API 키는 aistudio.google.com에서 받을 수 있습니다.
사이트에 접속한 후 왼쪽에서 Get API key를 클릭하여 생성하세요.
DeepSeek API (내용 요약)
요약에는 DeepSeek을 사용합니다. 제 요약 습관에 잘 맞아서 선택했습니다.
API 키는 platform.deepseek.com에서 받을 수 있습니다.
계정을 등록한 후 API 키를 생성하세요. DeepSeek API는 매우 저렴해서 소액 충전으로 오래 사용할 수 있습니다.
설치 및 사용법
1단계: 스킬 패키지 다운로드
제 블로그에서 다운로드하세요: https://blog.discoverlabs.ac.cn/downloads/bili-to-obsidian-skill/
압축을 푼 후 폴더를 ~/.claude/skills/에 넣고, 경로가 ~/.claude/skills/bili_to_obsidian/가 되도록 하세요.
2단계: 설정 입력
~/.claude/skills/bili_to_obsidian/scripts/bili_to_obsidian.py 파일을 열고 처음 몇 줄을 찾으세요.
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")
다음 필드를 수정하세요.
YOUR_GEMINI_API_KEY: aistudio.google.com에서 받은 키로 바꾸세요.YOUR_DEEPSEEK_API_KEY: DeepSeek에서 받은 키로 바꾸세요.TEMPLATE_PATH: Obsidian 노트 템플릿의 전체 경로로 바꾸세요.OUTPUT_DIR: Obsidian 인박스의 전체 경로로 바꾸세요.
Obsidian 노트 템플릿을 사용하지 않는다면 TEMPLATE_PATH를 존재하지 않는 경로로 설정해도 됩니다. 템플릿을 찾을 수 없으면 스크립트가 기본 형식을 생성하므로 정상 작동합니다.
3단계: 실행
Claude Code에서 다음 명령어를 입력하세요.
/bili_to_obsidian paste-the-Bilibili-video-link-here
그러면 완료될 때까지 기다리세요. 보통 몇 분 안에 끝납니다.
중요 참고 사항
Gemini의 무료 할당량은 하루에 제한되어 있습니다. 하루에 많은 동영상을 처리하다가 429 오류가 발생하면 할당량을 초과한 것입니다. 다음 날 할당량이 초기화될 때까지 기다리세요. 자주 초과한다면 여러 Google 계정을 등록하고 API 키를 교체해서 사용하세요.
경로 줄은 반드시 자신의 것으로 변경해야 합니다. 다운로드 패키지에 있는 것은 제 컴퓨터의 경로이므로 그대로 사용하면 오류가 발생합니다.
형식은 제 Obsidian 템플릿을 기준으로 합니다. 템플릿 구조가 다르면 자막 내용이 잘못된 위치에 들어갈 수 있습니다. 그런 경우 스크립트를 AI에 넘기고 템플릿 구조를 설명한 후 앵커 포인트를 조정해 달라고 요청하세요.
다운로드
제 블로그에서 다운로드하세요 (제 API 키는 제거했습니다).
https://blog.discoverlabs.ac.cn/downloads/bili-to-obsidian-skill/
이 스킬을 한동안 사용해 왔습니다. 교육용 Bilibili 동영상의 자막을 추출해서 Obsidian에 바로 저장해 참고하기에 특히 편리합니다.
추가로, 오디오 다운로드는 yt-dlp를 사용하는데, Bilibili뿐만 아니라 YouTube, Twitter, Douyin 등 수백 개의 동영상 사이트를 지원합니다. 따라서 이 스킬은 Bilibili에 국한되지 않고 다른 플랫폼의 링크에도 사용할 수 있습니다. 자유롭게 사용해 보고 더 확장해 보세요.