Metadata-Version: 2.3
Name: bilibili-game-review-analyzer
Version: 0.1.1
Summary: B站游戏评论分析工具
Author: WZJ
Author-email: WZJ <1298683025@qq.com>
Requires-Dist: bilibili-api-python>=17.4.2
Requires-Dist: httpx>=0.28.1
Requires-Dist: langchain-qwq>=0.3.5
Requires-Dist: mcp[cli]>=2.0.0
Requires-Dist: python-dotenv>=1.2.2
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# Bilibili Game Review Analyzer

一个基于 FastMCP 框架的 B 站视频分析服务，支持搜索视频、获取视频播放地址以及概括视频内容。

## 功能特性

本项目提供以下三个 MCP 工具：

1. **get_video_results** - 根据关键词搜索相关视频，返回视频标题和 BV 号
2. **extract_videos_url** - 根据关键词获取视频的播放地址
3. **get_video_summary_tool** - 根据关键词搜索视频并概括视频内容

## 技术栈

- Python 3.14+
- FastMCP - MCP 服务器框架
- [bilibili-api-python](https://github.com/Nemo2011/bilibili-api) - B 站 API 客户端
- LangChain + Qwen - 视频内容概括

## 环境要求

- Python >= 3.14
- uv 包管理器

## 安装步骤

1. **克隆项目**

```bash
git clone <repository-url>
cd bilibili-game-review-analyzer
```

2. **使用 uv 安装依赖**

```bash
uv sync
```

## 环境变量配置

在项目根目录创建 `.env` 文件，配置以下环境变量：

```env
API_KEY=your_api_key_here
BASE_URL=your_api_base_url_here
MODEL=your_model_name_here
```

| 变量名 | 说明 |
|--------|------|
| API_KEY | Qwen 模型的 API 密钥 |
| BASE_URL | Qwen 模型的 API 基础地址 |
| MODEL | 模型名称 |

## 使用方式

启动 MCP 服务器：

```bash
uv run python BilibiliGameReviewAnalyzer.py
```

服务器使用 stdio 传输协议运行，可与支持 MCP 标准的客户端（如 Claude Desktop、Cursor 等）集成。

## 工具说明

### get_video_results

根据关键词搜索相关的视频，返回视频标题和 BV 号。

**参数**：
- `keyword`: 搜索关键词
- `limit`: 返回结果数量限制，默认为 1

**返回**：视频列表，每个元素包含视频标题、BV 号

### extract_videos_url

根据关键词获取视频的播放地址。

**参数**：
- `keyword`: 视频关键词
- `limit`: 最大返回视频数量，默认 1

**返回**：视频播放地址列表，每个元素包含视频的标题、BV 号、cid、视频播放地址

### get_video_summary_tool

根据关键词搜索相关的视频并概括视频内容。

**参数**：
- `keyword`: 视频关键词
- `limit`: 最大返回视频内容数量，默认 1

**返回**：视频的概括内容列表

## 免责声明

- **本项目仅供个人学习研究使用，请勿用于商业用途。**
- 本项目非 B 站官方产品，与哔哩哔哩公司无任何关联。
- 本项目使用的第三方库 [bilibili-api-python](https://github.com/Nemo2011/bilibili-api) 为开源项目，非 B 站官方提供的 API。
- 通过本项目获取的视频内容版权归原作者所有，未经授权不得转载或商用。
- 使用本项目时请严格遵守 B 站用户协议及相关法律法规，使用者需自行承担因使用本项目而产生的一切风险和责任。
- 本项目不对第三方库的合法性、稳定性及安全性做任何担保。

## 许可证

本项目使用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。