Heraut SEO は何をしますか?
ヘラルド(伝令)は、ドメインを世に知らしめる存在です。誰もその声を聞かないとき、このスキルはその理由を、すべての主張に証拠を添えて調査し、オーナーが実行に移せる計画を返します。
これは実際のケースから生まれました。58,000のURLと1,000の生成記事を持つサイトで、コンテンツ責任者が毎日予算を費やしているにもかかわらず、ブログのインプレッションはゼロ。答えは責任者が考えた場所(記事の書き換え)ではなく、サイト全体の品質、権威、需要にありました。以下の方法は、最初の仮説を確認するのではなく、そのような答えを見つけるために構築されています。
ルール
- 読み取り専用、あらゆる場所で。 本番環境への変更、データベースへの書き込み、再起動は行いません。Googleに何も送信しません(インデックス登録リクエスト、サイトマップの追加・削除は行いません)。調査は記述を行い、計画は後で、一度に一つの決定した変更を適用します。
- すべての主張に証拠を添える。 コマンド、数値、日付、ファイル。測定されたもの(MEASURED)と推測されたもの(SUPPOSED)を明記します。サンプルはカウントではありません。nを明示します。
- サイトに優しく。 一度に1リクエスト、少なくとも1.5秒の間隔(
politesse.delai_s)を空けます。小さなサーバーは監査に弱いです。 - 有料APIは上限付きで。
budgets.dataforseo_usdとbudgets.perplexity_usdは、スクリプトによって各呼び出しの前に強制され、すべてのコストが記録されます。総支出額を報告します。 - 出力に秘密情報を含めない。 キーがどこにあるかは名前を示しますが、その値は決して出力しません。スクリプトは環境変数、または設定ファイルに指定されたenvファイルからキーを読み取ります。
ファイルの場所
スクリプトはscripts/にあります(通常は~/.claude/skills/heraut-seo/scripts)。Python標準ライブラリのみを使用し、Googleトークンにはopensslを使用します。すべてのスクリプトは--config <site.json> --dossier <investigation folder>を受け取り、CSVとJSONをそこに書き込み、さらに最初に読み取るためのresume.jsonも出力します。
| スクリプト | トラック | 処理内容 |
|---|---|---|
sitemap.py | code | サイトマップツリー全体、すべてのURLのタイと言語、lastmodの正確性、重複 |
gsc.py performance | 16ヶ月分の月別・ページタイプ別データ、過去28日間と比較、クエリ、国、セクション | |
gsc.py sitemaps | 送信されたサイトマップ、エラー、保留中、Googleが最後に読み取った日時 | |
gsc.py echantillon / inspecter / analyser | 層化URL検査(1日2,000件のクォータ、再開可能)、タイプ別カバレッジ、前回実行からの変化 | |
ga4.py | 1年間のチャネル別データ、Googleオーガニック(過去と現在)、AIアシスタント、ボット的なシェア | |
pages.py | code | サンプルページの読み取り:言語、canonical、hreflang、robots、単語数、JSON-LD、ブログへのリンク、Googlebotとブラウザの比較 |
logs.py | server | 実際のGooglebot(DNS検証済み)の日別・タイプ別アクセス、無駄、応答時間、フォローされたURLの初回訪問 |
ttfb.py | server | タイプ別の最初の1バイトまでの時間(TTFB)、ウォーム、コールド、オリジン |
dataforseo.py | outside | 実際のSERP、ランキングキーワード、サイトと競合のバックリンク、ボリューム、bilan |
perplexity.py | outside | 日付とソース付きの深層リサーチ(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と、その生データを同じフォルダに書き込みます。
| トラック | ファイル | 主要な質問 |
|---|---|---|
| references/track-google.md | Googleはページを認知し、クロールし、維持しているか?良くなっているのか、悪くなっているのか? | |
| サーバー | references/track-server.md | 実際のGooglebotはアクセスしているか、何を読んでいるか、遅延やブロックの原因はあるか? |
| コードとコンテンツ | references/track-code-content.md | Googleがサイトを読んだときに何を見つけるか:ページ数、コンテンツの薄さ、リンク構造、誠実さはどうか? |
| 外部 | 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ツールのスコア(ランク、スパムスコア、推定トラフィック)はモデルであり、測定値ではありません:引用する際はその旨を明記します。