TikTok MCPサービス

TikTok動画の発見とメタデータ抽出のためのモデルコンテキストプロトコルサービス。このサービスは、ハッシュタグによるTikTok動画の検索やトレンドコンテンツ取得のための堅牢なインターフェースを提供し、検出対策とエラー処理が組み込まれています。

特徴

• ハッシュタグで動画を検索する

• 検索ごとに設定可能なビデオ数（デフォルト: 30）

• ボット対策

• プロキシサポート

• 自動APIセッション管理

• レート制限とエラー処理

• 健康状態のモニタリング

Related MCP server: rednote-agent

構成

このサービスは設定に環境変数を使用します。以下の内容で.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 Desktop と統合できます。依存関係の管理には Poetry を使用しているため、MCP CLI コマンドは必ず Poetry 経由で実行してください。

# 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初期化の失敗

• ボット検出の問題

• ネットワークエラー

• レート制限

• 無効な検索用語

発達

搭載コンポーネント:

• TikTokアプリ

• ファストMCP

• 依存管理のための詩

• ブラウザ自動化のためのPlaywright

ライセンス

MIT# tiktok_mcp

TikTok APIの制限

重要なお知らせ： TikTokはAPIアクセスを制限する厳格なスクレイピング対策を実施しています。そのため、本サービスは以下の機能を提供します。

1. モックデータモード：TikTokがAPIアクセスをブロックしている場合（現在ブロックされています）、検索語句に関連する、リアルなシミュレーション結果が表示されます。これにより、TikTokがアクセスを制限している場合でも、Claudeとの連携が継続して機能します。

2. API アクセス試行: サービスは引き続き最初に TikTok API の使用を試行しますが、API が利用できないかエラーが返された場合はすぐに模擬データにフォールバックします。

3. 透明性: モック データが提供されると、 transformationsフィールドを介して応答に明確に示され、シミュレートされた結果が表示されていることを示すメモが含まれます。

この実装により、TikTok のスクレイピング防止対策にもかかわらず、サービスが引き続き稼働することが保証されます。