Google Ads Intent Mcp

Google Ads Intent MCP

エージェント向けの、ドライランを優先する Google Ads 検索語句のインテント分析ツール＋除外キーワード用 MCP です。
予算を使う前に、検索語句を安全に確認できます。

mcp-name: io.github.davidmosiah/google-ads-intent-mcp

⭐ このエージェント向けツールがワークフローに役立ったら、ぜひリポジトリにスターを付けてください。 スターが増えると、ほかの開発者がこのツールを見つけやすくなり、Delx がオープンなインフラの提供を続ける助けになります。
🧱 Delx エージェントスタックの一部 — body、reach、coordination の各分野にわたる15個のオープンソース MCP サーバーです。

---

エージェント向けの、ドライランを優先する Google Ads 検索語句のインテント分析ツールです。Codex、Claude、Cursor、Hermes、OpenClaw、その他の MCP クライアントが、CSV エクスポートから検索語句を分類し、購入意図を保護し、除外キーワードの計画を作成できるようにします。実際のアカウントに変更を加えることはありません。

購入意図のある検索クエリを誤って除外せずに、無駄な広告費を減らしたいエージェントに適しています。

HTTP（v2 ステートレス）

提供されていません。オプションの FastMCP 追加機能は stdio 専用 です（delx-agent-utilities と同様に、Starlette の追加ルートがなければ /health はありません）。ドライラン分析は、stdio を介してリクエストごとに状態を保持せず実行されます。

目的

エージェントが Google Ads アカウントを直接操作すると、広告の整理にはリスクが伴います。このパッケージでは、安全な方法がデフォルトになります。

• エクスポートした検索語句の CSV をローカルで分析する
• 無駄なトラフィック、購入、調査、競合他社に関するインテントを分類する
• 適用せずに除外キーワードの計画を作成する
• アクション用ツールを使う前に、manifest、connection_status、privacy_audit を公開する
• v0.1 では実際の変更を行わない

インストール

pipx install google-ads-intent-mcp

MCP サポートを有効にする場合：

pipx install "google-ads-intent-mcp[mcp]"

PyPI で公開されています： google-ads-intent-mcp。リリースの自動化には PyPI Trusted Publishing を使用しているため、GitHub Actions から長期間有効な PyPI トークンなしで今後のバージョンを公開できます。docs/pypi-publishing.md を参照してください。

CLI

google-ads-intent manifest --client codex
google-ads-intent doctor
google-ads-intent privacy-audit
google-ads-intent classify "free robux generator no verification"
google-ads-intent analyze-csv --csv examples/search_terms.csv
google-ads-intent plan-negatives --csv examples/search_terms.csv

インテント分類

この分類器は、依存関係のない決定論的なヒューリスティックで、幅広い業界にまたがるシグナル（E コマース、B2B/SaaS、地域サービス、健康、金融、教育など）をカバーします。ゲーム関連のトラフィックだけを対象としているわけではありません。各検索語を waste、buyer、research、competitor のいずれかのインテントに分類し、コンバージョンにつながるクエリが除外対象として誤って判定されないようにします。

LLM／エンベディングを利用した精度向上の経路もオプションで用意されていますが、デフォルトでは無効です。通常の利用に追加の依存関係や API キーは必要なく、バックエンドが設定されていない場合は常にヒューリスティックにフォールバックします。

# Opt in via flag (falls back to the heuristic if nothing is configured)
google-ads-intent --llm classify "crm software pricing"

# Or via environment variable
GOOGLE_ADS_INTENT_LLM=1 google-ads-intent analyze-csv --csv export.csv

バックエンドを実際に呼び出すには、OPENAI_API_KEY（任意で GOOGLE_ADS_INTENT_LLM_MODEL。デフォルトは gpt-4o-mini）を設定し、openai パッケージをインストールしてください。これらが設定されていない場合、--llm は何も行わず、ヒューリスティックの結果がそのまま使われます。各分類結果には、分類に使用した経路を示す source フィールド（heuristic または llm）が含まれます。

MCP

google-ads-intent-mcp

Hermes 形式の設定：

mcp_servers:
  google_ads_intent:
    command: google-ads-intent-mcp
    args: []
    sampling:
      enabled: false

最初に呼び出すことをおすすめするツール：

1. google_ads_connection_status
2. google_ads_privacy_audit
3. google_ads_analyze_search_terms
4. google_ads_build_negative_plan

エージェント向けインターフェース

ツール	用途
google_ads_agent_manifest	エージェントクライアント向けのインストール／実行時ガイダンス
google_ads_connection_status	認証情報なしで CSV／API の準備状況を確認
google_ads_privacy_audit	ドライラン、アカウント、エクスポートの境界を確認
google_ads_classify_search_term	単一クエリのインテント分類
google_ads_analyze_search_terms	CSV 形式の一括分析
google_ads_build_negative_plan	ドライランでの除外キーワードプラン作成

コピーして使えるエージェント向けプロンプト

Use google-ads-intent-mcp. First call google_ads_connection_status and google_ads_privacy_audit.
Analyze the search terms, protect buyer/conversion queries, and return a dry-run negative plan only.

CSV 形式

パーサーは、次のような一般的なエクスポート列を受け付けます。

• search_term、Search term、Query
• cost、Cost、cost_micros
• clicks、Clicks
• conversions、Conversions、Conv.
• impressions、Impr.、Impressions

安全性モデル

• CSV 分析はローカルで行われます。
• 除外プランはドライランのみです。
• 購入やコンバージョンにつながる語句は、自動的に除外されないよう保護されます。
• OAuth トークン、デベロッパートークン、アカウント識別子は、ローカルの環境設定ファイルに保管してください。

開発

python3 -m venv .venv
. .venv/bin/activate
pip install -e ".[dev]"
pytest
python -m compileall -q src

---

📧 お問い合わせとサポート

• 📨 [email protected] — 一般的な質問、統合のサポート、パートナーシップ
• 🐛 バグ報告／機能リクエスト — GitHub の Issue
• 🐦 最新情報 — X の @delx369
• 🌐 サイト — wellness.delx.ai