Bilibili Audio Skill
shuolsure/bilibili-audio-skillИнструмент для загрузки аудио с Bilibili: поддержка одиночных видео и пакетной загрузки по ID автора. Автовыбор максимального качества M4A, докачка, защита от блокировок. Интеграция с Claude Code Skill через BBDown.
Установка
git clone https://github.com/shuolsure/bilibili-audio-skill.gitREADME
bilibili-audio
🎵 Инструмент для скачивания аудио с Bilibili! Поддерживает загрузку отдельных видео и всех видео выбранного автора, интегрирован как Claude Code Skill.
✨ Возможности
| Функция | Описание |
|---|---|
| 🎯 Два режима | Загрузка одного видео + пакетная загрузка по автору |
| 🎵 Максимальное качество | Автоматический выбор M4A с наибольшим битрейтом |
| ⏭️ Докачка | Автоматический пропуск уже загруженных видео |
| 📝 Субтитры | Автоматическое встраивание субтитров (при наличии) |
| 🛡️ Защита от блокировок | Случайные интервалы (3–8 сек) для имитации действий пользователя |
| 📁 Стандартное именование | дата_название_BV-номер.m4a |
| 🔧 На базе BBDown | Использует встроенные возможности BBDown для получения списка видео |
📦 Установка
Предварительные требования
# Установить BBDown (обязательно)
brew install BBDown
# Войти в аккаунт Bilibili (при первом использовании)
BBDown loginУстановка как Claude Code Skill
Разместите директорию в папке skills для Claude Code:
~/.claude/skills/bilibili-audio/
🚀 Использование
Загрузка одного видео
Передайте ссылку на видео Bilibili:
/bilibili-audio https://b23.tv/xxx
Поддерживаемые форматы ссылок:
https://www.bilibili.com/video/BVxxxhttps://b23.tv/xxx(короткая ссылка)
Пакетная загрузка видео автора
Передайте ID пользователя или ссылку на его страницу:
# По ID пользователя
/bilibili-audio 593926706
# По ссылке на страницу
/bilibili-audio https://space.bilibili.com/593926706💡 Как найти ID пользователя: это число в URL страницы автора, например
593926706вhttps://space.bilibili.com/593926706
📂 Структура директорий
bilibili-audio/
├── SKILL.md # Определение Claude Code Skill
├── README.md # Документация
└── scripts/
└── bbdown_space_crawler.py # Получение списка видео через BBDown
🔧 Принцип работы
Получение списка видео
Для получения списка видео автора используются встроенные возможности BBDown:
- Скрипт
bbdown_space_crawler.py - Вызов
BBDown --debugдля получения списка видео - Надёжная работа на базе встроенных возможностей BBDown
- Отсутствие ограничений по частоте запросов к API
- Поддержка получения списка видео из скрытых пространств (даже при включённой приватности у автора)
📁 Расположение файлов
| Режим | Путь сохранения |
|---|---|
| Одно видео | ~/B站音频下载/ |
| Пакетная загрузка | ~/B站音频下载/<ID пользователя>/ |
📝 Формат именования файлов
2025-06-27_【张雪峰】理科生必看！_BV118KZzzE1Q.m4a
Формат: дата_публикации_название_BV-номер.m4a
🔧 Устранение неполадок
| Проблема | Решение |
|---|---|
| BBDown не установлен | brew install BBDown |
| Cookie устарел | Повторный вход: BBDown login |
| Ошибка загрузки | Проверьте сеть или повторите позже |
| Видео недоступно | Возможно, удалено или доступно только по подписке |
| Повторная загрузка пропущенных файлов | rm -f ~/tools/BBDown.archives |
| Не удаётся получить список видео | Проверьте, выполнен ли вход в BBDown |
📋 Примеры
Загрузка одного видео
Пользователь: Скачай аудио из этого видео Bilibili https://b23.tv/my4tCDF
Ассистент: Хорошо, начинаю загрузку аудио из видео...
Название: 【张雪峰】理科生必看！全网最全理科生志愿填报详细攻略
Дата публикации: 2025-06-27
Длительность: 35 мин 14 сек
✅ Загрузка завершена! Файл сохранён в ~/B站音频下载/
Пакетная загрузка видео автора
Пользователь: Скачай аудио всех видео автора 593926706
Ассистент: Определён ID автора: 593926706, начинаю пакетную загрузку...
Получение списка видео... Найдено 128 видео
Начинаю загрузку...
Прогресс: 128/128 | Успешно: 125 | Ошибок: 3
✅ Загрузка завершена! Файлы сохранены в ~/B站音频下载/593926706/
⚠️ Важно
- При пакетной загрузке используются случайные интервалы (3–8 сек) для имитации действий пользователя и защиты от блокировок
- При получении списка видео применяются случайные интервалы (2–5 сек) для предотвращения ограничений
- Видео, доступные только по подписке, загрузить невозможно
- Удалённые видео автоматически пропускаются
📜 Лицензия
MIT License