semvec/pypi-packages huggingface dataset:
douyin-scanner-mcp 0.1.3
MCP client for Douyin Scanner with integrated scanning capabilities
License: MIT
Requires Python: >=3.8

# Douyin Scanner MCP

抖音账号扫描 MCP 客户端，集成了账号数据扫描功能，**不再需要单独的 HTTP 服务器**。

## 功能特点

- 基于 Playwright 的浏览器自动化，支持抖音账号数据扫描
- 无需额外配置和启动 HTTP 服务器
- 支持 MCP 标准通信协议
- 缓存扫描结果，提高效率
- **新增：URL标准化功能，自动处理和标准化用户输入的抖音链接**

## 安装

### 开发模式安装

```bash
# 克隆仓库
git clone https://your-repository-url/douyin-scanner.git
cd douyin-scanner/account_scan/client

# 安装依赖
pip install -e .

# 初始化 Playwright (首次安装需要)
playwright install
```

### 从 PyPI 安装 (一旦发布)

```bash
pip install douyin-scanner-mcp==0.1.2

# 初始化 Playwright (首次安装需要)
playwright install
```

## 使用方法

### 作为 Cursor MCP 工具使用

在 Cursor 的 MCP 配置文件中添加以下配置：

```json
{
  "mcpServers": {
    "douyin-scanner": {
      "command": "uvx",
      "args": [
        "douyin-scanner-mcp"
      ],
      "env": {
        "BROWSER_TYPE": "chromium",
        "BROWSER_HEADLESS": "1"
      }
    }
  }
}
```

环境变量配置说明：

| 环境变量 | 说明 | 默认值 |
|---------|------|-------|
| BROWSER_TYPE | 浏览器类型 (chromium, firefox, webkit) | chromium |
| BROWSER_HEADLESS | 无头模式 (1: 启用, 0: 禁用) | 1 |
| BROWSER_TIMEOUT | 浏览器超时时间 (毫秒) | 60000 |
| DOUYIN_SCAN_MAX_VIDEOS | 最大扫描视频数 | 100 |
| CONCURRENT_LIMIT | 并发扫描限制 | 3 |
| LOG_LEVEL | 日志级别 | INFO |

### 命令行使用

```bash
# 使用 stdio 通信方式运行
douyin-scanner-mcp

# 使用其他通信方式
douyin-scanner-mcp --transport tcp --host 127.0.0.1 --port 9000

# 启用调试模式
douyin-scanner-mcp --debug
```

## 工具列表

该 MCP 客户端提供以下工具：

1. `scan_douyin_account` - 扫描单个抖音账号
2. `scan_multiple_accounts` - 批量扫描多个抖音账号
3. `get_server_info` - 获取服务信息
4. `get_last_result` - 获取最后一次扫描结果
5. **`normalize_douyin_url` - 新增的URL标准化功能**

## 发布到 PyPI

1. 更新版本号 `__version__` in `douyin_scanner_mcp/__init__.py`
2. 构建包：
```bash
python -m build
```
3. 上传到 PyPI：
```bash
python -m twine upload dist/*
```

## 贡献

欢迎提交 Issue 和 Pull Request。

## 许可证

MIT 

## 配置文件

在 `mcp.json` 中添加以下配置以启用 TOTP 验证：

```json
{
  "totp_key": "YOUR_TOTP_KEY_HERE",
  "app_identifier": "DouyinScanner"
}
```

确保 `totp_key` 是通过 `generate_totp_key.py` 生成的，并且 `app_identifier` 与应用程序中使用的标识符匹配。