AI导哈

TikTok视频搜索服务

一个用于TikTok视频发现和元数据提取的模型上下文协议服务，提供按标签搜索视频和获取热门内容的功能。

  • by yap-audio
  • Python
  • 本地部署
  • 77 星标
  • 更新于
在 GitHub 查看 yap-audio/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

安装和设置

# 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
  • 依赖管理诗
  • 浏览器自动化剧作家

许可证

麻省理工学院

相关 MCP