Metadata-Version: 2.4
Name: bilibili-subtitle-fetch
Version: 0.1.3
Summary: An MCP (Model Context Protocol) server that allows you to fetch subtitles for Bilibili videos.
Author: Initsnow
License: GPLv3
License-File: LICENSE
Keywords: automation,http,llm,mcp
Requires-Python: >=3.13
Requires-Dist: bilibili-api-python>=17.1.4
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.6.0
Description-Content-Type: text/markdown

# Bilibili Subtitle Fetch

MCP server for fetching Bilibili video subtitles with language and format options.

## Quick Start

1. Install dependencies:

```bash
uvx bilibili-subtitle-fetch
```

or use

```bash
pip install bilibili-subtitle-fetch
```

2. Set required environment variables:

```bash
export BILIBILI_SESSDATA=your_sessdata
export BILIBILI_BILI_JCT=your_jct 
export BILIBILI_BUVID3=your_buvid3
```

3. Run the server with optional parameters:

```bash
bilibili-subtitle-fetch --preferred-lang zh-CN --output-format text
```

## Configuration

### Environment Variables

- `BILIBILI_SESSDATA`, `BILIBILI_BILI_JCT`, `BILIBILI_BUVID3` - Required Bilibili credentials
- `BILIBILI_PREFERRED_LANG` - Default subtitle language (default: zh-CN)
- `BILIBILI_OUTPUT_FORMAT` - Subtitle format (text/timestamped, default: text)

### CLI Arguments

- `--preferred-lang` - Override default subtitle language
- `--output-format` - Override output format

## MCP Tool Usage

```json
{
  "tool_name": "get_bilibili_subtitle",
  "arguments": {
    "url": "bilibili_video_url",
    "preferred_lang": "optional_lang_code", 
    "output_format": "text|timestamped"
  }
}
```

[Get Bilibili credentials](https://nemo2011.github.io/bilibili-api/#/get-credential.md)
