seo-google

Google SEO API

Google 独自の SEO データに直接アクセスできます。クロールベースの分析（既存の claude-seo スキル）と、Chrome ユーザーの実測指標、実際のインデックス登録状況、検索パフォーマンス、オーガニックトラフィックといった Google のリアルタイムな実測データとのギャップを埋めます。

すべての API は無料です。設定には API キーおよび／またはサービスアカウントを備えた Google Cloud プロジェクトが必要です。手順を確認するには /seo google setup を実行してください。

前提条件

コマンドを実行する前に、認証情報を確認します。

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check --json

設定ファイル：~/.config/claude-seo/google-api.json

{
  "service_account_path": "/path/to/service_account.json",
  "api_key": "<GOOGLE_API_KEY>",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789"
}

ファイルが見つからない場合は、references/auth-setup.md を読み、設定をユーザーに案内してください。

認証情報のティア

ティア	検出条件	利用可能なコマンド
0（API キー）	api_key が存在	pagespeed、crux、crux-history、youtube、nlp
1（OAuth/SA）	＋ OAuth トークンまたはサービスアカウント	ティア 0 ＋ gsc、inspect、sitemaps、index
2（フル）	＋ ga4_property_id が設定済み	ティア 1 ＋ ga4、ga4-pages
3（広告）	＋ ads_developer_token ＋ ads_customer_id	ティア 2 ＋ keywords、volume

コマンドを実行する前に、検出したティアを必ず伝えてください。

クイックリファレンス

コマンド	機能	ティア
/seo google setup	API 認証情報の確認／設定	--
/seo google pagespeed <url>	PSI Lighthouse ＋ CrUX 実測データ	0
/seo google crux <url>	CrUX 実測データのみ（p75 指標）	0
/seo google crux-history <url>	25 週間の CWV トレンド分析	0
/seo google gsc <property>	Search Console：クリック数、表示回数、CTR、掲載順位	1
/seo google inspect <url>	URL 検査：インデックス状況、正規 URL、クロール情報	1
/seo google inspect-batch <file>	ファイルから URL を一括検査	1
/seo google sitemaps <property>	GSC サイトマップのステータス	1
/seo google index <url>	Indexing API に URL を送信	1
/seo google index-batch <file>	最大 200 件の URL を一括送信	1
/seo google ga4 [property-id]	GA4 オーガニックトラフィックレポート	2
/seo google ga4-pages [property-id]	オーガニック流入のランディングページ上位	2
/seo google youtube <query>	YouTube 動画検索（視聴回数、高評価数、再生時間）	0
/seo google youtube-video <id>	YouTube 動画の詳細と上位コメント	0
/seo google nlp <url-or-text>	NLP によるエンティティ抽出、センチメント、分類	0
/seo google entities <url-or-text>	エンティティ分析のみ（E-E-A-T 用）	0
/seo google keywords <seed>	Google Ads キーワードプランナーからキーワード候補を取得	3
/seo google volume <keywords>	キーワードプランナーから検索ボリュームを取得	3
/seo google entity <query>	ナレッジグラフのエンティティを確認	0
/seo google safety <url>	Web Risk による URL 安全性チェック	0
/seo google quotas	すべての API のレート制限を表示	--

---

PageSpeed ＋ CrUX

/seo google pagespeed <url>

Lighthouse のラボデータと CrUX の実測データを組み合わせます。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run pagespeed_check.py <url> --json リファレンス： references/pagespeed-crux-api.md（Core Web Vitals のしきい値：references/crux-history-api.md） Lighthouse のビルド番号： 最新リリースと決めつけず、出力の lighthouse_version フィールドを報告してください。 デフォルト： モバイルとデスクトップの両方のストラテジーを使用し、すべての Lighthouse カテゴリを対象にします。

出力では、ラボスコア（特定時点の Lighthouse）と実測データ（過去 28 日間の Chrome ユーザー指標）が統合されます。CrUX はまず URL レベルのデータを取得し、取得できない場合はオリジンレベルにフォールバックします。

/seo google crux <url>

CrUX の実測データのみを取得します（Lighthouse は実行しません）。より高速です。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run pagespeed_check.py <url> --crux-only --json

/seo google crux-history <url>

25 週間の CrUX 履歴トレンドです。CWV 指標が改善、安定、悪化のいずれに向かっているかを示します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run crux_history.py <url> --json リファレンス： references/crux-history-api.md

出力には、指標ごとのトレンドの方向、変化率、週ごとの p75 値が含まれます。

---

Search Console

/seo google gsc <property>

検索アナリティクス：過去 28 日間のクリック数、表示回数、CTR、掲載順位です。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_query.py --property <property> --json リファレンス： references/search-console-api.md デフォルト： 期間は 28 日間、ディメンションは query,page、種類は web、上限は 1000 件です。

EU のサイトでは、CTR や GA4 の減少を解釈する前に references/dma-consent-mode-v2.md を確認してください。DMA と Consent Mode v2 により、Search Console と GA4 に記録される内容が変わります。

クイックウィンの検出機能も含まれます。表示回数が多く、掲載順位が 4～10 位のクエリを検出します。 totals ブロックは、クエリ単位の行では匿名化された低トラフィックが省略されることがあるため、ディメンションを指定しない別の集計クエリから取得されます。totals_complete が true の場合に限り、合計値をサイト全体の値として扱ってください。--limit は返されるディメンション行の合計数を上限とするもので、ページネーションの各リクエストのサイズを制限するものではありません。

GSC の AI サーフェス（2026 年）：

• 生成 AI パフォーマンス レポート（2026-06-03 に公開）は、AI Overviews + AI Mode での可視性を確認できる専用ビューです。表示回数のみ（クリック数／CTR／掲載順位／クエリはなし）で、ディメンションはページ／国／デバイス／日付（太平洋時間）です。上限は 1,000 行で、最新のデータは暫定値です。Discover 向けの生成 AI レポートも別途あります。2026-08-31 以降、世界中のすべてのウェブサイトで利用可能です（2026-06-03 に一部で公開）。日付は時間、日、週、月単位の粒度に対応しています。
• マルチモーダル検索タイプ（2026-09-24 以降、世界中で段階的に提供中）は、Lens、Circle to Search、画像のアップロード、Chrome の「Search this image」からの訪問を対象とする、検索結果レポートと生成 AI パフォーマンス レポートのフィルターです。UI からエクスポートできます。Search Analytics API の type 値として確認されたものはないため、値を推測してはいけません。
• AI Mode はすでに標準のパフォーマンス合計に含まれています（検索タイプは Web）。AI Mode でのクリック（外部リンクのクリック）と表示回数は通常のレポートにカウントされるため、合計値から「従来型」と「AI」のトラフィックを明確に分けることはできません。AI の表示回数のみの可視性を確認するには、生成 AI レポートを使用してください。
• データ信頼性に関する注意： GSC のログ記録エラーにより、2025-05-13 から 2026-04-27 まで、表示回数、CTR、平均掲載順位の信頼性が低下していました（クリック数への影響はありません。修正は以降のデータのみで、バックフィルはありません）。この期間にまたがる表示回数／CTR／掲載順位のトレンドは慎重に扱ってください。修正後に表示回数が見かけ上減少することが予想されます。

プラットフォームのプロパティ（2026 年）： Search Console では、認証済みの TikTok、 Instagram、X、YouTube アカウントをそれぞれ個別のプロパティとして表示できます。すでに登録済みの Search プロフィールを通じて追加されている場合を除き、アカウントごとに認証してください。これらのプロパティは Google 検索のパフォーマンス確認に使用し、各プラットフォーム独自のアナリティクスの代わりには使用しないでください。参照元： developers.google.com/search/docs/monitor-debug/analyze-social-video-content

/seo google inspect <url>

URL 検査：Google による実際のインデックス登録状況を確認します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_inspect.py <url> --json

結果には、判定（PASS/FAIL）、カバレッジの状態、robots.txt の状態、インデックス登録の状態、ページ取得の状態、正規 URL の選択、リッチリザルトが含まれます。API では mobileUsabilityResult は非推奨のため、モバイルユーザビリティの確認結果として報告しないでください。

/seo google inspect-batch <file>

ファイルからの一括検査（1 行に URL を 1 つ指定）。サイトあたりの上限は 1 日 2,000 件です。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_inspect.py --batch <file> --json

/seo google sitemaps <property>

送信済みのサイトマップを、ステータス、エラー、警告とともに一覧表示します。サイトマップの内容レポートに表示されるのは送信数のみです。特定の URL がインデックスに登録されているかどうかは、URL 検査 API で確認してください。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run gsc_query.py sitemaps --property <property> --json

---

インデックス登録 API

/seo google index <url>

URL の更新を Google に通知します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run indexing_notify.py <url> --json リファレンス： references/indexing-api.md

インデックス登録 API の正式な対象は、JobPosting および BroadcastEvent/VideoObject のページです。この制限を必ずユーザーに伝えてください。1 日あたりの割り当ては、公開リクエスト 200 件です。

/seo google index-batch <file>

ファイル内の URL を一括送信します。割り当ての使用状況を追跡します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run indexing_notify.py --batch <file> --json

---

GA4 トラフィック

/seo google ga4 [property-id]

オーガニックトラフィックのレポートです。日別のセッション数、ユーザー数、ページビュー数、直帰率、エンゲージメントを表示します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ga4_report.py --property <id> --json リファレンス： references/ga4-data-api.md デフォルト： 過去 28 日間。オーガニック検索チャネルグループで絞り込みます。

GA4 の「AI Assistants」チャネル（2026-05-13 頃に提供開始）： GA4 にネイティブの「AI Assistants」デフォルトチャネルグループが追加されました。認識対象の AI アシスタントから参照されたセッションには、medium=ai-assistant が設定されます。Google が認識する参照元は ChatGPT、Gemini、Claude、Deepseek、Copilot、Grok で、このチャネルは Google AI Overviews / AI Mode を除外します。必要に応じて Perplexity は個別に確認してください。未対応の参照元は「Referral」に分類される場合があります。また、AI セッションの多くは参照元情報がなく、「Direct」に分類されるため、このチャネルでは AI トラフィックが過少に計測されます。今後のデータのみが対象で、過去データの補完はありません。

/seo google ga4-pages [property-id]

セッション数の多い順に、オーガニック検索のランディングページを表示します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ga4_report.py --property <id> --report top-pages --json

---

YouTube（動画 SEO）

サードパーティの調査では、YouTube での言及と AI における可視性との相関係数が 0.737 と報告されているものもあります。手法に依存する指標として扱ってください。無料で、必要なのは API キーのみです。

/seo google youtube <query>

YouTube の動画を検索します。タイトル、チャンネル、再生回数、高評価数、再生時間を返します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run youtube_search.py search "<query>" --json リファレンス： references/youtube-api.md 割り当て： 検索 1 回につき 100 単位（無料枠は 1 日あたり 10,000 単位）。

/seo google youtube-video <video_id>

動画の詳細情報、タグ、上位 10 件のコメントを表示します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run youtube_search.py video <video_id> --json 割り当て： 2 単位（動画の詳細情報とコメント）。

---

NLP コンテンツ分析

社内のコンテンツ品質チェックに使用する、Google NLP のエンティティ／感情分析結果です。Google の E-E-A-T スコアとして扱わないでください。

/seo google nlp <url-or-text>

NLP の完全な分析を行います。エンティティ、感情、コンテンツ分類を確認できます。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run nlp_analyze.py --url <url> --json または --text "..." リファレンス： references/nlp-api.md 無料枠： 月 5,000 単位。GCP プロジェクトで課金を有効にする必要があります。

/seo google entities <url-or-text>

エンティティのみを抽出します（より高速で、割り当ての消費も少なくなります）。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run nlp_analyze.py --url <url> --features entities --json

---

キーワード調査（Google Ads）

基準となるキーワード検索ボリュームのデータです。Google Ads アカウントが必要です。

/seo google keywords <seed>

シードキーワードからキーワード候補を生成します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run keyword_planner.py ideas "<seed>" --json リファレンス： references/keyword-planner-api.md 必要なもの： 設定に Ads デベロッパートークンと顧客 ID（Tier 3）が必要です。

/seo google volume <keywords>

特定のキーワード（カンマ区切り）の検索ボリュームを調べます。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run keyword_planner.py volume "<kw1>,<kw2>" --json

---

補足

/seo google entity <query>

ナレッジグラフのエンティティを確認します。ブランドの掲載状況を検証します。

参考： references/supplementary-apis.md API キーを使用してナレッジグラフ検索 API を利用します。

/seo google safety <url>

Web Risk API でマルウェア／ソーシャルエンジニアリングのフラグを確認します。

参考： references/supplementary-apis.md

/seo google quotas

レート制限の表を表示します。references/rate-limits-quotas.md を読み込みます。

---

レポート

分析コマンドの実行後、PDF／HTML レポートの生成を提案します。

/seo google report <type>

グラフと分析を含むプロフェッショナルな PDF レポートを生成します。

スクリプト： "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type <type> --data <json> --domain <domain> --format pdf

種類	入力	出力
cwv-audit	PSI + CrUX + CrUX 履歴データ	ゲージ、タイムライン、分布を含む Core Web Vitals 監査
gsc-performance	GSC クエリデータ	クエリテーブルと改善機会を含む Search Console レポート
indexation	一括検査データ	カバレッジのドーナツチャートを含むインデックス登録状況
full	すべてのデータを統合	Google SEO の包括的なレポート（全セクション）

ワークフロー：

1. データ収集コマンド（pagespeed、gsc、inspect-batch など）を実行します
2. JSON 出力をファイルに保存します："${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run pagespeed_check.py <url> --json > data.json
3. レポートを生成します："${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type cwv-audit --data data.json --domain <domain>

運用ルール： 分析完了後、「レポートを生成しますか？ /seo google report <type> を使用してください」と提案します。

---

レート制限

API	分あたり	日あたり	認証
PSI v5	240 QPM	25,000 QPD	API キー
CrUX + History	150 QPM（共有）	無制限	API キー
GSC Search Analytics	1,200 QPM/site	30M QPD	サービスアカウント
GSC URL Inspection	600 QPM	2,000 QPD/site	サービスアカウント
Indexing API	380 RPM	200 publish/day	サービスアカウント
GA4 Data API	10 concurrent	~25K tokens/day	サービスアカウント

スキル間の連携

• seo-audit：ライブの CWV とインデックス登録データを取得するため、seo-google エージェントを起動します（条件付き）
• seo-technical：実際の CWV フィールドデータに pagespeed_check.py を使用します
• seo-performance：CrUX のフィールドデータで Lighthouse のラボデータを補完します
• seo-sitemap：GSC のサイトマップステータスには、送信済み数、エラー、警告が表示されます。インデックス登録の実態を確認するには URL Inspection を使用してください
• seo-content：GSC のクエリデータをキーワードターゲティングに活用します
• seo-geo：GSC の生成 AI パフォーマンスレポートと、AI Overviews／AI Mode／Discover の生成 AI 含める／除外する設定（Search の生成 AI プロパティ設定。2026-08-31 以降、すべてのサイトで利用可能）を使用します

出力形式

• CWV 指標：信号機形式の評価（良好／要改善／不良）
• パフォーマンスレポート：並べ替え可能な列を含むテーブル
• 常にデータの鮮度に関する注記を含めます
• レポートを GOOGLE-API-REPORT-{domain}.md として保存します
• Markdown／LLM テンプレートは assets/templates/ にあります：cwv-audit-report.md、gsc-performance-report.md、indexation-status-report.md。これらは google_report.py の PDF 生成パイプラインとは別です

技術上の注意

• INP は 2024 年 3 月 12 日に FID に取って代わりました。FID には決して言及しないでください。
• CrUX の CLS 値は文字列としてエンコードされています（例：「0.05」）。スクリプトが解析を処理します。
• CrUX の 404 はトラフィック不足を意味し、認証エラーではありません。
• Search Analytics のデータには 2～3 日の遅延があります。
• CrUX では effectiveConnectionType に代わり round_trip_time が使用されます（2025 年 2 月）。
• Custom Search JSON API は、新規顧客への提供を終了しています（2025 年）。

エラー処理

シナリオ	対応
認証情報が設定されていない	/seo google setup を実行します。API キーだけで使用できる Tier 0 コマンドを一覧表示します。
サービスアカウントに GSC へのアクセス権がない	エラーを報告します。client_email を GSC > Settings > Users > Add に追加するよう指示します。
CrUX データを利用できない（404）	Chrome のトラフィックが不十分であることを報告します。代替として PSI のラボデータを提案します。
GA4 プロパティが見つからない	エラーを報告します。GA4 Admin > Property Details でプロパティ ID を確認する方法を示します。
Indexing API のクォータを超過した	1 日あたり 200 件の上限を報告します。最も重要な URL を優先するよう提案します。
レート制限（429）	待機してから、指数バックオフで再試行します。上限に達した API を報告します。