Tiktok Ads MCP Server

🚀 TikTok Ads MCP Server

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認証サポート