Tiktok Video Discovery

🚀 TikTok MCP 服務

TikTok MCP 服務是一個用於視頻發現和元數據提取的模型上下文協議服務。它提供強大接口，支持通過標籤搜索 TikTok 視頻並提取流行內容，還內置了反檢測措施和錯誤處理機制，為用戶提供穩定、高效的使用體驗。

🚀 快速開始

本服務可通過標籤搜索 TikTok 視頻，並提取流行內容。使用前，需完成配置和安裝設置，之後便可集成到 Claude Desktop 中使用。

✨ 主要特性

• 視頻搜索：支持使用標籤搜索視頻，且每次搜索可配置視頻數量（默認 30 條）。
• 反檢測機制：具備反機器人檢測措施，還支持代理配置。
• 自動化管理：擁有自動 API 會話管理功能，能進行速率限制和錯誤處理。
• 狀態監控：提供健康狀態監控，方便了解服務運行情況。

📦 安裝指南

配置環境變量

服務使用環境變量進行配置。創建一個.env文件，內容如下：

ms_token=your_tiktok_ms_token  # 可選但推薦以避免反機器人檢測
TIKTOK_PROXY=your_proxy_url    # 可選代理配置

安裝依賴項

# 安裝依賴項
poetry install

# 安裝瀏覽器自動化依賴項
poetry run python -m playwright install

# 啟動服務
poetry run python -m tiktok_mcp_service.main

💻 使用示例

與 Claude Desktop 集成

一旦服務運行，您可以將其集成到 Claude Desktop 中。由於我們使用 Poetry 進行依賴管理，請確保通過 Poetry 執行 MCP CLI 命令：

# 切換到項目目錄
cd /path/to/tiktok-mcp-service

# 使用可編輯模式安裝服務到 Claude Desktop
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env

# 可選：使用自定義名稱安裝
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok 視頻搜索" --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  // 可選，默認為 30
  }
  

  響應包括視頻 URL、描述和互動統計數據（播放量、點贊、分享、評論）。

資源管理

• POST /cleanup - 清理資源和 API 會話

錯誤處理

服務包含全面的錯誤處理，針對以下情況：

• API 初始化失敗
• 反機器人檢測問題
• 網絡錯誤
• 速率限制
• 無效搜索詞

🔧 技術細節

本服務使用以下技術進行開發：

• TikTokApi：用於與 TikTok 進行交互。
• FastMCP：提供核心的模型上下文協議功能。
• Poetry：進行依賴管理，確保項目依賴的一致性和可重複性。
• Playwright：進行瀏覽器自動化，支持服務的自動化操作。

📄 許可證

本項目採用 MIT 許可證。