相互リンクと確認の判定には、ページ群のすべてのページが必要です。ページAがページBについて書いている内容と、ページBがAについて書き返している内容を比べるためです。このチェックは1ページではなく、Screaming FrogのAll Hreflangエクスポートなどのクロールデータで実行します。代替ページの宛先についても、200を返すか、インデックス可能か、自身が正規URLかを確認します。
hreflang-checkは、1ページを取得し、リダイレクトを辿って、HTML内の代替リンクを読み取ります。言語、スクリプト、地域のコードをすべて検証し、重複した値、ページ自身の記載、x-defaultの有無を確認します。代替ページにはアクセスしないので、全体のクロールの前に手早く状況を見るのに向いています。
hreflangのリンクは、headの中で読み取られた場合にだけ有効です。ネイティブクロールはすべての代替リンクの位置を比べ、bodyに入ってしまったものを報告します。原因は、headの上のほうにある壊れたタグであることが多く、そのタグを直せばアノテーションも直ります。
hreflang-checkは、ページを取得してリダイレクトを辿り、HTML内の代替リンクを読み取ります。コード、自己参照、重複、x-defaultを確認します。
相互リンク、リンク切れやリダイレクトする宛先、noindexの宛先のチェックには、ページ群のすべてのページが必要です。1ページ単位ではなく、ネイティブクロール全体、またはseohead sf runでインポートしたAll Hreflangエクスポートに対して実行します。
検出結果ごとに、対象のページと代替ページが示されます。サイトのアノテーションを修正してから、もう一度チェックします。
| チェック項目 | 意味 | 重要度 | 根拠 |
|---|---|---|---|
HREFLANG_MISSING_RETURN_LINK | 別のページがこのURLをhreflangで指定しているが、このページから相互に指定し返していない | Important | 元のページと、相互リンクがない代替ページ（クロール） |
HREFLANG_BROKEN_TARGET | 代替URLが3xx、4xx、5xxのステータスを返す | Important | 宛先のURLとそのステータスコード（クロール） |
HREFLANG_NOINDEX_TARGET | 代替URLにnoindexが指定されている | Important | 宛先のURLとnoindexのシグナル（クロール） |
HREFLANG_INVALID_CODE | 言語または地域の値が、ISO 639-1、ISO 15924、ISO 3166-1の有効なコードではない（例：en-UK） | Important | hreflangの値そのものと、それがあるページ（単一URL：`malformed hreflang code`） |
HREFLANG_MISSING_SELF_REFERENCE | ページに代替指定はあるが、自身のURLが含まれていない | Important | ページのURLと代替の一覧（単一URL：`page does not self-reference`） |
HREFLANG_MULTIPLE_ENTRIES | 同じ言語・地域の値が、1ページに複数回出現する | Important | 重複した値とそのhref（単一URL：`duplicate hreflang`） |
HREFLANG_MISSING_XDEFAULT | どの代替にも言語が合わないユーザー向けの、x-defaultのフォールバックがない | Tip | ページと代替の一覧（単一URL：`no x-default alternate`） |
HREFLANG_ERRORHREFLANG_INCONSISTENT_CONFIRMATIONHREFLANG_NOT_CANONICALHREFLANG_UNLINKED_TARGETHREFLANG_OUTSIDE_HEADseohead hreflang-check --url https://example.com/en/先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。