Communitygithub.com

Heraut SEO

Webサイトとそのサーバーに対して詳細なSEO調査を読み取り専用で実施し、「なぜGoogleがこのサイトをインデックスせず、訪問者も送ってこないのか、そして具体的にどう対処すべきか」を明らかにします。Google Search Console、GA4、サーバーログ、コード、外部データの4トラックを並行実行し、コンサルティング的な統合レポートを生成します。

Heraut SEO とは?

Heraut SEOは、有機的なトラフィックが得られない、ブログ記事がインデックスされない、SEO施策やコンテンツパイプラインが測定可能な成果を生まない、といったWebサイトの問題を診断するための、専門的な読み取り専用スキルです。このスキルは、Google Search Console(GSC)とGA4のデータ(層化サンプリングによるURL検査を含む)、サーバーログ(DNS検証済みGooglebotの活動、速度、ブロック状況の分析)、コードとコンテンツ(Googleが実際に読み取るページの状態)、および外部データ(DataForSEOによるSERPs、ランキング、バックリンク、Perplexityによる深層リサーチ)の4つのトラックを並行して実行します。各トラックは独立したサブエージェントとして動作し、その結果を統合することで、表面的な仮説ではなく根本原因を特定します。最終的には、現状分析、問題点、課題、因果関係ツリー、段階的な改善計画、30/60/90日後のKPI、オーナーによる意思決定を含む、コンサルティング形式のレポートを生成します。このスキルは、Claude CodeなどのAIエージェント環境で使用することを想定しており、PythonスクリプトとOpenSSLを用いて実装されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/koffih/claude-skill-heraut-seo/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Heraut SEO は何をしますか?

ヘラルド(伝令)は、ドメインを世に知らしめる存在です。誰もその声を聞かないとき、このスキルはその理由を、すべての主張に証拠を添えて調査し、オーナーが実行に移せる計画を返します。

これは実際のケースから生まれました。58,000のURLと1,000の生成記事を持つサイトで、コンテンツ責任者が毎日予算を費やしているにもかかわらず、ブログのインプレッションはゼロ。答えは責任者が考えた場所(記事の書き換え)ではなく、サイト全体の品質、権威、需要にありました。以下の方法は、最初の仮説を確認するのではなく、そのような答えを見つけるために構築されています。

ルール

  1. 読み取り専用、あらゆる場所で。 本番環境への変更、データベースへの書き込み、再起動は行いません。Googleに何も送信しません(インデックス登録リクエスト、サイトマップの追加・削除は行いません)。調査は記述を行い、計画は後で、一度に一つの決定した変更を適用します。
  2. すべての主張に証拠を添える。 コマンド、数値、日付、ファイル。測定されたもの(MEASURED)と推測されたもの(SUPPOSED)を明記します。サンプルはカウントではありません。nを明示します。
  3. サイトに優しく。 一度に1リクエスト、少なくとも1.5秒の間隔(politesse.delai_s)を空けます。小さなサーバーは監査に弱いです。
  4. 有料APIは上限付きで。 budgets.dataforseo_usdとbudgets.perplexity_usdは、スクリプトによって各呼び出しの前に強制され、すべてのコストが記録されます。総支出額を報告します。
  5. 出力に秘密情報を含めない。 キーがどこにあるかは名前を示しますが、その値は決して出力しません。スクリプトは環境変数、または設定ファイルに指定されたenvファイルからキーを読み取ります。

ファイルの場所

スクリプトはscripts/にあります(通常は~/.claude/skills/heraut-seo/scripts)。Python標準ライブラリのみを使用し、Googleトークンにはopensslを使用します。すべてのスクリプトは--config <site.json> --dossier <investigation folder>を受け取り、CSVとJSONをそこに書き込み、さらに最初に読み取るためのresume.jsonも出力します。

スクリプトトラック処理内容
sitemap.pycodeサイトマップツリー全体、すべてのURLのタイと言語、lastmodの正確性、重複
gsc.py performancegoogle16ヶ月分の月別・ページタイプ別データ、過去28日間と比較、クエリ、国、セクション
gsc.py sitemapsgoogle送信されたサイトマップ、エラー、保留中、Googleが最後に読み取った日時
gsc.py echantillon / inspecter / analysergoogle層化URL検査(1日2,000件のクォータ、再開可能)、タイプ別カバレッジ、前回実行からの変化
ga4.pygoogle1年間のチャネル別データ、Googleオーガニック(過去と現在)、AIアシスタント、ボット的なシェア
pages.pycodeサンプルページの読み取り:言語、canonical、hreflang、robots、単語数、JSON-LD、ブログへのリンク、Googlebotとブラウザの比較
logs.pyserver実際のGooglebot(DNS検証済み)の日別・タイプ別アクセス、無駄、応答時間、フォローされたURLの初回訪問
ttfb.pyserverタイプ別の最初の1バイトまでの時間(TTFB)、ウォーム、コールド、オリジン
dataforseo.pyoutside実際のSERP、ランキングキーワード、サイトと競合のバックリンク、ボリューム、bilan
perplexity.pyoutside日付とソース付きの深層リサーチ(Agent API、effort)

調査のステップバイステップ

0. フレーミング(10分、必要に応じてオーナーと)

  • オーナーの質問をそのままの言葉で書き、症状を数値(インプレッション、クリック、公開記事数、費やした金額)で記録します。
  • 既に分かっていること(過去の監査、メモ、コンテンツパイプラインとそのデータベース)を確認します。それらはコピーする事実ではなく、検証すべき仮説として扱います。
  • config.example.jsonからサイト設定ファイルを作成します:ドメイン、サイトマップ、言語、正規表現によるページタイプ(最も重要な部分:すべてのカウントはタイプごとに行います)、追跡するセクション(ブログ)、Search Consoleプロパティ、GA4 ID、サービスアカウントキーのパス、市場(DataForSEOのロケーションコード)、3~6の競合サイト、ユーザーが実際に入力する15~30のクエリ、予算。
  • 開始前にアクセスを確認します:gsc.py sitemapsが応答すること、GA4が応答すること、ログが読み取り可能であること(多くの場合、rootとadmグループのみがアクセス可能:オーナーに依頼し、拒否を回避しないこと)。

1. 4つのトラックを並行実行

enquete-YYYY-MM-DD/フォルダをサイトの他の監査ファイルの隣に作成し、references/brief.mdからBRIEF.mdを書き込みます。その後、4つの調査者(サブエージェント)を一度に起動し、それぞれにブリーフと担当トラックファイルを与えます。各トラックは、上部に10行のサマリーがあるvolet-<track>.mdと、その生データを同じフォルダに書き込みます。

トラックファイル主要な質問
Googlereferences/track-google.mdGoogleはページを認知し、クロールし、維持しているか?良くなっているのか、悪くなっているのか?
サーバーreferences/track-server.md実際のGooglebotはアクセスしているか、何を読んでいるか、遅延やブロックの原因はあるか?
コードとコンテンツreferences/track-code-content.mdGoogleがサイトを読んだときに何を見つけるか:ページ数、コンテンツの薄さ、リンク構造、誠実さはどうか?
外部references/track-outside.md実際の検索で誰が勝っているか、その権威は何か、サイトが書いていることに需要はあるか?

最初にsitemap.pyを実行し(他のスクリプトはそこからサンプリングします)、その後トラックを実行します。gsc.py inspecterは完全なサンプルで数時間かかることがあります:バックグラウンドで実行します。

2. 統合

4つのレポートを読み、references/cause-tree.mdを使用して回答を構築します。このファイルには、実際に観察された原因、各原因を確認または除外する測定値、および落とし穴(技術監査で問題なしとされてもサイトが健全とは限らない)がリストされています。

references/report.mdに従ってレポートを作成します:最初に簡潔な回答、現状、問題点、課題、各枝に証拠を添えた因果関係ツリー、現在のプログラムが機能しない理由、各ステップに「完了条件」がある段階的計画、30/60/90日後のKPI、オーナーへの意思決定事項、調査の限界、ソース。セッションが可能であればページとして公開し(デフォルトは非公開)、そうでなければHTMLファイルとして出力します。

3. 引き継ぎ

  • オーナーにリンク、5行の核心的な診断、調査費用、測定できなかった事項を伝えます。
  • 次に意思決定事項を、1つずつ、それぞれにその根拠となる事実と推奨事項を添えて提示します。次の質問をする前に、決定された各ステップを適用します。
  • 評決とそれが意味する運用ルール(例:「コアページがインデックスされるまで新規コンテンツを作成しない」)を、プロジェクトが記憶を保持する場所に保存します。

別のサーバーやサイトで実行する

アクセス権(Search Consoleキー、ログ)があるマシンにスキルをインストールし、config.example.jsonをサイトのフォルダにコピーして記入し、ステップ0から3を実行します。調査日ごとに1つのフォルダを保持することで、次回の実行と比較できます:gsc.py analyser --avant <old inspection.jsonl>は、どのURLがインデックスに追加されたか、削除されたかをURLごとに表示します。

計画開始から60〜90日後に調査を再実行します。実行の合間には、50〜100URLの毎日のローテーション検査が、インデックスの動きを確認する最も低コストな方法です。

このスキルが行わないこと

サイトの変更、コンテンツの作成、インデックス登録リクエスト、リンクの購入は行いません。製品やビジネスモデルを判断せず、検索が人々をサイトに導くことができるかどうかのみを評価します。SEOツールのスコア(ランク、スパムスコア、推定トラフィック)はモデルであり、測定値ではありません:引用する際はその旨を明記します。

関連スキル