Crowdlistening

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

ライセンス

MIT# tiktok_mcp

TikTok APIの制限

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

1. モックデータモード：TikTokがAPIアクセスをブロックしている場合（現在ブロックされています）、検索語句に関連する、リアルなシミュレーション結果が表示されます。これにより、TikTokがアクセスを制限している場合でも、Claudeとの連携が継続して機能します。
2. API アクセス試行: サービスは引き続き最初に TikTok API の使用を試行しますが、API が利用できないかエラーが返された場合はすぐに模擬データにフォールバックします。
3. 透明性: モック データが提供されると、 transformationsフィールドを介して応答に明確に示され、シミュレートされた結果が表示されていることを示すメモが含まれます。

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