Tiktok Ads MCP Server

🚀 TikTok Ads MCP サーバー

TikTok Ads API 統合用のモデルコンテキストプロトコル (MCP) サーバーです。このサーバーにより、Claude などのAIアシスタントがTikTokの広告キャンペーンとやり取りでき、包括的なキャンペーン管理、分析、最適化機能を提供します。

AdsMCP プロジェクトの一部 - 広告プラットフォーム用のMCPサーバーです。

✨ 主な機能

• キャンペーン管理：キャンペーンと広告グループの作成、読み取り、更新
• パフォーマンス分析：詳細なパフォーマンス指標と洞察の取得
• オーディエンス管理：カスタムオーディエンスとターゲティングオプションの処理
• クリエイティブ管理：広告クリエイティブのアップロードと管理
• レポート作成：カスタムパフォーマンスレポートの生成とダウンロード

📦 インストール

前提条件

• Python 3.10 以上
• APIアクセス権を持つ TikTok For Business アカウント
• TikTok Ads 開発者アカウントとアプリの登録

ローカルインストール

# リポジトリをクローンする
git clone <repository-url>
cd adsmcp-server

# 仮想環境を作成する
python -m venv venv
source venv/bin/activate  # Windowsの場合: venv\Scripts\activate

# 依存関係をインストールする
pip install -e .

uvを使用する (推奨)

# uvでインストールする
uv sync

📚 ドキュメント

MCPクライアントの設定

MCPクライアントの設定 (例: Claude Desktop) に追加します。

{
  "mcpServers": {
    "tiktok-ads": {
      "command": "python",
      "args": ["/path/to/adsmcp-server/run_server.py"],
      "cwd": "/path/to/adsmcp-server",
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

利用可能なツール

認証

• tiktok_ads_login - TikTok AdsのOAuth認証フローを開始する
• tiktok_ads_complete_auth - 認証コードでOAuth認証を完了する
• tiktok_ads_auth_status - 現在の認証ステータスを確認する
• tiktok_ads_switch_ad_account - 別の広告主アカウントに切り替える

キャンペーン管理

• tiktok_ads_get_campaigns - 広告主アカウントのすべてのキャンペーンを取得する
• tiktok_ads_get_campaign_details - 特定のキャンペーンの詳細情報を取得する
• tiktok_ads_get_adgroups - キャンペーンの広告グループを取得する

パフォーマンスと分析

• tiktok_ads_get_campaign_performance - 詳細な指標をサポートするキャンペーンのパフォーマンス指標を取得する
• tiktok_ads_get_adgroup_performance - 内訳付きの広告グループのパフォーマンス指標を取得する

認証

TikTok Ads APIのセットアップ

1. 開発者として登録する
   • TikTok For Business Developer Portal にアクセスする
   • 開発者アカウントを作成する
   • アプリケーションを登録する
2. API資格情報を取得する
   • 登録したアプリからApp IDとApp Secretを取得する
   • OAuthフローを通じてアクセストークンを生成する
   • 広告主IDをメモする
3. OAuthフロー (本番環境用)
   • ユーザー認証のためのOAuth 2.0フローを実装する
   • トークンの自動更新を処理する
   • トークンを安全に保存する

🔧 技術詳細

セキュリティのベストプラクティス

• API資格情報をバージョン管理にコミットしないでください
• 機密データには環境変数を使用する
• 適切なトークンローテーションを実装する
• APIの使用状況とレート制限を監視する
• すべての通信にHTTPSを使用する

APIレート制限

TikTok Ads APIには以下の制限があります。

• アプリごとに1時間あたり1000リクエスト
• 同時に10リクエスト
• 特定のエンドポイントには制限が適用される場合があります

サーバーには組み込みのレート制限とリトライロジックが含まれています。

エラーハンドリング

サーバーは包括的なエラーハンドリングを提供します。

• APIレート制限管理
• トークンの有効期限切れの処理
• ネットワーク接続問題
• 無効なパラメータの検証

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。

サポート

問題や質問がある場合は、このリポジトリにイシューを作成してください。

変更履歴

v0.1.0 (初期リリース)

• 基本的なTikTok Ads API統合
• キャンペーンと広告グループの管理
• パフォーマンスレポート
• OAuth認証サポート