itemprop属性:値の読み取り方とMicrodataの確認方法

この記事では、情報が何を表すかをラベル付けするitemprop属性と、情報全体をまとめるitemscopeとの関係を初心者向けに説明します。

この記事でわかること

3つの属性を、人物の例で見てみる

Microdata(マイクロデータ)は、HTMLに「この情報は何を表すか」を書き添える仕組みです。次の3つの属性は、それぞれ役割が違います。

まとまり・種類・項目の違い
属性役割この例では
itemscope1つの情報のまとまりを作る1人分のプロフィール
itemtype情報の種類を示すhttps://schema.org/Person
itemprop情報の項目名を付けるname=その人の名前
<div itemscope itemtype="https://schema.org/Person">
  <p itemprop="name">Aki</p>
</div>

画面には「Aki」と表示されます。これらの属性だけでは、文字の色や大きさは変わりません。情報を読むプログラムには、「人物の名前がAki」と伝えられます。

2人の名前を、分けて読み取れるか試す

情報のまとめ方

Aki

Kai

この表示に対応するHTML

<div itemscope itemtype="https://schema.org/Person">
  <p itemprop="name">Aki</p>
</div>

<div itemscope itemtype="https://schema.org/Person">
  <p itemprop="name">Kai</p>
</div>

nameの読み取り結果

  • 人物1: name = Aki
  • 人物2: name = Kai

1人ずつまとめると、AkiとKaiは別の人物の名前になります。

この例は、nameがどの人物に属するかを示しています。すべてのMicrodataを検証するツールではありません。

値は、属性を付ける要素によって変わる

HTMLの標準的な読み取り方
書き方読み取る値
<span itemprop="name">Aki</span>Aki
<meta itemprop="priceCurrency" content="JPY">JPY
<data itemprop="price" value="19800">19,800</data>19800
<img itemprop="image" src="photo.jpg" alt="…">srcから決まる画像のURL
<time itemprop="birthDate" datetime="2000-11-27">…</time>2000-11-27

たとえばspanでは、通常は中の文字を読み取ります。表示と異なる値を渡したい場合は、dataのvalueなど、要素ごとの仕組みを使います。

入れ子の情報は、項目名でつなぐ

商品と販売条件は別の情報です。商品はProduct、価格や通貨はOfferでまとめ、offersという項目でつなぎます。

<article itemscope itemtype="https://schema.org/Product">
  <h2 itemprop="name">Headphones X100</h2>
  <div itemprop="offers" itemscope
       itemtype="https://schema.org/Offer">
    <meta itemprop="priceCurrency" content="JPY">
    <p><data itemprop="price" value="19800">19,800</data> JPY</p>
    <link itemprop="availability" href="https://schema.org/InStock">
    <p>在庫あり</p>
  </div>
</article>

正しく書けたかを確認する

  1. Schema Markup Validatorでコードを検査し、Personのnameが想定どおりか確認します。
  2. Googleの検索結果で使える機能を調べるときは、Rich Results Testも使います。対象となる情報の種類と必要な項目を確認してください。

人物の最小例がリッチリザルトの対象として表示されなくても、Microdataが誤りとは限りません。リッチリザルトは、評価の星などを含む検索表示です。正しい構造化データを書いても、検索順位の上昇やリッチリザルトの表示は保証されません。

JSON-LDは、構造化データをHTMLの本文と分けて書く方法です。これから構造化データを追加する場合は、この方法も選択肢です。Googleは、サイトの仕組み上使える場合にJSON-LDを推奨しています。

もう一度確かめる:2人分の名前を別々に読み取れるように書き、どの属性で分けたか説明してみてください。

根拠:HTML標準の値の読み取り方、Schema.orgのprice、Googleの構造化データ案内。

In HTML, itemprop is a label that tells search engines what each piece of information means (like a name, price, author, or publish date), so your page is less likely to be misunderstood.

itemprop 属性

HTMLの itemprop は、ページの中の「名前・価格・著者・公開日」みたいな情報にラベルを貼って、検索エンジンが内容を取り違えにくくするための目印です。

はじめに

検索エンジンもページ内容から“それっぽい意味”は推測しますが、機械にとっては曖昧になりがちです。itemprop で「これは価格」「これは著者名」みたいにラベルを付けると、答え合わせができて解釈が安定します。

対応する構造化データは、検索エンジンが情報を理解する助けになります。ただし、検索順位の上昇やリッチリザルトの表示を保証するものではありません。

ちなみに itemprop は Microdata(マイクロデータ)の仕組みで、よく schema.org の語彙(プロパティ名)とセットで使われます。

マイクロデータと itemprop の全体像

Microdata 仕様
HTML5 で導入された仕組み。itemscope で“アイテム”を宣言し、itemtype でその種類(schema.org などの語彙)を示し、itemprop で各要素の役割を指定していく。
主役は語彙 (Vocabulary)
もっとも一般的なのが schema.org。Google など主要検索エンジンが共同で管理し、数千種類のプロパティを定義。
属性値は URL(例: https://schema.org/Person)で書くのが基本だが、itemprop の値は語彙で規定された「短い名前」(name, price, image …)を使う。
JSON-LD との関係
Google は JSON-LD を“推奨”と公言。ただし Microdata も完全サポート。
ハイブリッド手法 : 既存 HTML を壊さず JSON-LD を SSR で生成する、あるいは SPA で動的に注入するなど、両者を補完的に使うケースが増えている。

基本的な書き方

HTML

<article itemscope itemtype="https://schema.org/Product">
  <h2 itemprop="name">Headphones X100</h2>
  <div itemprop="offers" itemscope
       itemtype="https://schema.org/Offer">
    <meta itemprop="priceCurrency" content="JPY">
    <p><data itemprop="price" value="19800">19,800</data> JPY</p>
    <link itemprop="availability" href="https://schema.org/InStock">
    <p>在庫あり</p>
  </div>
</article>

コード解説

itemscope
ここから先が 1 つの“アイテム”。
itemtype
Product という型を指定。
itemprop
子要素それぞれに意味をタグ付け。

非可視データ(通貨コードや在庫状態など)は <meta> 要素を使えば表示せずに値だけ提供できる。

itemprop の挙動を深掘り

適用できる要素

ほぼすべての要素で利用可。<meta> を使えばテキストを表示せず値だけ埋め込める。

データ型と既定値

schema.org では Text / URL / Date / Number / Boolean など多数の型が定義され、Google 検索は型を厳格に評価。

複数値の指定

HTML

<ul>
	<li itemprop="genre">Rock</li>
	<li itemprop="genre">Blues</li>
</ul>

同じアイテム内で同じ itemprop を繰り返すと、その項目は複数の値を持ちます。どの値が使われるかは、情報を読むサービスの仕様によります。

ネストされたアイテム

アイテムの中に別の itemscope を作れば、階層構造も表現可能。

HTML

<div itemscope itemtype="https://schema.org/Recipe">
	<span itemprop="name">抹茶ケーキ</span>
	<div itemprop="nutrition" itemscope itemtype="https://schema.org/NutritionInformation">
		<meta itemprop="calories" content="340">
		1切れ 340 kcal
	</div>
</div>

DOM API からのアクセス(上級)

Microdata を JavaScript から読むための専用 API(document.getItems など)は、対応ブラウザが限られます。学習として知っておくのはOKですが、実務では「使える前提」にしない方が安全です。

JavaScript

// 注意:このAPIは主要ブラウザで広くは使えません(学習用の例)
// ページ内の Product アイテムを取得
const products = document.getItems('https://schema.org/Product');
for (const item of products) {
	console.log(item.properties.name[0].value);
}

この専用APIを、現在のブラウザで使える仕組みとして新しく採用しないでください。

HTMLを調べるときは通常のDOM APIも使えます。ただしquerySelectorだけでMicrodataのすべての関連付けを解析できるわけではありません。

SEO とリッチリザルト

Google の評価ポイント
  • 語彙が 構造化データのガイドライン に合致していること
  • ページに表示される UI とデータが一致していること(クローク禁止)
  • 不完全な itemprop を置くより 必要最小限+正確 の方が好印象
Bing・Yandex もほぼ同じ実装。
テストツール

アクセシビリティとの相性

itemprop 自体は支援技術が無視するため、スクリーンリーダーの読み上げフローに影響しない。

よくある落とし穴とベストプラクティス

itemprop の綴りミス
検索エンジンは無視。早期に validator を通す。
複数 itemtype の混在
itemscope を分けてネストし、itemref は避ける(複雑でデバッグ困難)。
SSR + CSR で DOM を再構築する SPA
CSR 完了後に Microdata が消えるケースがある。DOM を上書きしないよう設計。
JSON-LD 併用
コンテンツが大規模・多言語なら Microdata を捨てて JSON-LD 一本に統一するほうが保守しやすい。
itemprop だけ書いて itemscope/itemtype を書かない
どのアイテムのプロパティか特定できず意味が薄れる。
プロパティ名を独自に作る
可能だが、なるべく schema.org など共通語彙を使うと効果大。

よくある質問(FAQ)

itemprop だけ書けば検索エンジンに伝わりますか?
itempropは、itemscopeで作ったアイテムに属する項目名を示します。Schema.orgを使う例ではitemtypeで種類も指定します。属性だけを孤立させず、どのアイテムの項目かを確認してください。
itemprop の値(例: name や price)は自由に決めていい?
自由に作ることもできますが、SEO目的なら schema.org のプロパティ名に合わせるのが基本です。検索エンジンが理解しやすくなります。
Microdata と JSON-LD、どっちを選べばいい?
既存HTMLをそのまま活かしたいなら Microdata、運用・保守をラクにしたいなら JSON-LD が選ばれやすいです。Googleは JSON-LD を推奨しつつ、Microdata もサポートしています。
<meta> で値だけ入れるのはアリ?
アリです。ただし「ページ上に表示される内容」と矛盾しないようにします。見えない値だけ盛るのはNGです。
FAQの構造化データを入れたら検索結果にFAQが必ず出る?
出るとは限りません。GoogleはFAQリッチリザルトの見せ方を縮小していて、条件によっては表示されません。ただ、ページの分かりやすさ自体は上がります。

よくあるエラー早見表

Rich Results Test で「必須プロパティが不足」
その構造化データ種別(例: Product)に必要な項目が足りていません。まずは必須だけ揃えます。
itemprop を書いたのに認識されない
itemscope/itemtype が無い、または itemprop の付け先がアイテムの外になっている可能性が高いです。
表示していない情報だけ <meta> に入れている
ページ表示と食い違うと品質的にマイナスになりやすいです。ユーザーに見える情報と一致させます。
数値が文字列扱いでズレる(価格・評価など)
metaではcontent、dataではvalueを使います。表示用の「19,800」と機械向けの「19800」を分け、正しい要素で指定してください。
FAQが検索結果に出ない
実装が正しくても、Google側の表示条件で出ないことがあります(特にFAQは表示が限定されています)。

将来動向

WHATWG 仕様では Microdata が “非推奨”ではないものの、開発は停滞。

Google 検索は構造化データの形式として JSON-LD(推奨)/ Microdata / RDFa をサポートしています。とはいえ、保守のしやすさ的に JSON-LD を選ぶケースが多いです。

ただし レガシー CMS やメールテンプレート など、純 HTML しか触れない環境では今後も需要が残る。

まとめ

itemprop は「ページ内の要素に“意味”を付けて検索エンジンとデータベースに語りかけるラベル」。