seo-google

Google SEO API

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

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

前提条件

コマンドを実行する前に、認証情報を確認してください。

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

設定ファイル：~/.config/seo-skills/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 キー）	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>	インデックス登録 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 の実測データを組み合わせます。

スクリプト： 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 履歴トレンドです。CWV メトリクスが改善、安定、または悪化しているかを示します。

スクリプト： python scripts/crux_history.py <url> --json リファレンス： references/pagespeed-crux-api.md

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

---

Search Console

/seo google gsc <property>

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

スクリプト： python scripts/gsc_query.py --property <property> --json リファレンス： references/search-console-api.md デフォルト： 28日間、ディメンション=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行につきURLを1つ指定）。サイトごとの上限は1日2,000件です。

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

/seo google sitemaps <property>

送信済みサイトマップを、ステータス、エラー、警告とともに一覧表示します。

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

---

インデックス登録 API

/seo google index <url>

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

スクリプト： python scripts/indexing_notify.py <url> --json リファレンス： references/indexing-api.md

Indexing API の公式な対象は、JobPosting および BroadcastEvent/VideoObject ページです。この制限について、必ずユーザーに伝えてください。1日の割り当ては公開リクエスト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日間、Organic Search チャネルグループでフィルタリングします。

/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 を設定に登録してください（Tier 3）。

/seo google volume <keywords>

指定したキーワードの検索ボリュームを取得します（カンマ区切り）。

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

---

補足

/seo google entity <query>

ナレッジグラフのエンティティを確認します。ブランドの認知度を検証します。

リファレンス： 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	1 分あたり	1 日あたり	認証
PSI v5	240 QPM	25,000 QPD	API Key
CrUX + History	150 QPM（共有）	無制限	API Key
GSC Search Analytics	1,200 QPM/site	30M QPD	Service Account
GSC URL Inspection	600 QPM	2,000 QPD/site	Service Account
Indexing API	380 RPM	200 publish/day	Service Account
GA4 Data API	10 concurrent	~25K tokens/day	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 日の遅延があります。
• CrUX では effectiveConnectionType が round_trip_time に置き換えられました（2025 年 2 月）。
• Custom Search JSON API は新規顧客への提供を終了しています（2025 年）。

エラー処理

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