Google Keyword Planner

Google Keyword Planner MCP サーバー

Claude やその他の MCP クライアントから Google Ads Keyword Planner のデータに直接アクセスできる MCP サーバーです。キーワード候補、月間平均検索数、競合度、ページ上部掲載の入札単価範囲、月別トレンド、クリック数と費用の予測を取得できます。

Afeez Adebayo が開発しました。MIT ライセンスです。

質問できること

• 「ナイジェリアで online accounting software のキーワード候補を100件、検索ボリューム順に表示して。」
• 「英国と米国で、これら50個のキーワードの検索ボリュームとトレンドを取得して。」
• 「https://example.com/pricing. からキーワード候補を取得して。」
• 「これらの完全一致キーワードについて、上限クリック単価を ₦300 に設定し、30日間のクリック数と費用を予測して。」

ツール

ツール	説明
generate_keyword_ideas	シードキーワード、URL、キーワードとURLの組み合わせ、またはサイト全体から候補を取得します。月間平均検索数、競合度、ページ上部掲載の入札単価の下限と上限、3か月間の変化、表示期間全体（最初の月から最後の月まで）の変化、オプションで月別検索数を返します。最小検索数で絞り込み、検索数、競合度、入札単価、関連性で並べ替えられます。
get_search_volume	最大10,000個の完全一致キーワードの過去の指標を取得します。類似キーワードと、Googleがデータを返さなかったキーワードの一覧も含まれます。月の範囲を指定できます。
forecast_keywords	指定した上限クリック単価で、1～365日間のインプレッション数、クリック数、費用、CTR、平均クリック単価を予測します。
find_locations	地名から Google のロケーション ID を検索します。
list_languages	ターゲットにできる言語とそのコードおよび ID の一覧を表示します。
list_accessible_customers	ログイン中のアカウントからアクセスできる Google Ads アカウントの一覧を表示します。
check_connection	認証情報を確認し、アカウント、通貨、デフォルト設定を表示します。

ロケーションと言語は、Google ID のほか、通常の名前（"Nigeria"、"Lagos"、"English"）でも指定できます。入札単価と費用は、Google Ads アカウントの通貨で表示されます。

必要なもの

Keyword Planner のデータは Google Ads API から取得されます。2026年9月9日以降、Google は開発者トークンを使用しなくなります。API アクセスは、OAuth クライアントを所有する Google Cloud プロジェクトに紐付けられます。必要なものは以下のとおりです。

1. Google Ads アカウント。 有効化されている必要がありますが、キャンペーンを実施している必要はありません。管理アカウントは任意です。

2. Google Ads API を有効にした Google Cloud プロジェクト。 Google Cloud コンソールでプロジェクトを作成し、Google Ads API を有効にします。これによりテストアクセスが付与されますが、テストアカウントでのみ機能します。

3. そのプロジェクトの基本アクセス権。 Keyword Planner はエクスプローラーアクセスに含まれないため、基本アクセス権が必要です。

   • OAuth 同意画面（Google Auth Platform > Branding）を設定し、ブランド確認を完了します。
   • プロジェクトの Google Ads API Overview page を開き、基本アクセス権を申請します。Google はブランド確認の完了後、通常数分以内に自動で審査します。
   • プロジェクトが Google Cloud の無料トライアル中の場合、申請が却下されることがあります。課金アカウントを有料プランにアップグレードすれば解決します（Google Ads API の利用料金は請求されません）。

4. 同じプロジェクト内に、種類が Desktop app の OAuth クライアント ID。テストステータスのアプリのリフレッシュトークンは7日後に期限切れになるため、同意画面の公開ステータスを In production に設定してください。

5. リフレッシュトークン。 このリポジトリをクローンし、次のコマンドを実行します。

   npm install
   GOOGLE_ADS_CLIENT_ID=your-client-id GOOGLE_ADS_CLIENT_SECRET=your-secret npm run auth
   

表示されたリンクを開き、Ads アカウントにアクセスできる Google アカウントでログインして、表示されたリフレッシュトークンをコピーします。

インストール

Claude Desktop（ワンクリック）

最新リリースから google-keyword-planner.mcpb をダウンロードして開きます。Claude Desktop で認証情報の入力を求められ、シークレットが安全に保存されます。

任意の MCP クライアント（ソースから）

git clone https://github.com/afeezadebayo/google-keyword-planner-mcp.git
cd google-keyword-planner-mcp
npm install && npm run build

次に、クライアントの設定に追加します。

{
  "mcpServers": {
    "google-keyword-planner": {
      "command": "node",
      "args": ["/path/to/google-keyword-planner-mcp/server/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "...",
        "GOOGLE_ADS_CLIENT_SECRET": "...",
        "GOOGLE_ADS_REFRESH_TOKEN": "...",
        "GOOGLE_ADS_CUSTOMER_ID": "123-456-7890",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "",
        "KEYWORD_PLANNER_DEFAULT_LANGUAGE": "English",
        "KEYWORD_PLANNER_DEFAULT_LOCATIONS": "Nigeria"
      }
    }
  }
}

Claude Code の場合：

claude mcp add google-keyword-planner \
  -e GOOGLE_ADS_CLIENT_ID=... -e GOOGLE_ADS_CLIENT_SECRET=... \
  -e GOOGLE_ADS_REFRESH_TOKEN=... -e GOOGLE_ADS_CUSTOMER_ID=123-456-7890 \
  -- node /path/to/google-keyword-planner-mcp/server/index.js

設定

変数	必須	備考
GOOGLE_ADS_CLIENT_ID	はい	OAuth クライアント（デスクトップアプリ）です。Cloud プロジェクトには Basic アクセスが必要です。
GOOGLE_ADS_CLIENT_SECRET	はい
GOOGLE_ADS_REFRESH_TOKEN	はい	npm run auth で取得します。
GOOGLE_ADS_CUSTOMER_ID	はい	クエリ対象のアカウントです。ハイフンを含めてもかまいません。
GOOGLE_ADS_LOGIN_CUSTOMER_ID	いいえ	マネージャーアカウントを経由してアカウントにアクセスする場合は、そのマネージャーアカウント ID です。
GOOGLE_ADS_API_VERSION	いいえ	デフォルトは v25 です。Google がバージョンの提供を終了した場合に変更してください。
KEYWORD_PLANNER_DEFAULT_LANGUAGE	いいえ	リクエストで言語が指定されていない場合に使用します。
KEYWORD_PLANNER_DEFAULT_LOCATIONS	いいえ	リクエストで地域が指定されていない場合に使用する、カンマ区切りの名前または ID です。
GOOGLE_ADS_DEVELOPER_TOKEN	いいえ	レガシーです。Google は 2026 年 9 月 9 日にデベロッパートークンの提供を終了しました。設定した場合にのみ送信されます。

知っておくと便利なこと

• 検索ボリュームは推定値です。 Keyword Planner は検索ボリュームを範囲に丸め、類似する検索語句をグループ化します。広告費が少ない、または広告を出稿していないアカウントでは、範囲が広くなることがあります。
• レート制限。 Keyword Planner では、1 分あたりのリクエスト数に上限があります。サーバーはレート制限エラーとサーバーエラーが発生した場合、バックオフを適用して自動的に再試行します。
• エラーには解決方法が示されます。 よくある問題（Cloud プロジェクトのアクセス権が Test のみ、マネージャーアカウント ID の未設定、リフレッシュトークンの期限切れ）が発生すると、解決方法を平易な英語で説明するメッセージが返されます。
• プライバシー。 サーバーはお使いのマシン上で実行され、Google とのみ通信します。認証情報は MCP クライアントの設定内に保持されます。

開発

npm install
npm run typecheck
npm run build
npm test   # runs every tool against a local mock of the Google Ads API

リリースは自動化されています。package.json の version を更新して main にプッシュすると、バンドルがビルドされ、GitHub リリースが作成され、公式 MCP Registry に掲載されます。