Bilibili Video Reader v2.1

Плагин для ChatGPT/Codex только для чтения, созданный как Skill + stateless MCP server, теперь ориентирован на Cloudflare Workers, чтобы работать без Render или кредитной карты.

MCP-инструменты

• get_bilibili_video_parts(url) — название, автор, описание, все номера P и CID.

• get_bilibili_part_transcript(url, part, language, max_chars) — официальные/ИИ-дорожки субтитров и транскрипт с таймкодами для одного P.

Worker напрямую обращается к эндпоинтам Bilibili для метаданных/плеера/субтитров. Для режима субтитров загрузка видео не требуется.

Развёртывание на Cloudflare Workers

Через панель управления

1. Создайте/войдите в аккаунт Cloudflare.

2. Откройте Workers & Pages → Create → Import a repository (формулировка может немного отличаться).

3. Подключите GitHub и выберите limuzi23/bilibili-video-reader-mcp.

4. Оставьте корень репозитория в качестве корневой директории.

5. Cloudflare должен автоматически обнаружить wrangler.jsonc.

6. Используйте команду развёртывания по умолчанию: npx wrangler deploy.

7. Разверните.

Имя Worker должно оставаться bilibili-video-reader-mcp, так как оно соответствует wrangler.jsonc.

После развёртывания Cloudflare выдаст вам URL, похожий на:

https://bilibili-video-reader-mcp.<your-subdomain>.workers.dev

Проверка работоспособности:

https://bilibili-video-reader-mcp.<your-subdomain>.workers.dev/health

MCP-эндпоинт:

https://bilibili-video-reader-mcp.<your-subdomain>.workers.dev/mcp

Для публичных субтитров секрет времени выполнения не требуется.

Необязательное приватное состояние входа

Если субтитры видны только при входе в аккаунт, Worker может читать необязательный секрет Cloudflare с именем BILI_COOKIE. Настраивайте его только в зашифрованном интерфейсе Variables and Secrets Cloudflare. Никогда не вставляйте сырые cookie в ChatGPT и не коммитьте их в GitHub.

Подключение к ChatGPT

1. ChatGPT → Settings → Security and login → включите Developer mode.

2. Откройте Plugins, нажмите + и зарегистрируйте развёрнутый URL, оканчивающийся на /mcp.

3. Скопируйте технический ID из созданного подключения. Он начинается с plugin_asdk_app_.

4. Запустите python scripts/configure_plugin.py plugin_asdk_app_YOUR_ID, если процесс упаковки плагина требует ссылку на приложение.

Манифест плагина OpenAI находится в .codex-plugin/plugin.json, а Skill рабочего процесса — в skills/bilibili-video-reader/.

Локальная разработка

npm install
npm run dev

При желании разверните из локального терминала:

npm run deploy

Эндпоинты:

GET  /health
MCP  /mcp

Архитектура

Текущий производственный путь:

ChatGPT Skill
    ↓
Cloudflare Workers /mcp
    ↓
Bilibili metadata/player/subtitle APIs
    ↓
structured multi-P metadata + timestamped subtitles

Старая Python-реализация в server/ остаётся в репозитории только как справочная/устаревшая; Cloudflare её не использует.

Текущий объём

v2.1 фокусируется на метаданных нескольких P + официальных/ИИ-субтитрах. Он пока не скачивает аудио/видео, не запускает Whisper ASR и не распознаёт исходный код из кадров видео. Это запланировано только после того, как путь с субтитрами будет проверен от начала до конца.