Douyin Scanner MCP

抖音账号扫描 MCP 客户端，集成了账号数据扫描功能，不再需要单独的 HTTP 服务器。

功能特点

• 基于 Playwright 的浏览器自动化，支持抖音账号数据扫描
• 无需额外配置和启动 HTTP 服务器
• 支持 MCP 标准通信协议
• 缓存扫描结果，提高效率
• 新增：URL标准化功能，自动处理和标准化用户输入的抖音链接

安装

开发模式安装

# 克隆仓库
git clone https://your-repository-url/douyin-scanner.git
cd douyin-scanner/account_scan/client

# 安装依赖
pip install -e .

# 初始化 Playwright (首次安装需要)
playwright install

从 PyPI 安装 (一旦发布)

pip install douyin-scanner-mcp==0.1.2

# 初始化 Playwright (首次安装需要)
playwright install

使用方法

作为 Cursor MCP 工具使用

在 Cursor 的 MCP 配置文件中添加以下配置：

{
  "mcpServers": {
    "douyin-scanner": {
      "command": "uvx",
      "args": [
        "douyin-scanner-mcp"
      ],
      "env": {
        "BROWSER_TYPE": "chromium",
        "BROWSER_HEADLESS": "1"
      }
    }
  }
}

环境变量配置说明：

命令行使用

# 使用 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. 构建包：

python -m build

3. 上传到 PyPI：

python -m twine upload dist/*

贡献

欢迎提交 Issue 和 Pull Request。

许可证

MIT

配置文件

在 mcp.json 中添加以下配置以启用 TOTP 验证：

{
  "totp_key": "YOUR_TOTP_KEY_HERE",
  "app_identifier": "DouyinScanner"
}

确保 totp_key 是通过 generate_totp_key.py 生成的，并且 app_identifier 与应用程序中使用的标识符匹配。