Google SEO APIs

Google の SEO データへの直接アクセス。クローリングベースの分析（既存の claude-seo スキル）と Google のリアルタイムフィールドデータ（実際の Chrome ユーザーメトリクス、実際のインデックス状態、検索パフォーマンス、オーガニックトラフィック）の間のギャップを埋めます。

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

前提条件

いずれのコマンドも実行する前に、認証情報を確認してください：

python scripts/google_auth.py --check --json

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

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

ファイルが見つからない場合は、references/auth-setup.md を読み、ユーザーをセットアップのプロセスに沿って進めてください。

認証情報のティア

ティア	検出方法	利用可能なコマンド
0 (API Key)	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>	Knowledge Graph エンティティチェック	0
/seo google safety <url>	Web Risk URL セーフティチェック	0
/seo google quotas	すべての API のレート制限を表示	--

---

PageSpeed + CrUX

/seo google pagespeed <url>

Lighthouse ラボデータと CrUX フィールドデータを結合します。

スクリプト: python scripts/pagespeed_check.py <url> --json 参考: references/pagespeed-crux-api.md デフォルト: モバイル + デスクトップ両方の戦略、すべての Lighthouse カテゴリ。

出力はラボスコア（ポイントインタイム Lighthouse）とフィールドデータ（28 日間の Chrome ユーザーメトリクス）を結合します。CrUX は URL レベルを最初に試し、オリジンレベルにフォールバックします。

/seo google crux <url>

CrUX フィールドデータのみ（Lighthouse 実行なし）。より高速です。

スクリプト: python scripts/pagespeed_check.py <url> --crux-only --json

/seo google crux-history <url>

25 週間の CrUX History トレンド。CWV メトリクスが改善、安定、または低下しているかどうかを示します。

スクリプト: python scripts/crux_history.py <url> --json 参考: references/pagespeed-crux-api.md

出力には、メトリクスごとのトレンド方向、パーセンテージ変化、週別の p75 値が含まれます。

---

Search Console

/seo google gsc <property>

Search Analytics: 過去 28 日間のクリック数、インプレッション数、CTR、順位。

スクリプト: python scripts/gsc_query.py --property <property> --json 参考: references/search-console-api.md デフォルト: 28 日間、dimensions=query,page、type=web、limit=1000。

クイックウィン検出を含みます：順位 4～10 かつ高いインプレッション数のクエリ。

/seo google inspect <url>

URL インスペクション: Google からの実際のインデックス状態。

スクリプト: python scripts/gsc_inspect.py <url> --json

戻り値：判定（PASS/FAIL）、カバレッジ状態、robots.txt 状態、インデックス状態、ページ フェッチ状態、正規 URL 選択、モバイルユーザビリティ、リッチリザルト。

/seo google inspect-batch <file>

ファイルからのバッチインスペクション（1 行に 1 つの URL）。1 日あたりサイトごとに 2,000 件に制限されます。

スクリプト: python scripts/gsc_inspect.py --batch <file> --json

/seo google sitemaps <property>

送信済みサイトマップを状態、エラー、警告付きでリスト表示します。

スクリプト: python scripts/gsc_query.py sitemaps --property <property> --json

---

Indexing API

/seo google index <url>

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

スクリプト: python scripts/indexing_notify.py <url> --json 参考: references/indexing-api.md

Indexing API は公式には JobPosting および BroadcastEvent/VideoObject ページ用です。この制限について必ずユーザーに通知してください。日次クォータ: 200 件のパブリッシュ要求。

/seo google index-batch <file>

ファイルから URL をバッチ送信します。クォータ使用量を追跡します。

スクリプト: python scripts/indexing_notify.py --batch <file> --json

---

GA4 トラフィック

/seo google ga4 [property-id]

オーガニックトラフィックレポート: 日次セッション数、ユーザー数、ページビュー数、バウンスレート、エンゲージメント。

スクリプト: python scripts/ga4_report.py --property <id> --json 参考: references/ga4-data-api.md デフォルト: 28 日間、オーガニック検索チャネルグループでフィルタリング済み。

/seo google ga4-pages [property-id]

セッション数でランク付けされたオーガニック トップ着地ページ。

スクリプト: python scripts/ga4_report.py --property <id> --report top-pages --json

---

YouTube（動画 SEO）

YouTube の言及は最も強い AI 可視性相関性を持ちます（0.737）。無料、API キーのみが必要です。

/seo google youtube <query>

YouTube 内で動画を検索します。タイトル、チャネル、再生数、高評価数、長さを返します。

スクリプト: python scripts/youtube_search.py search "<query>" --json 参考: references/youtube-api.md クォータ: 1 回の検索あたり 100 ユニット（1 日あたり 10,000 ユニット無料）。

/seo google youtube-video <video_id>

詳細な動画情報 + タグ + 上位 10 件のコメント。

スクリプト: python scripts/youtube_search.py video <video_id> --json クォータ: 2 ユニット（動画の詳細 + コメント）。

---

NLP コンテンツ分析

Google 独自のエンティティ/センチメント分析。E-E-A-T スコアリングを強化します。

/seo google nlp <url-or-text>

フル NLP 分析：エンティティ、センチメント、コンテンツ分類。

スクリプト: python scripts/nlp_analyze.py --url <url> --json または --text "..." 参考: references/nlp-api.md 無料利用枠: 月 5,000 ユニット。GCP プロジェクトで課金を有効化する必要があります。

/seo google entities <url-or-text>

エンティティ抽出のみ（より高速で、クォータ消費が少ない）。

スクリプト: python scripts/nlp_analyze.py --url <url> --features entities --json

---

キーワード リサーチ（Google Ads）

ゴールドスタンダードのキーワード ボリュームデータ。Google Ads アカウントが必要です。

/seo google keywords <seed>

シード用語からキーワード提案を生成します。

スクリプト: python scripts/keyword_planner.py ideas "<seed>" --json 参考: references/keyword-planner-api.md 必須: 設定に Ads デベロッパー トークン + カスタマー ID が必要（ティア 3）。

/seo google volume <keywords>

特定のキーワード（カンマで区切られた）の検索ボリューム。

スクリプト: python scripts/keyword_planner.py volume "<kw1>,<kw2>" --json

---

補助機能

/seo google entity <query>

Knowledge Graph エンティティチェック。ブランド プレゼンスを検証します。

参考: references/supplementary-apis.md API キーで Knowledge Graph Search 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 レポートを生成します。

スクリプト: python scripts/google_report.py --type <type> --data <json> --domain <domain> --format pdf

タイプ	入力	出力
cwv-audit	PSI + CrUX + CrUX History データ	Core Web Vitals 監査（ゲージ、タイムライン、分布）
gsc-performance	GSC クエリデータ	Search Console レポート（クエリテーブル、クイックウィン）
indexation	バッチインスペクション データ	インデックス状態レポート（カバレッジ ドーナッツチャート）
full	すべてのデータを結合	包括的な Google SEO レポート（すべてのセクション）

ワークフロー:

1. データ収集コマンドを実行（pagespeed、gsc、inspect-batch など）
2. JSON 出力をファイルに保存: python scripts/pagespeed_check.py <url> --json > data.json
3. レポートを生成: python scripts/google_report.py --type cwv-audit --data data.json --domain <domain>

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

---

レート制限

API	分別	日別	認証
PSI v5	240 QPM	25,000 QPD	API Key
CrUX + History	150 QPM（共有）	無制限	API Key
GSC Search Analytics	1,200 QPM/サイト	30M QPD	Service Account
GSC URL Inspection	600 QPM	2,000 QPD/サイト	Service Account
Indexing API	380 RPM	200 件のパブリッシュ/日	Service Account
GA4 Data API	10 同時	約 25K トークン/日	Service Account

クロススキル統合

• seo-audit: ライブ CWV + インデックス状態データ用に seo-google エージェントを起動（条件付き）
• seo-technical: 実際の CWV フィールドデータに pagespeed_check.py を使用
• seo-performance: CrUX フィールドデータが Lighthouse ラボデータを補完
• seo-sitemap: GSC サイトマップ状態は実際のクロール/インデックス カバレッジを表示
• seo-content: GSC クエリデータがキーワード ターゲティングに情報を提供
• seo-geo: GSC 検索表示データに AI Overview の参照を含む

出力形式

• CWV メトリクス：トラフィックライト評価（Good / Needs Improvement / Poor）
• パフォーマンスレポート：ソート可能な列を含むテーブル
• データの鮮度に関する注記を必ず含める
• レポートを GOOGLE-API-REPORT-{domain}.md として保存
• 構造化出力に assets/templates/ のテンプレートを使用

技術的な注記

• INP は 2024 年 3 月 12 日に FID に置き換わりました。FID には決して言及しないでください。
• CrUX からの CLS 値は文字列エンコードされています（例："0.05"）。スクリプトはパースを処理します。
• CrUX 404 = 不十分なトラフィック、認証エラーではありません。
• Search Analytics データには 2～3 日間の遅延があります。
• round_trip_time が CrUX の effectiveConnectionType に置き換わりました（2025 年 2 月）。
• Custom Search JSON API は新規顧客に対して閉鎖されています（2025 年）。

エラーハンドリング

シナリオ	アクション
認証情報が設定されていない	/seo google setup を実行してください。API キーのみで動作するティア 0 のコマンドをリストアップしてください。
サービスアカウントが GSC へのアクセス権を持たない	エラーを報告してください。指示：client_email を GSC > 設定 > ユーザー > 追加に追加します。
CrUX データが利用できない（404）	Chrome トラフィックが不足していることを報告してください。代替案として PSI ラボデータを提案してください。
GA4 プロパティが見つからない	エラーを報告してください。GA4 管理者 > プロパティ詳細でプロパティ ID を見つける方法を示してください。
Indexing API クォータ超過	1 日 200 件の制限を報告してください。最も重要な URL の優先順位付けを提案してください。
レート制限（429）	エクスポーネンシャル バックオフで待機して再試行してください。どの API が制限に達したかを報告してください。