Claude CodeでSearch Console APIを叩いて検索データを分析した記録

やろうとしたこと

運営している複数サイトの検索パフォーマンスを横断で比較し、「次にどのサイトのどこへ手を入れるか」を数字で決めたい、というのが目的でした。Search Consoleの画面でも1サイトずつなら見られますが、サイト数が増えると比較になりません。

そこでClaude Codeに「Search Console APIを叩いて、指定サイトの全クエリ・全ページを取得するスクリプトを書いて」と頼みました。認証方式の選定から実装まで対話で詰め、結果として次のような道具立てになりました。

• 共通クライアント──サイト一覧の取得、期間と集計軸を指定したデータ取得、URL検査、サイトマップ状態の取得をまとめた土台
• 1サイト詳細──全クエリ・全ページを取得し、「あと少しで1ページ目」の語と「上位なのにクリックされていない」語を自動で抜き出す
• 全サイト一括──登録している全プロパティの実績とサイトマップの状態を一覧化する

認証方式の選び方でつまずいた

最初はOAuthで作り始めましたが、トークンの期限切れでスクリプトが止まるのが分析作業と相性が悪く、サービスアカウント方式に切り替えました。長時間の集計を回す用途では、人の再ログインを前提としない方式が正解でした。

ただしサービスアカウントには一手間があり、各プロパティの「ユーザーと権限」にサービスアカウントのメールアドレスを追加する必要があります。この追加操作はAPIには無く画面での手作業になるため、プロパティ数が多いほど地味に時間を取られます。ここは自動化を試みず、素直に手で入れるのが早いと割り切りました。

分析して方針が2回ひっくり返った

ここが、画面をぼんやり眺めていたら絶対に辿り着かなかった部分です。

1回目。「10〜20位を押し上げる」をやめた。SEOの定石なので当然やるつもりでしたが、順位帯ごとに表示量とCTRを集計したら、その帯には13語・388表示しかありませんでした。全部5位まで上げても増えるのは約19クリック／90日で、サイト全体の2%です。手つかずで残っていたのは、そこに賞金が無かったからでした。

代わりに見えたのが「10位以内なのにCTR5%未満」の11語で807表示という帯です。こちらを直す方が3倍大きく、しかも新規記事ではなくtitleとdescriptionの修正で済みます。順位帯ごとの表示量を先に出してから、どの帯を触るか決めるという順番の大切さを実感しました。

2回目。「エラー系の記事を量産する」をやめた。このサイトは「claude 障害」「claude 復旧」といった障害系のクエリで1〜4位を取れていたので、同じ調子でClaude Codeのエラー系も狙えると考えていました。ところがキーワード調査を重ねると、Claude Code側のエラー語はほぼ全部が月10〜100件規模で、広告主もいませんでした。チャット製品の利用者数と開発ツールの利用者数を混同していたわけです。エラー系は個別ページ化せず、1本にまとめる判断に変えました。

Claude Codeに任せて良かった点・注意した点

• 良かった：試行錯誤の速さ──「順位帯ごとに集計して」「10位以内で低CTRのものを抜き出して」といった思いつきを、その場で使い捨てスクリプトにしてもらえます。分析は仮説を何度も変える作業なので、この速さがそのまま結論の質になりました
• 良かった：ライブラリの事故の復旧──途中でAPIのライブラリが壊れて全ツールが起動しなくなりましたが、エラーの読解から再インストールまで任せて数分で復旧しました
• 注意した：出てきた数字を鵜呑みにしない──上記のクエリ次元の罠は、まさにAIが出した集計をそのまま信じかけた場面でした。結論が方針を左右する数字は、必ず別の集計軸で検算するのを習慣にしました
• 注意した：認証情報を会話に出さない──鍵ファイルはパスで参照させ、中身を表示させない運用にしています

次にやること

この分析の結論として、Claude Code関連の記事群を作り直す方針を決めました。その実装側の記録はキーワード調査から12ページを設計した記録に分けて残しています。サイトへの反映作業そのものについてはFTP経由でサイトを編集した記録にまとめました。