出力は標準出力のJSONなので、jq、スクリプト、CIのステップにそのままパイプできます。終了コード0はコマンドが完了したこと、1は完了できなかったことを表し、理由はJSONに入っています。入力は、フラグ、--inputで渡すJSONオブジェクト、標準入力のJSONのいずれでも指定できます。ファイルを書き出すコマンドの多くは、--outや--applyのように、パスやフラグを明示する必要があります。
tool-catalogでは、各コマンドの機能に加えて、ネットワークを使うか、ファイルを書き出すか、費用が発生しうるかを検索できます。ページング前に絞り込むので、redirectのようなクエリなら短い一覧が返ります。引数の形式が必要なときは、--include-argumentsを付けます。オフラインで動作し、何も書き込みません。
公開されている機能は、どれも1つのハンドラーです。seoheadコマンドとしても、同じ名前のMCPツールとしても提供するので、crawl-siteはseo_crawl_siteになります。ターミナルで試したものが、そのままエージェントの呼び出しになります。グループ形式は別名で、scan listはscan-listと同じです。
seohead --helpを実行するか、tool-catalogで検索します。各コマンドの役割は1つで、カタログにも1項目だけ載っています。
出力は常に標準出力のJSONです。終了コード0はコマンドが完了したこと、1は完了できなかったことを表し、理由はJSONにあります。
seohead mcpでローカルのMCPサーバーが起動します。すべてのコマンドは、seo_<command>という名前のツールとしても使えます。たとえばseo_crawl_siteです。
| チェック項目 | 意味 | 重要度 | 根拠 |
|---|---|---|---|
BROKEN_PAGE_4XX | ページが4xxのレスポンスを返す。 | Critical | crawl-siteが返すURLごとのレスポンスコード |
SERVER_ERROR_5XX | ページが5xxのレスポンスを返す。 | Critical | crawl-siteが返すURLごとのレスポンスコード |
BLOCKED_BY_ROBOTS | robots.txtがURLをブロックしている。 | Important | crawl-siteで、そのURLに一致したrobots.txtのルール |
SITEMAP_URL_4XX_5XX | サイトマップに、4xxまたは5xxを返すURLが載っている。 | Critical | sitemap-crawlで取得したサイトマップのエントリ |
SITEMAP_DESYNC | サイトマップのURL群と、クロールしたURL群が一致しない。 | Important | sitemap-crawlのサイトマップと、crawl-siteの結果との比較 |
URL_NOT_IN_SITEMAP | インデックス可能なページがサイトマップにない。 | Tip | クロール結果と、サイトマップのURL群との比較 |
seohead tool-catalog --query redirect --limit 5先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。