開発者向けSEOタスクリスト

監査から、優先度付きのタスクリストを作れます。問題の種類ごとに1タスクで、優先度、工数、影響を受けるURL、修正のヒント、再現用の行が付きます。リンク切れには、リンク元のページ、リンク位置、XPathも載ります。

できること

P1〜P3

タスクは優先度ごとにtasks.mdへまとめ、スクリプトやエージェント向けにtasks.jsonにも保存します。既定では、重大な検出結果がP1(工数は大)、警告がP2(工数は中)、通知がP3(工数は小)になります。この対応はルールであり、サイトごとの見積もりではありません。変更もできます。

  • 既定ではチェックごとに1タスク。group_byで、URLごと、または宣言したテンプレートごとに1タスクにもできます
  • 各タスクには、チェックから取った修正のヒントが付きます
  • 影響を受けるURLはタスクごとに上限があり、省いた件数もタスクに記されます
  • 重要度、チェック、最小発生件数は、設定で絞り込めます

再現と証拠データ

各タスクには、保存済みの監査から取った再現用の行が載ります。URL、ステータスコード、リンクの場合はページ上の位置です。監査に再現データがないときは、tasks.mdにその旨を記し、でっち上げることはしません。監査に含まれていれば、タスクには元になった保存済みの観測値への参照も残ります。

  • リンク切れ:リンク先、リンク元のページ、リンク位置、XPath
  • 途中までの監査や、スキップされたチェックがある監査は、その警告がtasks.mdに引き継がれます
  • 除外ルールで隠れたURLは一覧に載らず、その件数がファイルに記されます

再チェック

tasks.mdは提案としてのタスクリストで、承認済みの計画ではありません。リリース後は、一覧から消えたことを理由に、タスクを修正済みとは数えません。修正の確認は、影響を受けるURLの再チェックで行います。修正用のツールまたはverify-fixesを使い、修正前後のスキャンを比較します。

  • verify-fixesは、明示したURLの一部について、ベースラインの検出結果を再チェックします
  • remediation-recheckは、台帳の個別のケースを対象に、確認の証拠データを書き出します
  • あとのスキャンが途中までだった場合、検出結果が消えても、修正の証明にはなりません

3ステップで、スキャンを1件保存

  1. エクスポートから監査を実行する

    Screaming FrogのCSVまたはXLSXエクスポートのフォルダをCLIに渡し、--tasksを付けると、同じ実行でタスクリストも得られます。

  2. P1〜P3の順位付きタスクを得る

    各タスクには、優先度、工数の見積もり、影響を受けるURL、修正案、再現手順が付きます。リンク切れには、リンク元のページ、リンク位置、XPathも載ります。

  3. リリース後に再チェックする

    各修正は、一覧からタスクが消えたかどうかではなく、remediationの再チェックツールで確認します。

この機能のチェック項目

チェック項目意味重要度根拠
BROKEN_PAGE_4XXページが4xxのレスポンスを返すCritical影響を受けるURLと、そのレスポンスのステータス
BROKEN_INTERNAL_LINK内部リンクが4xxのURLを指しているCriticalリンク切れごとの、リンク先、リンク元のページ、リンク位置、XPath
REDIRECT_LOOPリダイレクトが循環し、有効な転送先に到達しないCriticalリダイレクトチェーンレポートの行
TITLE_MISSINGページにtitle要素がないCritical影響を受けるURL(タスクごとに上限あり)
REDIRECT_CHAIN最終URLに着くまでに2ホップ以上のリダイレクトがあるImportantリダイレクトチェーンレポートのホップ
DESC_MISSINGページにメタディスクリプションがないImportant影響を受けるURL(タスクごとに上限あり)
H1_MISSINGページにH1の見出しがないImportant影響を受けるURL(タスクごとに上限あり)
BAD_REDIRECT_TYPE恒久的な移転のはずが、302、303、307になっているTip影響を受けるURL(タスクごとに上限あり)

コマンド1つで実行

bash
seohead sf run --exports-dir ./exports --out ./report --tasks

先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。

必要なもの

  • Screaming FrogのCSVまたはXLSXエクスポートのフォルダ、または既存のaudit.json
  • またはcrawl-siteで保存したネイティブのスキャン(scan.v1のSQLiteファイル)
  • 任意:tasks_pipelineブロックを含むconfig.json
  • sf runにクロールを開始させる場合のみ、ライセンスのあるScreaming Frog CLI

制限事項

  • 監査から作るのは、提案としてのタスクリストです。作業の承認、割り当て、デプロイは行いません
  • 優先度と工数は、ルールに基づく重要度から決まります。サイトやチームの規模は反映されません
  • URLの一覧と再現用の行は、タスクごとに上限があります。そのため、タスクには一部のサンプルと件数が表示されます
  • 網羅性は監査次第です。実行されなかったチェックからは、タスクは作られません

よくある質問

Screaming Frogのライセンスは必要ですか?
タスクビルダーには不要です。すでにあるエクスポート(CSVまたはXLSX)、audit.json、またはネイティブのスキャンを読みます。ライセンス付きのScreaming Frog CLIでクロールを開始するのは、--crawlを付けたsf runだけです。
サイトに変更を加えますか?
いいえ。タスクビルダーは監査を読み、--outで指定したフォルダにtasks.jsonとtasks.mdを書き出すだけです。何をデプロイするかは、ご自身で決めます。
優先度は変更できますか?
はい。--configでconfig.jsonを渡し、tasks_pipelineの下で、priority_map、effort_map、group_by、include_severities、max_urls_per_task、min_occurrencesを設定します。
タスクに再現手順がない場合はどうなりますか?
保存済みの監査からは再現手順を得られない旨が、tasks.mdに記されます。でっち上げることはしません。
すでにある監査から、タスクを作れますか?
はい。audit.jsonまたはネイティブのスキャンファイルを--jsonで指定して、sf tasksを実行します。クロールもリクエストの送信もせず、tasks.jsonとtasks.mdを書き出します。
AIエージェントからも実行できますか?
はい。同じ手順がMCPツールとして用意されています。監査にはsf_audit_run、タスクリストにはsf_audit_tasksを使います。