Lighthouseでリンクがクロールできないと指摘されたときの直し方
Lighthouse の SEO で「Links are not crawlable」(日本語の表示では「リンクはクロールできません」)と出たら、表に並んだ <a> 要素の href に、移動先の URL をそのまま書きます。JavaScript で画面を切り替えるサイト(SPA)で、<a> の href を javascript:void(0) にしたり、href を書かずに onclick で処理したりしていると出る項目で、検索エンジンがほかのページを見つけられるリンクかどうかを確かめています。
検証用のページには、書き方の違うリンクを9つ並べました。Lighthouse を実行して、どれが表に出て、どれが出ないかを確かめ、直したページで指摘が消えることと、リンクを押したときの動きを確かめています。
検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0(npm のパッケージ)です。Lighthouse はコマンドラインから既定の設定(モバイル)で、SEO のカテゴリーだけを実行しました。Chrome は Playwright 1.63.0 に入っている Chrome for Testing 153 を使い、ページは Node.js の http モジュールで書いた小さなサーバーから localhost で配りました。Google 検索が実際にページをクロールするかどうか、DevTools の Lighthouse パネル、PageSpeed Insights、React などのフレームワークのルーターは試していません。Lighthouse のレポートからリンクしている Google のヘルプページは、検証環境から開けなかったため、この記事では Lighthouse 自身の説明とコードをもとに書いています。
表に出たのは、9つのうち4つのリンク
検証用のページのリンクは次のとおりです。商品一覧・お店について・お知らせ・よくある質問は、押すと JavaScript の関数 go() で見出しを書き換えるだけで、URL は変わりません。
<nav>
<a href="javascript:void(0)" onclick="go('/products')">商品一覧</a>
<a onclick="go('/about')">お店について</a>
<a class="js-link" data-to="/news">お知らせ</a>
<a href="file:///C:/shop/catalog.pdf">カタログ(PDF)</a>
<a href="javascript:go('/faq')">よくある質問</a>
<a href="#" id="menu-open">メニュー</a>
</nav>
<main>
<h1 id="title">トップ</h1>
<a href="javascript:void(0)" role="button" id="add-cart">カートに入れる</a>
<p>ページ:<a>1</a> <a href="/?page=2">2</a></p>
</main>
「お知らせ」には、HTML の属性ではなく、app.js の中で addEventListener('click', …) を付けています。「メニュー」と「カートに入れる」も同じで、押すと画面の一部を変えるだけです。
このページで Lighthouse を実行し、レポートの JSON から、この項目(crawlable-anchors)の判定を小さなスクリプト(summarize.mjs)で抜き出しました。
$ npx lighthouse http://localhost:8100/ --only-categories=seo --output=json --output=html --output-path=./out/broken --chrome-flags="--headless=new --no-sandbox" --quiet -GA=./out/broken-artifacts
exit: 0
$ node summarize.mjs out/broken.report.json
lighthouseVersion: 13.6.0 formFactor: mobile locale: en-US
seo score: 90
failed in seo: crawlable-anchors (weight 1)
crawlable-anchors: score=0 title="Links are not crawlable"
item: <a href="javascript:void(0)" onclick="go('/products')">
item: <a onclick="go('/about')">
item: <a class="js-link" data-to="/news">
item: <a href="file:///C:/shop/catalog.pdf">
SEO の点数は 90 で、落ちた項目はこれだけでした。HTML のレポートでは、表の見出しが「Uncrawlable Link」(日本語の表示では「クロール不可のリンク」)になり、リンクの文字と HTML が並びます。

Lighthouse のレポートの説明には、検索エンジンはリンクの href 属性を使ってサイトをクロールする場合がある、とあります。href に移動先の URL を書いて、サイトのほかのページを見つけられるようにする、というのがこの項目の求めていることです。
Lighthouse 13.6.0 が不合格にする書き方と、通す書き方
表に出なかった5つも含めて、Lighthouse がどう判定したかをまとめます。判定のしかたは、GitHub で公開されている Lighthouse 13.6.0 のコードで確かめました。
| リンク | 結果 | 理由(13.6.0 のコード) |
|---|---|---|
href="javascript:void(0)" |
不合格 | javascript:void(0) の形に当てはまる |
href なし+onclick 属性 |
不合格 | href がなく、イベントリスナーが1つ以上ある |
href なし+addEventListener |
不合格 | href がなく、イベントリスナーが1つ以上ある |
href="file:///…" |
不合格 | file: で始まる |
href="javascript:go('/faq')" |
合格 | javascript:void(0) の形に当てはまらず、URL としても読める |
href="#"+クリックで処理 |
合格 | URL として読める |
role="button"+javascript:void(0) |
合格 | role 属性があるリンクは調べない |
href もリスナーもない <a>1</a> |
合格 | リンクの代わりに置いた要素とみなす |
href="/?page=2" |
合格 | URL として読める |
href のない <a> は、イベントリスナーがあるかどうかで判定が分かれました。この検証のリスナーは click で、onclick 属性でも addEventListener でも Lighthouse に拾われ、どちらも不合格でした。13.6.0 のコードでは、リスナーの種類は問わず、1つでもあれば不合格です(target や rel など、href と組で使う属性を持たない場合)。ページ送りの「今いるページ」のように、href もリスナーもない <a> は表に出ません。
逆に、合格した中にも、移動先の URL を持たないリンクがあります。javascript:go('/faq') は、javascript:void(0) の形に当てはまらず、URL としても読めるので通りました。href="#" と role="button" のリンクも通ります。指摘が消えたかどうかだけでなく、href に移動先が書かれているかを自分で確かめる必要があります。
このほか、13.6.0 のコードでは、mailto: のリンク、name 属性を持つ <a>(file: で始まるものは除く)、href がない(または空の)<a> で id を持つもの(<a id="top"> のようなページ内の目印)も調べません。href の中身が URL として読めないときは不合格です。
移動するリンクは、href に URL を書いてから JavaScript で切り替える
ページを移動するリンク(商品一覧、お店について、お知らせ、よくある質問)は、href に移動先のパスを書きます。
<a href="/products">商品一覧</a>
<a href="/about">お店について</a>
<a href="/news">お知らせ</a>
<a href="/faq">よくある質問</a>
ページを読み込み直さずに画面を切り替えたいときは、href はそのままにして、押されたときだけ JavaScript で処理します。検証では、リンクごとではなく document にリスナーを1つ付けました。
// href はそのまま残し、クリックされたときだけ JavaScript で画面を切り替える
function render() {
document.querySelector('#title').textContent = location.pathname === '/' ? 'トップ' : location.pathname;
}
document.addEventListener('click', (e) => {
const a = e.target.closest('a[href^="/"]');
// PDF や、Ctrl・Shift を押しながらのクリック、中ボタンはブラウザに任せる
if (!a || a.pathname.endsWith('.pdf') || e.button !== 0 || e.ctrlKey || e.metaKey || e.shiftKey) return;
e.preventDefault();
history.pushState(null, '', a.href);
render();
});
window.addEventListener('popstate', render);
// 開いたときの URL で、最初の画面を出す
render();
history.pushState() はページの URL と履歴を変えますが、その URL を読み込みはしません。ただ、MDN には、その URL が後で(たとえばブラウザーを再起動したあとに)読み込まれる場合もあると書かれています。/products などを直接開かれたときにもページを返せるように、サーバーは拡張子のないパスに index.html を返すようにしました。
直す前と直したあとのページを Playwright で開き、リンクを押して確かめました。
-- broken
click 商品一覧: path=/ h1=/products notReloaded=true
click お店について: path=/ h1=/about notReloaded=true
click お知らせ: path=/ h1=/news notReloaded=true
ctrl+click 商品一覧: new tab なし
-- fixed
click 商品一覧: path=/products h1=/products notReloaded=true
click お店について: path=/about h1=/about notReloaded=true
click お知らせ: path=/news h1=/news notReloaded=true
ctrl+click 商品一覧: new tab url=/products h1=/products
back: path=/about h1=/about
open /news directly: h1=/news
notReloaded=true は、ページを読み込み直していないことを表します(開いたときに window に置いた値が残っていました)。直す前のページは、見出しは変わりますが URL は / のままで、Ctrl キーを押しながらクリックしても新しいタブは開きませんでした。直したあとは、URL が /products などに変わり、Ctrl キーを押しながらのクリックで /products が新しいタブに開きました。ブラウザの「戻る」で前の画面に戻り、/news を直接開いても、見出しが /news の画面が出ました。
カタログの PDF は、file: のパスをやめ、ファイルをサーバーに置いて href="/catalog.pdf" にしました。
移動しないものは、a ではなく button にする
「メニュー」と「カートに入れる」は、押しても別のページには行きません。こうしたものは <a> をやめて <button> にしました。
<button type="button" id="menu-open">メニュー</button>
<button type="button" id="add-cart">カートに入れる</button>
この2つは、直す前の書き方のままでも、Lighthouse は指摘しませんでした。それでも MDN の <a> 要素の説明は、href を # や javascript:void(0) にしてボタンの代わりにすることを誤った使い方として挙げ、代わりに <button> を使うよう勧めています。リンクのコピーや新しいタブで開く操作で、思わぬ動きになるためです。role="button" を付ければこの項目は通りますが、移動しないものは <button> にするのが素直です。
直したあとの結果
直したページで Lighthouse を実行すると、この項目は合格(「Links are crawlable」、日本語の表示では「リンクはクロール可能です」)になり、SEO の点数は 100 になりました。2回実行して、どちらも同じ結果でした。
$ node summarize.mjs out/fixed.report.json
lighthouseVersion: 13.6.0 formFactor: mobile locale: en-US
seo score: 100
crawlable-anchors: score=1 title="Links are crawlable"
この項目の SEO の点数への重みは1で、is-crawlable(93/23)と、手動で確かめる structured-data(0)を除く、ほかの8項目と同じです(13.6.0 の設定)。





