Bilibili Video Reader v2.1

ChatGPT/Codex용 읽기 전용 플러그인으로, Skill + 무상태 MCP server 형태로 구축되었으며, 이제 Cloudflare Workers를 대상으로 하여 Render나 신용카드 없이 실행할 수 있습니다.

MCP 도구

• get_bilibili_video_parts(url) — 제목, 작성자, 설명, 모든 P 번호와 CID.

• get_bilibili_part_transcript(url, part, language, max_chars) — 한 P에 대한 공식/AI 자막 트랙과 타임스탬프가 포함된 트랜스크립트.

Worker는 Bilibili의 메타데이터/플레이어/자막 엔드포인트를 직접 호출합니다. 자막 모드에서는 동영상 다운로드가 필요하지 않습니다.

Cloudflare Workers에 배포

대시보드 경로

1. Cloudflare 계정을 만들거나 로그인합니다.

2. Workers & Pages → 만들기 → 저장소 가져오기로 이동합니다(표기는 약간 다를 수 있습니다).

3. GitHub를 연결하고 limuzi23/bilibili-video-reader-mcp를 선택합니다.

4. 저장소 루트를 루트 디렉터리로 유지합니다.

5. Cloudflare가 wrangler.jsonc를 자동으로 감지해야 합니다.

6. 기본 배포 명령어를 사용합니다: npx wrangler deploy.

7. 배포합니다.

Worker 이름은 wrangler.jsonc와 일치하므로 반드시 bilibili-video-reader-mcp로 유지해야 합니다.

배포 후 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는 BILI_COOKIE라는 선택적 Cloudflare 시크릿을 읽을 수 있습니다. 이 값은 Cloudflare의 암호화된 Variables and Secrets UI에서만 구성하세요. 절대 쿠키 원문을 ChatGPT에 붙여넣거나 GitHub에 커밋하지 마세요.

ChatGPT에 연결

1. ChatGPT → 설정 → 보안 및 로그인 → 개발자 모드를 활성화합니다.

2. 플러그인을 열고 +를 누른 다음, /mcp로 끝나는 배포된 URL을 등록합니다.

3. 생성된 연결에서 기술 ID를 복사합니다. 이 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

이전 server/ Python 구현은 저장소에 참조용/레거시 구현으로만 남아 있으며, Cloudflare는 이를 사용하지 않습니다.

현재 범위

v2.1은 멀티-P 메타데이터 + 공식/AI 자막에 중점을 둡니다. 아직 오디오/비디오를 다운로드하거나, Whisper ASR을 실행하거나, 비디오 프레임에서 소스 코드를 OCR하지 않습니다. 이러한 기능은 이 자막 경로가 엔드투엔드로 검증된 후에만 계획되어 있습니다.