Tiktok Video Discovery

🚀 TikTok MCP サービス

TikTokのビデオ発見とメタデータ抽出を行うモデルコンテキストプロトコル（Model Context Protocol）サービスです。このサービスは、タグを使ってTikTokビデオを検索し、人気コンテンツを抽出する強力なインターフェースを提供し、組み込みの反検知対策とエラー処理機能を備えています。

🚀 クイックスタート

このTikTok MCPサービスを利用することで、TikTokのビデオをタグで検索し、メタデータを抽出することができます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• タグを使用したビデオ検索
• 1回の検索で取得するビデオ数を設定可能（デフォルト: 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を使用して依存関係を管理しているため、MCP CLIコマンドはPoetry経由で実行してください。

# プロジェクトディレクトリに移動
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
• FastMCP
• 依存関係管理にPoetry
• ブラウザ自動化にPlaywright

📄 ライセンス

MIT