Bilibili Video Reader v2.1

Un plugin de solo lectura para ChatGPT/Codex creado como Skill + servidor MCP sin estado, ahora orientado a Cloudflare Workers para que pueda ejecutarse sin Render ni tarjeta de crédito.

Herramientas MCP

• get_bilibili_video_parts(url) — título, autor, descripción, todos los números de P y CIDs.

• get_bilibili_part_transcript(url, part, language, max_chars) — pistas de subtítulos oficiales/IA y transcripción con marcas de tiempo para una P.

El Worker llama directamente a los endpoints de metadatos/reproductor/subtítulos de Bilibili. Para el modo de subtítulos no es necesario descargar el vídeo.

Despliegue en Cloudflare Workers

Ruta del panel

1. Crea o inicia sesión en una cuenta de Cloudflare.

2. Abre Workers & Pages → Crear → Importar un repositorio (la redacción puede variar ligeramente).

3. Conecta GitHub y selecciona limuzi23/bilibili-video-reader-mcp.

4. Mantén la raíz del repositorio como directorio raíz.

5. Cloudflare debería detectar wrangler.jsonc automáticamente.

6. Usa el comando de despliegue predeterminado: npx wrangler deploy.

7. Despliega.

El nombre del Worker debe seguir siendo bilibili-video-reader-mcp porque coincide con wrangler.jsonc.

Tras el despliegue, Cloudflare te dará una URL similar a:

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

Comprobación de estado:

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

Endpoint MCP:

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

Para subtítulos públicos, no se requiere ningún secreto en tiempo de ejecución.

Estado de inicio de sesión privado opcional

Si un subtítulo solo es visible con la sesión iniciada, el Worker puede leer un secreto opcional de Cloudflare llamado BILI_COOKIE. Configúralo únicamente dentro de la interfaz cifrada Variables and Secrets de Cloudflare. Nunca pegues cookies en bruto en ChatGPT ni las confirmes en GitHub.

Conectar con ChatGPT

1. ChatGPT → Configuración → Seguridad e inicio de sesión → activa el modo desarrollador.

2. Abre Plugins, pulsa + y registra la URL desplegada que termina en /mcp.

3. Copia el ID técnico de la conexión creada. Empieza por plugin_asdk_app_.

4. Ejecuta python scripts/configure_plugin.py plugin_asdk_app_YOUR_ID si el flujo de empaquetado del plugin requiere una referencia de aplicación.

El manifiesto del plugin de OpenAI se encuentra en .codex-plugin/plugin.json y la Skill del flujo de trabajo está en skills/bilibili-video-reader/.

Desarrollo local

npm install
npm run dev

Despliega desde una terminal local si lo deseas:

npm run deploy

Endpoints:

GET  /health
MCP  /mcp

Arquitectura

La ruta de producción actual es:

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

La antigua implementación en Python de server/ permanece en el repositorio solo como implementación de referencia/legado; Cloudflare no la utiliza.

Alcance actual

v2.1 se centra en metadatos multi-P + subtítulos oficiales/IA. Todavía no descarga audio/vídeo, no ejecuta Whisper ASR ni realiza OCR del código fuente de los fotogramas del vídeo. Eso está planificado solo después de que esta ruta de subtítulos se verifique de extremo a extremo.