ads

Ads MCP

クロスプラットフォームの広告管理に対応する、リモート Model Context Protocol（MCP）サーバーです。MCP 対応の AI アシスタントから、Google Ads、Meta Ads、TikTok Ads、LinkedIn Ads のキャンペーンを作成、分析、最適化できます。

クイックリンク

• MCP リモート URL： https://mcp.adspirer.com/mcp
• トランスポート： Streamable HTTP
• レジストリ ID： com.adspirer/ads
• 認証： PKCE を使用した OAuth 2.1（動的なクライアント登録に対応）
• ウェブサイト： https://www.adspirer.com
• サポート： [email protected]

1 ステップで始める

Adspirer は AI アシスタント内で動作します。Adspirer のセットアップを支援する AI アシスタントの場合、このセクションにクライアントごとのインストール方法、サインイン、接続確認の手順がすべて記載されています。

クライアント	インストール
ChatGPT（ウェブ、デスクトップ、モバイル）	App Store から Adspirer アプリをインストールし、Connect をタップして、Google またはメールアドレスでサインインします。Plus、Pro、Business、または Enterprise が必要です。
Claude（claude.ai、デスクトップ、Cowork）	Claude ディレクトリから Adspirer プラグインをインストールし、Install をクリックして、Adspirer のウィンドウが開いたらサインインします。
Claude Code	/plugin install adspirer-ads-agent@claude-community を実行して再読み込みし、その後 /adspirer:setup を実行します
Codex	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh) を実行して Codex を再起動し、その後 codex mcp login adspirer を実行します
Cursor	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh) を実行します
その他の MCP クライアント	リモートサーバー https://mcp.adspirer.com/mcp を追加します（OAuth 2.1）

または、ターミナルでコマンドを 1 つ実行するだけで、スタートガイドのスキルをインストールして、すぐにセットアップを開始できます。

curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/scripts/install-skill.sh | bash

この後の手順： インストール後にサインインすると無料アカウントが作成されます（Google またはメールアドレスを使用。クレジットカードは不要です）。adspirer.ai/connections で広告プラットフォーム（Google Ads、Meta、Amazon、LinkedIn、TikTok、または ChatGPT Ads）を任意の組み合わせで接続すると、アシスタントが接続を確認します（「接続済みの広告プラットフォームを確認して」と伝えてください）。

仕組み

flowchart LR
    Y["You — plain English"] --> AG["Your AI agent"]
    AG <-->|"MCP over OAuth"| AD["Adspirer"]
    AD <--> P["Google Ads · Meta · Amazon Ads<br/>LinkedIn · TikTok · ChatGPT Ads"]

希望する内容を伝えると、アシスタントが Adspirer のツールを呼び出し、Adspirer が広告プラットフォームの API と通信します。レポートや下書きはチャットに返されます。新しいキャンペーンは常に一時停止状態で作成されるため、明示的な承認なしに費用が発生することはありません。認証にはご自身のブラウザーで OAuth を使用するため、アシスタントが認証情報を見ることはありません。

料金： Free — 月 15 回のツール呼び出し、$0、カード不要 · Plus — 月 150 回、$49 · Pro — 月 600 回、$99 · Max — 月 3,000 回、$199。詳細はこちら。

貼り付けて使えるプロンプト付きの完全なセットアップガイド： adspirer.com/docs/add-to-your-agent

できること

• 戦略を考慮した実行 — 戦略上の決定は STRATEGY.md に保存され、セッションやサブエージェントをまたいで、今後のすべてのキャンペーン作成、キーワード調査、広告コピーの作成に反映されます
• 400 以上のツールで、6 つの広告プラットフォームにおけるキャンペーンの作成、パフォーマンス分析、最適化に対応
• 構造化されたプロンプトを使用してキャンペーンを計画・検証
• 実際の CPC データと競合分析を用いたキーワード調査
• Google Ads の検索、Performance Max（検索テーマとオーディエンスシグナルを含む）、ディスプレイ（スタンダード＋スマート）、Demand Gen、YouTube のキャンペーンをエンドツーエンドで作成
• Meta の画像／動画／カルーセル／OUTCOME_LEADS キャンペーン、キャンペーングループを含む LinkedIn のスポンサードコンテンツ／カルーセル／リード獲得フォーム、TikTok のインフィード／Spark Ads／カルーセル／アプリプロモーションキャンペーンを開始
• 実行可能な最適化の推奨事項を含むパフォーマンス分析 — 無駄な広告費、異常検知、オーディエンスのインサイト、クリエイティブの疲弊
• 29 種類すべてのパフォーマンス／分析ツールで利用できる生データモード（raw_data=true） — 独自のアトリビューション、ダッシュボード、トークン効率の高いパイプラインに使える JSON のみの出力
• マルチアカウント、マルチプラットフォーム対応 — 代理店は 1 つのワークスペースから、プラットフォームごとに複数の広告アカウントを管理できます
• 自動化 — すべてのプラットフォームを対象とする、スケジュール設定された概要、パフォーマンスモニター、オンデマンドのクロスプラットフォームレポート

プラットフォームとツール

プラットフォーム	ツール	機能
Google Ads	151	検索、Performance Max（検索テーマとオーディエンスシグナルを含む）、ディスプレイ（スタンダード＋スマート）、Demand Gen、YouTube、ショッピング、アプリキャンペーン、キーワード調査、パフォーマンス分析、無駄な広告費の分析、アセット管理、広告表示オプション（サイトリンク／コールアウト／構造化スニペット）、入札戦略の管理
Amazon Ads	61	スポンサープロダクト／ブランド／ディスプレイキャンペーン、キーワード＋除外キーワード、商品／カテゴリーターゲティング、Amazon 独自の入札額／予算／キーワードの推奨、検索語句レポート、ACOS／ROAS パフォーマンス
Meta Ads	58	画像／動画／カルーセル／カタログ（Advantage+／DPA）キャンペーン、OUTCOME_LEADS リード獲得フォーム、通算予算、詳細な掲載面（フィード／ストーリーズ／リール）、市区町村単位のターゲティング、カスタムオーディエンス、カスタムコンバージョン、アプリプロモーション（AEO）分析
LinkedIn Ads	54	スポンサードコンテンツ（単一画像、動画、カルーセル、テキスト）、リード獲得フォーム、キャンペーングループ、19 種類のターゲティング条件、オーディエンスのインサイト、クリエイティブの疲弊分析、コンバージョントラッキング、組織
TikTok Ads	37	インフィード動画／画像／Spark Ads／カルーセル／アプリプロモーションキャンペーン、ライフサイクル全体（キャンペーン、広告グループ、広告の一覧表示／取得／一時停止／再開／更新）、分析（パフォーマンス、無駄な広告費、オーディエンスのインサイト、クリエイティブの疲弊、異常検知、地域）
ChatGPT Ads	31	ChatGPT の回答内に表示される chat_card 広告 — ワンショットで開始（キャンペーン → 広告グループ → 画像 → 広告）、地域ターゲティング、一時停止／有効化／アーカイブ、パフォーマンス（インプレッション、クリック数、CTR、CPC）、コンバージョントラッキング（Pixel＋Conversions API）
合計	400 以上	モニタリングと自動化（スケジュール設定された概要／モニター／レポート）、Google Analytics 4 と Klaviyo の連携、アカウント管理ツールも含みます — すべて MCP 経由および api.adspirer.ai の REST エンドポイントから利用できます

接続方法

各プラットフォームの詳細なセットアップ手順については、CONNECTING.md をご覧ください。

Claude（推奨）

1. Settings > Connectors > Add custom connector を開きます
2. 名前：Ads MCP
3. URL：https://mcp.adspirer.com/mcp
4. OAuth 2.1 でサインインします
5. 初回利用時に広告アカウントを連携します

Claude Code

Adspirer プラグイン一式（エージェント＋スキル＋コマンド＋MCP サーバー）をインストールします。

1. Claude Code を開きます
2. /plugin marketplace add amekala/ads-mcp を実行します
3. /plugin install adspirer-advertising-agent を実行します
4. /mcp を実行し、adspirer サーバー（例：plugin:adspirer-advertising-agent:adspirer）を見つけてクリックし、認証します
5. /adspirer:setup を実行してキャンペーンデータを取得し、ブランドのワークスペースを作成します

これにより、ブランドを把握し、永続メモリ、ウェブ検索による競合調査、広告表示オプションを含むキャンペーン作成、一般的なワークフロー用のスラッシュコマンドに対応した、パフォーマンスマーケティングエージェントを利用できます。 サブエージェントの使用を有効にしても、このインストール手順は変わりません。

MCP のみ（プラグインなし）： エージェントを使わず、MCP ツールだけを利用する場合：

claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp

ChatGPT

1. Settings > Connectors > Add custom connector を開きます
2. 名前：Ads MCP
3. URL：https://mcp.adspirer.com/mcp
4. OAuth 2.1 のサインイン手順に従います

Cursor

~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "adspirer": {
      "url": "https://mcp.adspirer.com/mcp"
    }
  }
}

OpenAI Codex

~/.codex/config.toml に追加します：

[mcp_servers.adspirer]
url = "https://mcp.adspirer.com/mcp"

Gemini CLI

拡張機能としてインストールします：

gemini extensions install github.com/amekala/ads-mcp

初回使用時に、OAuth 認証用のブラウザーウィンドウが開きます。カスタムコマンドを利用できます：/adspirer:setup、/adspirer:performance-review、/adspirer:wasted-spend、/adspirer:write-ad-copy、/adspirer:refresh。

OpenClaw

openclaw plugins install openclaw-adspirer
openclaw adspirer login
openclaw adspirer connect

または、ClawHub からインストールします。

Perplexity、Manus、その他の MCP クライアント

Adspirer は標準的な MCP サーバーです。OAuth 2.1 対応の MCP コネクターをサポートするクライアント（Perplexity、Manus AI、カスタム MCP クライアント）であれば、https://mcp.adspirer.com/mcp に接続できます。Manus では、Streamable HTTP トランスポート経由の API キーも利用できます。

REST API（MCP クライアント不要）

同じツール群が、https://api.adspirer.ai/api/v1/tools/<tool_name>/execute の 178 個の REST エンドポイントとして公開されています。adspirer.ai/keys で作成したパーソナルアクセストークン（sk_live_...）で認証します。Swagger: https://api.adspirer.ai/docs。完全なリファレンス：adspirer.com/docs/api-reference。

プロンプトの例

キーワード調査：

Research keywords for my emergency plumbing business in Chicago.
Show me high-intent keywords with real CPC data and budget recommendations.

パフォーマンス分析：

Show me campaign performance for the last 30 days across all platforms.
Which campaigns are converting best and what should I optimize?

キャンペーン作成：

Create a Google Performance Max campaign for luxury watches targeting
New York with a $50/day budget.

複数プラットフォーム戦略：

I want to advertise my handmade jewelry business across Google and LinkedIn.
Research keywords for Google Ads and create a LinkedIn sponsored content campaign
targeting small business owners.

技術詳細

• プロトコル： MCP 2025-03-26（2024-11-05 へのフォールバックあり）
• トランスポート： Streamable HTTP
• OAuth： RFC 8252（Authorization Code + PKCE）、RFC 7591（Dynamic Client Registration）、RFC 9728（Protected Resource Metadata）に対応
• ツールのアノテーション： すべてのツールに MCP の安全性メタデータ（readOnlyHint、destructiveHint）が含まれます

セキュリティ

• すべてのデータ送信に HTTPS/TLS を使用
• 認証に PKCE を用いた OAuth 2.1 を使用
• CLI ツール（Claude Code、Cursor、Codex）向けの動的クライアント登録
• トークンを暗号化して保存
• 会話のログは記録せず、ツールリクエストのみを処理

脆弱性の報告については、SECURITY.md をご覧ください。

ドキュメント

• 接続ガイド
• プライバシーポリシー
• 利用規約
• セキュリティ
• サポート

サポート

• メール： [email protected]
• 課題： https://github.com/amekala/ads-mcp/issues
• ウェブサイト： https://www.adspirer.com
• サーバーのステータス： https://mcp.adspirer.com/health

対応プラグイン

このリポジトリでは、単一のモノレポから4つのAIプラットフォーム向けプラグインを配布しています。

プラットフォーム	ディレクトリ	スキル	インストール方法
Claude Code	リポジトリのルート	生成済み1件＋スラッシュコマンド5件	/plugin marketplace add
Claude Tag (@claude)	上流： anthropics/claude-tag-plugins PR #3	1件（adspirer-api：SKILL＋341ツールカタログ＋ads_call.sh）	組織アクセスバンドル（Bearer sk_live_キー、ホストapi.adspirer.ai／mcp.adspirer.com）；マージ後に一度だけclaude plugin install adspirer@claude-tag-pluginsを実行
Cursor	plugins/cursor/adspirer/	テンプレートから生成された5件	install.sh（ワンコマンド）
Codex	plugins/codex/adspirer/	テンプレートから生成された5件	install.sh（ワンコマンド）
Gemini CLI	リポジトリのルート	再利用1件＋カスタムコマンド5件	gemini extensions install
OpenClaw	plugins/openclaw/	単独1件（自己完結型）	openclaw plugins install

Claude Tagへの提出記録（2026-07-05）： Claude Tag (@claude)向けのadspirerプラグインは、フォークブランチ amekala/claude-tag-plugins@add-adspirer-plugin から上流に anthropics/claude-tag-plugins#3 として提出されました。 このリポジトリのRESTインターフェース（POST /api/v1/tools/<tool>/execute — プレーンなHTTP経由で同じMCPサーバーツールレイヤーを提供）をラップしており、MCPトランスポートは使用しません。提出前に、稼働中のClaude Tagワークスペース（Slack）でエンドツーエンドの検証を完了しました。

Claude Code、Cursor、Codex向けのスキルは、shared/skills/でテンプレートとして一度作成し、scripts/sync-skills.shでIDEごとのバージョンにコンパイルします。 パフォーマンスマーケティングエージェントのプロンプトも、shared/agents/performance-marketing-agent/PROMPT.mdで一度作成し、同じ同期スクリプトでClaude Code、Cursor、Codex向けのエージェントファイルにコンパイルします。 OpenClawでは専用の単独スキルを使用します。設計の全容についてはアーキテクチャを参照してください。

共有更新のワイヤーフレーム

Edit once (source of truth)
  ├─ shared/skills/adspirer-*/SKILL.md
  └─ shared/agents/performance-marketing-agent/PROMPT.md
                |
                v
        ./scripts/sync-skills.sh
                |
                +--> Claude Code outputs
                |     ├─ skills/<name>/SKILL.md
                |     └─ agents/performance-marketing-agent.md
                |
                +--> Cursor outputs
                |     ├─ plugins/cursor/adspirer/.cursor/skills/adspirer-*/SKILL.md
                |     └─ plugins/cursor/adspirer/.cursor/agents/performance-marketing-agent.md
                |
                +--> Codex outputs
                |     ├─ plugins/codex/adspirer/skills/adspirer-*/SKILL.md
                |     └─ plugins/codex/adspirer/agents/performance-marketing-agent.toml
                |
                +--> Gemini CLI (reuses Claude Code skill)
                |     ├─ gemini-extension.json
                |     ├─ GEMINI.md
                |     └─ commands/adspirer/*.toml
                |
                └--> OpenClaw (standalone, not generated)
                      └─ plugins/openclaw/SKILL.md

クライアントのルートとインストール先

AIクライアント	リポジトリのソースルート	リポジトリ内の生成先／ランタイムルート	ユーザーのインストール先／方法
Claude Code	リポジトリのルート＋shared/skills/＋shared/agents/	skills/、agents/、commands/、.claude-plugin/	/plugin marketplace add amekala/ads-mcpの後に/plugin install adspirer-advertising-agent
Cursor	plugins/cursor/adspirer/＋共有ソース	plugins/cursor/adspirer/.cursor/skills/、plugins/cursor/adspirer/.cursor/agents/	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)
Codex	plugins/codex/adspirer/＋共有ソース	plugins/codex/adspirer/skills/、plugins/codex/adspirer/agents/	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)
Gemini CLI	リポジトリのルート	gemini-extension.json、GEMINI.md、commands/adspirer/	gemini extensions install github.com/amekala/ads-mcp
OpenClaw	plugins/openclaw/	plugins/openclaw/（単独、同期による生成なし）	openclaw plugins install openclaw-adspirer

開発者ガイド

このリポジトリへのコントリビュートや、新しい広告プラットフォーム／IDEのサポート追加に参加する場合：

• アーキテクチャ — 共有スキルモデル、テンプレートシステム、完了済みの項目と残作業
• テンプレート構文と同期ワークフロー — 変数置換、条件ブロック、検証チェック
• 広告プラットフォームの追加 — 新しい広告プラットフォーム（例：Snapchat、Pinterest、YouTube）の追加方法
• IDEの追加 — 新しいIDE（例：Windsurf、Cline）のサポート追加方法

クイックリファレンス

./scripts/sync-skills.sh          # Generate IDE-specific skills from templates
./scripts/sync-skills.sh --check  # Verify generated files match committed (CI mode)
./scripts/validate.sh             # Run all 62 offline validation checks
./scripts/validate.sh --live      # Also test MCP endpoint connectivity

plugins/*/skills/、skills/、agents/、plugins/*/agents/ 内のファイルを直接編集しないでください。同期スクリプトによって上書きされます。代わりに、shared/skills/ 内のテンプレートと、shared/agents/ 内の共有プロンプトを編集してください。

ライセンス

プロプライエタリ — 利用条件については、利用規約を参照してください。