TikTok MCP Service

TikTok MCPサービス

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

特徴

• ハッシュタグで動画を検索する
• 検索ごとに設定可能なビデオ数（デフォルト: 30）
• ボット対策
• プロキシサポート
• 自動APIセッション管理
• レート制限とエラー処理
• 健康状態のモニタリング

構成

このサービスは設定に環境変数を使用します。以下の内容で.envファイルを作成してください。

インストールとセットアップ

クロードデスクトップ統合

サービスが起動したら、Claude Desktop と統合できます。依存関係の管理には Poetry を使用しているため、MCP CLI コマンドは必ず Poetry 経由で実行してください。

インストール後、サービスは 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

ライセンス

マサチューセッツ工科大学