seo-google

seo-google 概要

seo-googleでできること

seo-google skill は、一般的なプロンプトや外部推定に頼らず、Google の SEO API に直接アクセスできるようにする skill です。Search Console、PageSpeed Insights、CrUX、Indexing API、GA4 のオーガニック流入を、ひとつのワークフローでまとめて確認したい人向けに設計されています。

こんな人・こんな作業に向いている

seo-google skill は、インデックス状況の確認、URL の精査、impressions と clicks の比較、実ユーザーデータを使った Core Web Vitals の監査、GA4 からのオーガニック流入トレンド取得に向いています。特に、SEO 担当者、テクニカルSEO、コンテンツチーム、そして提案前に Google ネイティブの根拠が必要な agent に有用です。

何が違うのか

seo-google の主な価値は、広い意味での SEO 理論ではなく、ソース・オブ・トゥルースとしてのデータにあります。クロールベースの分析と Google 公式 API をつなぐことで、「このページは問題なさそう」から「Search Console では CTR が低い」「CrUX ではモバイルの INP が悪い」へとすぐに進めます。だからこそ、通常の自由記述プロンプトよりも意思決定に強いのです。

seo-google が適しているケース

実際の Google データ、アカウント設定、API ベースの診断に依存する作業なら seo-google を選んでください。コンテンツのブレストだけがしたい場合、Google Ads へのアクセスなしでキーワード案を出したい場合、あるいはライブデータを必要としない一回限りの SEO 解説が欲しいだけなら、適していません。

seo-google skill の使い方

インストールと前提条件の確認

seo-google install の手順では、skills のワークフローから skill を追加したあと、分析を依頼する前に認証情報を確認してください。repo は Google API 認証があることを前提としており、まず実用上の依存条件になるのは ~/.config/claude-seo/google-api.json に有効な config が入っていることです。

入力の形を最初から整える

seo-google usage のパターンは、具体的な URL、property、または目的を渡したときに最もよく機能します。たとえば、「https://example.com/pricing の indexation と CWV を監査して」「sc-domain:example.com の過去 28 日の GSC queries を比較して」「ブログセクションの GA4 organic landing pages を確認して」といった入力が適切です。「SEO を改善して」のような曖昧な依頼は避けてください。API は対象と日付範囲を必要とします。

先に読むべきファイル

信頼性の高い seo-google の案内にするなら、まず SKILL.md を確認し、次に references/auth-setup.md、references/search-console-api.md、references/pagespeed-crux-api.md、references/ga4-data-api.md を読みます。通知や submit/inspect のフローが関係するなら references/indexing-api.md も確認してください。keyword research を扱うなら references/keyword-planner-api.md を使います。

結果がよくなるワークフロー

実用的な流れは、認証の確認、データソースの特定、property または URL の決定、期間の指定、そして必要な metrics だけを依頼することです。たとえば、「seo-google を使って、sc-domain:example.com の Search Analytics を過去 28 日分確認し、impressions は多いのに CTR が低いページを抽出して、書き換え候補の title も説明して」といった依頼です。これは、skill に何を取得し、どう出力を組み立てるかを明確に伝えられるため、広い SEO レビューよりも優れています。

seo-google skill の FAQ

seo-google は Search Console 専用ですか？

いいえ。Search Console は中心ですが、seo-google skill は PageSpeed Insights、CrUX、Indexing API、GA4 のオーガニックデータも扱います。インデックス、パフォーマンス、トラフィック診断を別々のプロンプトに分けず、ひとつの skill で見たい場合に重要です。

API key と service account の両方が必要ですか？

フルカバーを狙うなら、通常は両方必要です。PageSpeed Insights と CrUX には API key で十分ですが、Search Console、Indexing API、GA4 には service account が必要です。最も使い勝手がよいのは、両方を設定している状態です。

seo-google で Keyword Research はできますか？

はい。ただし条件があります。seo-google の Keyword Research は Google Ads / Keyword Planner へのアクセスに依存し、他の API より設定がやや重めです。Google 由来のボリュームや予測データが必要なときに向いており、単に素早いテーマ案だけ欲しい場合には向きません。

いつこの skill を使わないべきですか？

認証情報がない、検証済み property がない、または一般的な SEO チェックリストだけが欲しい場合は seo-google を使わないでください。また、強みが API ベースの根拠であって草案作成ではないため、純粋なコンテンツ生成にも最適ではありません。

seo-google skill を改善するには

判断に使える文脈を最初から渡す

結果を最速でよくするには、property の種類、URL パターン、日付範囲、デバイスの焦点、成功指標を含めることです。たとえば、「/blog/ 配下の mobile CWV」「impressions > 1,000 かつ CTR < 2% の GSC pages」「ブランド系 landing pages を除外した過去 90 日の GA4 organic traffic」などです。これにより、seo-google は大まかな要約ではなく、実行可能な切り口を返しやすくなります。

一度に 1 本の分析に絞って依頼する

indexation、rankings、Core Web Vitals、traffic を別々の task に分けるほうが、skill の精度は上がります。「URL inspection、次に GSC、その次に GA4 を見て」とまとめて依頼すると出力が散らかりがちです。まずは 1 つの流れだけを頼み、その結果を見て次を絞り込むほうがよいです。

よくある失敗パターンに注意する

最も多い障害は、認証の不足、property 形式の誤り、そして取得できないデータを skill に推測させようとすることです。もう 1 つ多いのは、seed terms が足りない、または Google Ads の credentials がない状態で、範囲の広い keyword 要求をしてしまうケースです。seo-google に keyword research を頼むなら、アイデアが欲しいのか、過去の volume が欲しいのか、forecast が欲しいのかを明確にしてください。

直感ではなく証拠から絞り込む

最初の出力を見たら、「impressions は多いのに clicks が少ないページ」「mobile だけ INP が悪い URL」「最近公開したページの indexing failure」など、実際に見えた異常をそのまま追加で指定してください。これで seo-google は診断ループとして機能し、2 回目の確認が、1 回だけの一般的な監査よりずっと役立つようになります。