PropellerAds MCPサーバー

AIによるプログラマティック広告の民主化

ClaudeのようなAIアシスタントに、PropellerAdsの広告キャンペーンを自動管理させましょう。

クイックスタート • 利用可能なツール • 使用例 • MCP設定

これは何ですか？

PropellerAds MCPは、AIアシスタント（ClaudeおよびMCP互換クライアント）をPropellerAds広告プラットフォームAPIに直接接続するModel Context Protocolサーバーです。手動でダッシュボードにログインしたり、レポートを抽出したり、設定画面をクリックして回ったりする必要はありません。AIアシスタントに自然な日本語で話しかけるだけで、すべてを処理してくれます。

キャンペーンの作成、パフォーマンス分析、パフォーマンスの低いゾーンのブラックリスト登録、スケーリングの機会の発見、期間比較など、すべて自然な会話を通じて行えます。

対象ユーザー:

• メディアバイヤーおよびパフォーマンスマーケター

• iGamingおよびアプリインストールのアフィリエイト

• グロースハッカーおよびデジタルエージェンシー

• PropellerAdsキャンペーンを運用し、効率化したいすべての方

機能

• キャンペーンの全ライフサイクル管理 -- チャットを離れることなく、キャンペーンの作成、更新、開始、停止、複製が可能

• リアルタイムのパフォーマンス分析 -- インプレッション、クリック、コンバージョン、CTR、CVR、CPC、CPA、ROIを自動計算

• 期間比較 -- 任意の2つの期間をトレンド指標とともに並べて比較

• ゾーンレベルの最適化 -- 予算を浪費しているパフォーマンスの低いゾーンを特定し、ホワイトリストに登録すべき優良ゾーンを発見

• 自動ブラックリスト登録 -- コマンド1つで不正なゾーンを特定し、ブラックリストに登録（ドライラン安全モード付き）

• スケーリングのインテリジェンス -- 高いROIとコンバージョン数を持ち、スケーリング準備が整ったキャンペーンを自動的に発見

• クリエイティブのパフォーマンス分析 -- どのクリエイティブが成果を上げ、どれを差し替えるべきかを把握

• セキュアな設計 -- APIトークンは環境変数に保存され、会話中に露出することはありません

• ドライラン（テスト実行）の安全性 -- 破壊的な操作は、実行前にプレビューモードで確認可能

利用可能なツール

キャンペーン管理

list_campaignsのフィルタ: status (active/paused/pending/rejected), ad_format (push/onclick/interstitial/in-page-push), name (部分一致)

統計・分析

一般的なオプションパラメータ: date_from, date_to (YYYY-MM-DD, デフォルトは過去7日間), campaign_id, group_by (date/campaign/zone/country/creative/device_type/browser/os)

最適化

ターゲティング

アカウント

技術スタック

クイックスタート

前提条件

1. APIアクセス権を持つPropellerAdsアカウント

   • 最低条件: 総利用額またはデポジットが$1,000以上

   • APIトークンの取得: https://ssp.propellerads.com/#/app/profile

2. Python 3.10+

3. Claude Desktop または Claude Code (またはMCP互換クライアント)

インストール

オプション1: PyPIからインストール（推奨）

pip install propellerads-mcp

オプション2: ソースからインストール

git clone https://github.com/JanNafta/propellerads-mcp.git
cd propellerads-mcp
pip install -e .

APIトークンの設定

プロジェクトルートに.envファイルを作成するか、環境変数をエクスポートしてください：

export PROPELLERADS_API_TOKEN="your_api_token_here"

使用例

キャンペーン管理

"Show me all my active campaigns sorted by ROI"

"Create a push campaign for gaming offers in Brazil with $100 daily budget"

"Pause all campaigns with negative ROI in the last 7 days"

"Clone my best performing campaign to Mexico, Colombia, and Peru"

パフォーマンス分析

"What's my campaign performance for the last week?"

"Compare this week's performance vs last week"

"Show me the top 10 zones by conversions for campaign 12345"

"Which creatives have CTR below 0.5%?"

最適化ワークフロー

"Find all zones spending over $50 without conversions and blacklist them"

"Show me campaigns ready for scaling -- ROI above 50% with at least 10 conversions"

"Find top performing zones for my dating campaigns and add them to a whitelist"

日次最適化ルーチン

1. "Show me yesterday's performance for all campaigns"
2. "Find and blacklist underperforming zones across all campaigns"
3. "Which campaigns are ready for scaling?"
4. "Increase budget by 50% for profitable campaigns"

MCP設定

Claude Desktop

Claude Desktopの設定ファイルに追加してください：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "propellerads": {
      "command": "python",
      "args": ["-m", "propellerads_mcp"],
      "env": {
        "PROPELLERADS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

設定を保存した後、Claude Desktopを再起動してください。

Claude Code

CLIを使用してClaude CodeにMCPサーバーを追加します：

claude mcp add propellerads -- python -m propellerads_mcp

Claude Codeを起動する前に、シェル環境でPROPELLERADS_API_TOKENが設定されていることを確認してください。

その他のMCPクライアント

このサーバーは、標準的なMCP通信方式であるstdioトランスポートを使用します。MCP互換クライアントは、プロセスを起動することで接続できます：

python -m propellerads_mcp

サーバーは環境変数からPROPELLERADS_API_TOKENを読み取ります。MCPクライアントのenv設定で渡すか、シェルで設定してください。

プロジェクト構造

propellerads-mcp/
├── src/
│   └── propellerads_mcp/
│       ├── __init__.py       # Package init, version, exports
│       ├── __main__.py       # Module entry point (python -m)
│       ├── client.py         # PropellerAds API client (httpx-based)
│       └── server.py         # MCP server, tool definitions & handlers
├── .env.example              # Environment variable template
├── .gitignore
├── LICENSE                   # MIT License
├── pyproject.toml            # Build config, dependencies, metadata
└── README.md

セキュリティと権限

貢献

貢献を歓迎します！以下の手順で協力いただけます：

1. リポジトリをフォーク

2. フィーチャーブランチを作成 (git checkout -b feature/my-feature)

3. 変更をコミット (git commit -m "Add my feature")

4. ブランチにプッシュ (git push origin feature/my-feature)

5. プルリクエストをオープン

バグ報告や機能リクエストは、issueを作成してください。

作者

Jan Naftanaila -- メディアバイヤー兼AI自動化スペシャリスト

AIとプログラマティック広告の架け橋となるツールを開発。アドテクをより身近で、自動化された、インテリジェントなものにすることに注力しています。

ライセンス

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

PropellerAds MCP -- オープンソース。プログラマティック広告コミュニティのために構築されました。