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 のスクレイピング防止対策にもかかわらず、サービスが引き続き稼働することが保証されます。