AI导哈

TikTok视频搜索服务

一个用于TikTok视频发现和元数据提取的模型上下文协议服务，提供通过标签搜索视频和获取热门内容的功能，内置反检测措施和错误处理。

  • by terrylinhaochen
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 terrylinhaochen/tiktok_mcp

使用说明

TikTok MCP服务

用于TikTok视频发现和元数据提取的模型上下文协议服务。该服务提供了一个强大的界面，用于通过标签搜索TikTok视频和检索趋势内容，并内置了反检测措施和错误处理。

特性

  • 按标签搜索视频
  • 每次搜索可配置的视频计数（默认值：30）
  • 反机器人检测措施
  • 代理支持
  • 自动API会话管理
  • 速率限制和错误处理
  • 健康状态监测

配置

该服务使用环境变量进行配置。创建一个 .env 文件包含：

ms_token=your_tiktok_ms_token  # Optional but recommended to avoid bot detection
TIKTOK_PROXY=your_proxy_url    # Optional proxy configuration

安装和设置

通过Smithery安装

通过以下方式自动安装TikTok Video Search for Claude Desktop 史密瑟里:

npx -y @smithery/cli install @terrylinhaochen/tiktok_mcp --client claude

手动安装

# Install dependencies
poetry install

# Install browser automation dependencies
poetry run python -m playwright install

# Start the service
poetry run python -m tiktok_mcp_service.main

Claude桌面集成

一旦您的服务开始运行，您就可以将其与Claude Desktop集成。由于我们使用Poetry进行依赖关系管理，请确保通过Poetry运行MCP CLI命令：

# Navigate to the project directory
cd /path/to/tiktok-mcp-service

# Install the service in Claude Desktop with Poetry in editable mode
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env

# Optional: Install with a custom name
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok Video Search" --with-editable . -f .env

安装后，该服务将在Claude Desktop中可用，并将使用Poetry进行适当的依赖关系管理。

API终点

健康检查

  • GET /health -检查服务运行状况和API初始化状态
    {
  "status": "running",
  "api_initialized": true,
  "service": {
    "name": "TikTok MCP Service",
    "version": "0.1.0",
    "description": "A Model Context Protocol service for searching TikTok videos"
  }
}

搜索视频

  • POST /search -搜索带有标签的视频
    {
  "search_terms": ["python", "coding"],
  "count": 30  // Optional, defaults to 30
}
    响应包括视频URL、描述和参与统计数据（视图、点赞、分享、评论）。

资源管理

  • POST /cleanup -清理资源和API会话

错误处理

该服务包括以下全面的错误处理：

  • API初始化失败
  • 机器人检测问题
  • 网络错误
  • 速率限制
  • 无效的搜索词

发展

内置：

  • 蒂克托卡比
  • FastMCP
  • 依赖管理诗
  • 浏览器自动化剧作家

许可证

麻省理工学院#tiktok_mcp

TikTok API限制

重要通知： TikTok实施了严格的防刮措施，限制API访问。 因此，此服务提供以下功能：

  1. 模拟数据模式：当TikTok阻止API访问时（目前是这种情况），服务 提供与搜索词相关的逼真的模拟结果。这确保了 即使TikTok限制访问，您的Claude集成也会继续运行。

  2. API访问尝试：该服务仍试图首先使用TikTok API，但会很快 如果API不可用或返回错误，则回退到模拟数据。

  3. 透明度：当提供模拟数据时，这在响应中通过 transformations 字段，其中包括一个注释，解释正在显示模拟结果。

尽管TikTok采取了反抓取措施，但这一实施确保了您的服务仍能正常运行。

相关 MCP