
Search Console APIとClaude Codeで、SEO改善提案の下書きを作る──クエリとページの数字はAPIで取り、候補の洗い出しはAIに、直すかどうかは人が決める
この記事は、Search Console APIとClaude Codeで、SEOの改善提案の下書きを作る手順を扱います。
改善提案が「順位が下がりました」で止まっている
Search Consoleの画面を開き、表示回数とクリック数を眺めて、気になったページを数本挙げる。
その選び方は、担当者の勘に任されています。
担当者が変われば、選ぶページも変わります。
顧客から見ると、毎月違う話をされているように見えます。
Search Consoleの改善提案とは、クエリとページの数字を同じ条件で取り、決めた基準で候補を挙げ、直す価値を人が判断する作業である
黒字化の外科医です。Search Consoleを使った改善提案を、AIと人の分担から解剖します。
分担を決めるべき理由は、三つあります。
第一に、候補の洗い出しは、基準さえ決めれば機械でできるから。
「表示は多いがクリックが少ない」「前の期間より大きく落ちた」は、同じ式で毎月拾えます。
第二に、直す価値は、数字だけでは決まらないから。
売上につながるページか、顧客がいま力を入れたい商品かは、画面の外にある情報です。
第三に、APIのデータには、上位の行しか返らない性質があるから。
全体の数字と細かい行の合計が合わないことを知らずに資料を作ると、説明に詰まります。
Search Console APIで確認できたこと
2026年10月29日に、公式ドキュメント(developers.google.com の Search Console API の searchAnalytics.query、Prerequisites、Python のクイックスタート)で確認した内容です。
・取得は searchAnalytics.query(POST …/webmasters/v3/sites/〔サイトURL〕/searchAnalytics/query)
・サイトURLは https://www.example.com/ の形か、ドメインプロパティなら sc-domain:example.com
・権限の範囲は webmasters.readonly(読み取り)か webmasters
・期間は startDate・endDate(YYYY-MM-DD、太平洋時間)で必須
・dimensions:query、page、country、device、searchAppearance、date、hour
・返る数字:clicks、impressions、ctr(0〜1)、position(平均掲載順位)
・rowLimit は既定1,000、1〜25,000。続きは startRow でずらして取る
・dataState の既定は final(確定したデータのみ)
・APIは全行ではなく上位の行を返す、と明記されている
・呼び出すアカウントには、そのプロパティの閲覧以上の権限が要る
・Python では build('searchconsole', 'v1', …) でサービスを作る下書きで拾う4つの候補
基準の数字は、会社ごとに決めます。下の〔 〕は自社で埋める値です。
1. 表示は多いがクリック率が低いページ
impressions が〔 〕以上、ctr が〔 〕未満 → タイトルと説明文の見直し候補
2. あと少しで上位に入るクエリ
position が〔 〕〜〔 〕位 → 本文の補強や内部リンクの候補
3. 前の期間から大きく落ちたページ
clicks の差が〔 〕%以上の減少 → 原因の調査候補
4. 1つのクエリで複数のページが表示されている
query と page を組で取り、同じクエリに複数ページ → 役割の整理候補Claude Codeには、この4つの一覧を作らせ、各候補に「確かめる問い」を付けさせます。
「このページを書き直すべき」とは書かせません。
今すぐ試せる:改善候補の一覧を作るプロンプト
私はWeb制作会社のSEO担当です。Search Console API で取得したJSON(query・page別の clicks、impressions、ctr、position。今月と前月)を渡します。
(顧客名は伏せています)
【基準】
・クリック率の見直し候補:impressions〔 〕以上、ctr〔 〕未満
・上位手前のクエリ:position〔 〕〜〔 〕位
・大きく落ちたページ:clicks〔 〕%以上の減少
1. 基準に当たる候補を4つの区分で表にする。数字はJSONの値をそのまま使い、計算した値には式を添える。
2. 各候補に「担当者が確かめる問い」を1つ付ける(例:この期間にページを改修したか)。
3. 原因を断定しない。改善の効果を数字で約束しない。改善提案工場:月次の流れと時間の計算
1. スクリプトで今月と前月を取得(query×page、rowLimit を上げて startRow で続きを取る)
2. Claude Codeで4区分の候補表と「確かめる問い」を作る
3. 担当者が問いに答え、直す価値のある候補を3つ以内に絞る
4. 提案書に「何を・なぜ・どう確かめるか」を書く計算例(数字はすべて例):
今:候補探し2時間 + 提案書1時間 = 3時間/サイト
下書き後:問いへの回答と絞り込み0.5時間 + 提案書1時間 = 1.5時間/サイト
8サイト:(3 − 1.5) × 8 = 12時間/月
時間単価 7,645円(例):12 × 7,645円 = 91,740円/月報告で順位から見せない理由は、こちらで扱っています。
▶ SEOの効果測定レポートは「順位」から見せると誤解される──表示回数・クリック数・問い合わせへのつながりで報告する型と、誤解を招く見せ方5つ
構造的なリスク
逆説を指摘しておきます。
候補が機械的に毎月出てくると、提案の本数が増えます。
本数が増えるほど、顧客は実施しきれず、提案が積み残されていきます。
候補は多く拾い、提案は3つ以内に絞る。この絞り込みこそが、人の仕事です。
よくあるQ&A
Q. 画面の数字とAPIの数字が合わないのはなぜか?
APIは上位の行を返す仕組みで、期間も太平洋時間で区切られます。資料には「APIで取得した上位の行」と注記します。
Q. AI検索での表示も、Search Consoleで分かるか?
この記事の手順は、通常の検索の数字を扱います。AI検索での言及の測り方は別の記事で扱います。
Q. 制作の段階から、改善しやすいサイトにしておくには?
ページと検索語の対応、内部リンク、計測の設計を、制作の範囲に入れておきます。
▶ Web制作のSEO提案は「納品後の別料金」にしない──サイト構造、内部リンク、ページと検索語の対応、計測の設計を、制作の範囲に組み込む方法
最後に
Search Consoleの改善提案は、候補を拾う作業と、直す価値を決める作業に分けられます。
拾う作業をAPIとAIに任せ、絞り込みを人が担った会社だけが、毎月ぶれない提案を、少ない時間で出し続けられるのです。
取得スクリプトの雛形と、候補表・提案書の型は、計測・改善の自動化レシピ集にまとめました。
これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。
#Web制作会社 #ClaudeCode #SearchConsole #SEO #改善提案 #運用代行 #制作会社経営 #中小企業 #AI駆動開発 #業務効率化