Lighthouseでmeta descriptionがないときの直し方

​​Lighthouse​HTML,SEO,トラブルシュート

Lighthouse の SEO の欄に「Document does not have a meta description」(日本語のレポートでは「ドキュメントにメタ ディスクリプションが指定されていません」)と出るのは、ページの <head> に説明文の meta タグがないためです。次の1行を <head> に入れると、指摘は消えます。

html
<meta name="description" content="窓辺で寝ている猫の写真と、その日の様子を短く紹介するページです。">

meta description は、検索結果でページのタイトルの下に出る説明文(スニペット)のもとになる文章です。Chrome for Developers にある、meta description の監査についての解説には、検索エンジンが検索結果に含める、ページの内容の要約だと書かれています。

私は検証環境で、説明文のないページに Lighthouse を実行して指摘が出ることと、1行足すと消えることを確かめました。あわせて、値が空のとき、og:description だけを書いたとき、<body> の中に書いたときなど、指摘が消えない書き方も試しています。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Lighthouse 13.6.0(npm で入れた CLI)、ブラウザは Google Chrome for Testing 153 のヘッドレスです。SEO の項目だけ(--only-categories=seo)を、初期設定のモバイル向けの条件で実行しました。ページは検証環境で作り、127.0.0.1 から配信しました。Chrome の DevTools の Lighthouse パネルや PageSpeed Insights、実際の検索結果での表示は試していません。

指摘が出るページ

検証に使ったのは、見出しと段落が1つずつあるだけのページです。<title> と meta viewport はありますが、meta name="description" はありません。

html
<!doctype html>
<html lang="ja">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>meta description の検証(直す前)</title>
</head>
<body>
<main>
<h1>今日の猫</h1>
<p>窓辺で寝ているところです。</p>
</main>
</body>
</html>

このページを python3 -m http.server で配信し、次のように Lighthouse を実行しました。

bash
npx lighthouse http://127.0.0.1:8000/bad.html \
  --only-categories=seo \
  --output=json --output=html --output-path=./out/bad \
  --chrome-flags="--headless=new --no-sandbox" --quiet

HTML のレポートでは、SEO の点数は90で、指摘は「CONTENT BEST PRACTICES」の欄に出ました。開いても、説明文が検索結果に使われることがある、という説明とリンクがあるだけで、ほかの監査のような要素の一覧は出ません。監査の本体が、合否と理由の文だけを返す作りになっているためです。

Lighthouse の SEO の欄。点数のゲージが90で、CONTENT BEST PRACTICES の欄に「Document does not have a meta description」が開いた状態で並ぶ
meta description のないページのレポート。SEO は90

JSON のレポートから、SEO の点数とこの監査の結果を取り出すと次のとおりです。

text
seo score: 90
weights: 9.043/10.043
[meta-description] weight=1 score=0 (binary)
  title: Document does not have a meta description
failed seo audits: meta-description

head に meta description を1行足す

冒頭の1行を <title> の下に入れ、同じ条件で実行し直しました。監査は合格になり、SEO の点数は100になりました。

text
seo score: 100
weights: 10.043/10.043
[meta-description] weight=1 score=1 (binary)
  title: Document has a meta description
failed seo audits: (none)

合格したので、HTML のレポートでは「PASSED AUDITS」の欄に移っていました。

書いたのに指摘が消えない書き方

<meta name="description"> を書いたつもりでも、書き方によっては指摘が残ります。直す前のページに、説明文のタグを書き方や場所を変えて足し、試した結果は次のとおりです。

書き方 結果 点数
meta name="description" に文章を入れる 合格 100
content=""(空) 不合格(Description text is empty.) 90
content=" "(空白だけ) 不合格(Description text is empty.) 90
name="Description"(先頭が大文字) 合格 100
name="descripton"(つづりの間違い) 不合格 90
meta property="og:description" だけ 不合格 90
<body> の中に書く 不合格 90
<head> に2つ書き、1つ目が空 不合格(Description text is empty.) 90
<script> で後から <head> に追加する 合格 100
540文字の長い説明文 合格 100

値が空のときは、指摘の見出しの横に「Description text is empty.」(日本語のレポートでは「説明のテキストが空です。」)と理由が出ます。タグがないときとは、ここで見分けられます。

Lighthouse のレポートで「Document does not have a meta description」の横に、赤い文字で「Description text is empty.」と出ている画面
content が空のページのレポート。理由が赤い文字で出る

この結果は、Lighthouse 13.6.0 のソースを読むと説明がつきます。ページから meta タグを集める処理は、head meta に当てはまる要素だけを集め、name を小文字にしてから記録します。監査の本体は、その中から name が description の最初の1つを探し、content の前後の空白を取り除いて空なら不合格にします。

そのため、name="Description" のような大文字小文字の違いは合格になります。一方で、<head> に2つ書いて1つ目が空だと、2つ目に文章があっても不合格でした。テンプレートやプラグインが空のタグを先に出していないか、ページのソースで確かめてください。

og:description は、name ではなく property 属性で書くタグです。Lighthouse のこの監査は name が description のタグだけを探すので、og:description があっても指摘は消えませんでした。

<body> の中に書いたタグは、ブラウザが読み込んだ後も <main> の中に残っていました(Playwright の Chromium で確かめました)。head meta に当てはまらないので、集める対象に入りません。

<script> で後から追加したページも、合格になりました。Lighthouse は、ページの中で読み込み後の DOM から meta タグを集めるためです。

Lighthouse が見ていないこと

540文字の説明文でも合格したように、Lighthouse は説明文の長さや中身を調べません。Chrome for Developers の解説にも、Lighthouse は説明文の質を評価しない、とあります。

同じ解説では、説明文の書き方として次の点が挙げられています。

  • ページごとに違う説明文にする
  • 明確で簡潔にする
  • 「Home」のような、あいまいな説明文を避ける
  • キーワードを詰め込まない

検証では、同じ説明文を入れた複数のページが、どれも合格しました。Lighthouse は1ページずつ調べるので、サイトの中で説明文が重複していても指摘されません。合格したかどうかとは別に、ページの内容に合った文章になっているかを見直してください。

点数がいくつ下がるか

Lighthouse 13.6.0 の既定の設定ファイル(default-config.js)では、SEO の点数での meta-description の重みは1です。is-crawlable だけが 93/23(約4.04)と重く、ほかの監査は、手動で確かめる structured-data(重み0)を除いて、どれも1です。

SEO の点数は、計算の対象になった監査の重みのうち、合格した分の割合です。検証のページでは、robots.txt や画像、canonical の監査が「該当なし」になり、対象の重みの合計は約10.04でした。meta description がないと1を失って約9.04になり、点数は90です。ほかに不合格の監査があるページや、対象になる監査が多いページでは、下がり方は変わります。

​Posted by 86