Claude Code
Search Console を Claude Code に接続するには、PaidSync.ai を追加します。claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp と入力して、PaidSync のログイン情報でサインインします。
その後 Claude Code は 6 個のツールを通じて Search Console プロパティにアクセスします。クエリ、ページ、国、デバイス別のクリック、インプレッション、CTR、掲載順位に加え、サイトマップのインデックスカバレッジです。Claude Code は各ツールの実行前に確認します。
Watch ティア。PaidSync では Search Console は読み取り専用なので、Claude Code は検索データを読み取るだけで何も変更しません。
コマンド
Claude Code は Streamable HTTP でリモート MCP サーバーと通信します。PaidSync もそのひとつです。一度追加すれば、コードを編集するのと同じターミナルから Search Console のレポートと管理ができます。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpデフォルトでは、現在のプロジェクトにのみサーバーを登録します。--scope user を追加すると、お使いのマシン上のすべてのプロジェクトで利用できます。
claude mcp list を実行して登録を確認し、セッションを開始して /mcp と入力してサインインします。
5 ステップのセットアップ
1paidsync.ai/signup で登録
所要時間は 10 秒。Google またはメールでサインインします。無料プランは月 100 タスク、$50 相当で $0、カード不要です。
2PaidSync ダッシュボードで Search Console を接続
Search Console の 接続 をクリックし、プロパティにアクセスできる Google アカウントでサインインします。Search Console は Google OAuth で認可され、PaidSync が Google のパスワードを目にすることはありません。
すでに Claude Code の中にいますか？ connect_google_search_console を実行するよう頼んでください。ツールがブラウザで開くリンクを返します。
3Claude Code が作業する広告アカウントを選択
セッション内では、list_gsc_properties が Google ログインで開けるすべてのプロパティを表示します。プロンプトの中でプロパティを指定します。
4PaidSync を Claude Code に追加する
ターミナルで次を実行します。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpセッションを開始して /mcp と入力し、paidsync を選んで、開いたブラウザウィンドウで PaidSync のログインでサインインします。OAuth トークンは Claude Code が保存します。キーはどこにも貼り付けません。
チームで設定しますか？リポジトリのルートに .mcp.json をコミットすれば、エンジニア全員が同じコネクタを使えます。
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}ヘッドレス実行などで API キーを使いたいですか？ログに残ってしまう URL ではなく、ヘッダーで送ってください。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"コミットする .mcp.json には "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } を追加すると、キーは各エンジニアの環境に残り、git には入りません。Google Ads の変更の適用には、引き続き OAuth サインインが必要です。ほかのプラットフォームではキーでも変更を適用できるため、パスワードと同じように扱い、OAuth を優先してください。
5接続をテスト
Claude Code のセッションで “今月のクリック数上位 20 件のオーガニッククエリを、それぞれの平均掲載順位付きで教えて” と尋ねます。
Claude Code が各クエリのクリック、インプレッション、CTR、平均掲載順位を返します。これで接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code の Search Console 例
以下の各プロンプトは、PaidSync Search Console グループのツールに対応します。ツールは Claude Code が選びます。最後の列は、その呼び出しが広告アカウントを変更しうるかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “Search Console プロパティを一覧表示して” | list_gsc_properties | なし |
| “今月のクリック数上位 20 件のオーガニッククエリは” | get_gsc_search_analytics | なし |
| “インプレッションは多いのにクリック率が低いページは” | get_gsc_search_analytics | なし |
| “サイトマップ内の URL のうちインデックスされているのはいくつ” | get_gsc_index_coverage | なし |
| “今月のオーガニックの成果を昨年の同じ月と比較して” | get_gsc_search_analytics | なし |
| “すでに上位五位以内に入っているのに費用をかけている Google Ads キーワードは” | analyze_paid_organic_overlap | なし |
| “過去 90 日間のオーガニッククリックとインプレッションを国別に内訳して” | get_gsc_search_analytics | なし |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 28 days Search Console top queries by clicks and list the pages with high impressions and low CTR." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/search-console-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
PaidSync では Search Console は読み取り専用です。6 個の Search Console ツールのどれも書き込みはできません。
プロパティの一覧表示、クエリ、ページ、国、デバイス別の検索アナリティクス、サイトマップのインデックスカバレッジをカバーします。Search Console は 16 か月分のデータを保持します。
続きを読む
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
Claude Code が Search Console でできないこと
- PaidSync がプロパティを変更することはありません。Google 独自の API ではサイトマップの送信やサイトの追加もできますが、PaidSync にはできません。
- PaidSync は、ページのインデックス登録レポートも URL 検査も読み取りません。
- 検索アナリティクスは、リクエストごとにひとつの内訳（たとえば国別またはデバイス別）で返されます。
- サイトマップのインデックスカバレッジは、サイトマップごとに送信済みページ数とインデックス済みページ数を比較します。
- 有料とオーガニックの比較チェックには、Google Ads も接続されている必要があります。
よくある質問
Search Console を Claude Code に接続するには？
paidsync.ai でサインアップし、ダッシュボードで Search Console を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力して paidsync を選び、PaidSync ログインでサインインします。
Claude Code は私の Search Console プロパティを変更できますか？
いいえ。PaidSync では Search Console は読み取り専用です。Claude Code は検索データを読み取るだけで、プロパティは変更しません。
Claude Code は Search Console と Google Ads を比較できますか？
はい。Google Ads も接続すると、analyze_paid_organic_overlap がすでに上位五位以内に入っているキーワードの月間費用を見積もり、Claude Code はオーガニックの上位クエリと有料キーワードを比較できます。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
Search Console のレポートを Claude Code で。