リンクプレビューが出ない原因とOGPタグの確認・キャッシュ削除

KakaoTalk のトーク画面にリンクを貼ったのに灰色の四角しか出ない、画像を差し替えたのに以前のサムネイルのままになる。そんな経験はないでしょうか。原因は大きく二つに分かれます。共有ボットがそのページを読めなかったか、すでに読み込んだ古い結果を表示しているかです。
プレビューカードは自分のスマホが作っているのではありません。リンクを貼った瞬間、Kakao のスクレイピングボットがそのアドレスを直接訪問し、HTML の先頭にある <head> の中の Open Graph(og)タグを読んでカードを描画します。だから「自分のブラウザではちゃんと見える」は根拠になりません。
要点 ① カードは
og:title・og:description・og:imageの3つの値で描かれます。画像が空なら、たいていはog:imageがないか、そのアドレスが開けないかのどちらかです。 ② 共有ボットは JavaScript を実行しません。「ページのソースを表示」にタグがなければ、ボットにも見えません。 ③ タグを直したのに古いカードのままならキャッシュです。Kakao のデバッガーでその URL のキャッシュをクリアしないと変わりません。
カードはボットが読み取って作られます
Open Graph は、ページが「自分のタイトルはこれで、代表画像はこれだ」と自ら宣言するための規格です。仕様書(ogp.me)が定める必須プロパティは og:title、og:type、og:image、og:url の4つです。
これに og:description を加えた5つが、実際のカードにそのまま使われます。KakaoTalk のカードは、画像・タイトル・説明・ドメインの順にこれらの値を配置します。
重要なのは、これらの値をボットが最初に受け取った HTML からしか読まないという点です。ログイン後に表示される画面や、JavaScript があとから埋め込む値は、ボットの視界の外にあります。
カードがまったく表示されないとき: ツールを使わずに確認する順序
特別なソフトを使わず、ブラウザだけで3つのことを順番に確認すれば、原因はほぼ絞り込めます。
1. 「ページのソースを表示」で og: を探す
問題のページを PC の Chrome で開き、右クリック → ページのソースを表示を選びます(Windows は Ctrl+U、Mac は Cmd+Option+U)。そのあと Ctrl+F で og: を検索します。
ここで見るべきは「検証(デベロッパーツール)」ではなくソースです。検証パネルは JavaScript がすべて実行されたあとの結果を表示しますが、ソースはボットが受け取る元の HTML をそのまま表示します。検証パネルにはあるのにソースにはないなら、それがカードの表示されない理由です。
ターミナルを使えるなら、同じ確認を1行で済ませられます。
curl -s https://example.com/page | grep 'og:'
2. og:image のアドレスを新しいタブに貼り付ける
og:image に書かれたアドレスをコピーして、新しいタブにそのまま貼り付けます。ここで画像が開かなければ、カードでもその場所は空になります。
画像のアドレスは https で始まる絶対 URLで書くのが安全です。/img/card.png のような相対パスは、読み取る側によっては解釈できないことがあります。
サイズも確認します。Facebook の共有に関するドキュメントでは、許容される最小サイズは 200×200 ピクセル、大きなカードとして表示させるには 1200×630 ピクセル以上が推奨され、比率は 1.91:1 に近づけ、ファイルは 8MB を超えないようにする必要があります。
3. シークレットウィンドウで開いてみる
ログアウトした状態でもそのページが見られるかを確認します。ログインや会員ランクが必要なページなら、ボットも同じようにブロックされてカードを作れません。
当サイトの無料ツールで確認する。 上の3つの手順を毎回繰り返すのが面倒なら、アドレスを入れるだけで同じ確認が一度に終わります。当サイトのサーバーがみなさんの代わりにそのページを取得して og タグを読み取り、KakaoTalk のカードの形で描画します。
登録もインストールも不要。URLを入れるだけで、こちらのサーバーが代わりにページを取得してogタグを読み取り、カードの見え方を表示します。

カードの下には og:title・og:description・og:image・og:site_name・og:type・twitter:card・twitter:title・twitter:image・canonical の値がそのまま並び、空の項目は — と表示されます。
先の3つのうち欠けているものがあれば、不足しているタグとして別に指摘します。ページは開けたのに og タグも <title> もない場合は、「共有時にカードが作成されません」と知らせます。
ひとつ知っておきたい点があります。og:image が相対パスで書かれていても、ツールは絶対 URL に変換して表示します。元のタグに相対パスが書かれているかどうかは、先ほど説明したソース表示で確認してください。
古い画像が表示されるとき: キャッシュが原因です
タグを直してデプロイまで終えたのに、KakaoTalk でだけ以前のカードが出るなら、見ているのはタグではなくキャッシュです。KakaoTalk は独自のスクレイピングボットが URL 単位で読み取った結果を保存しています。
そのため、新しいカードを見るにはキャッシュを消す必要があります。Kakao 開発者サイトの共有デバッガーで該当のアドレスを入力してキャッシュを初期化すれば、次の共有から新しいタグが反映されます。このツールには Kakao アカウントでのログインが必要です。
急いで確認だけしたいなら、アドレスの末尾に ?v=2 のような値を付けてみる方法もあります。ボットはこれを別のアドレスとみなして新しく読み込みます。ただし、こうして作ったアドレスを共有用に使い続けると統計が分散するので、あくまで一時的な確認用にとどめるのがよいでしょう。
よくつまずくポイント
| 症状 | よくある原因 |
|---|---|
| タイトル・説明は出るが画像だけ空の灰色 | og:image の欠落、またはそのアドレスが開けない |
| カードが丸ごと表示されない | ログイン必須・ボット遮断でページを取得できない |
| ソースにはタグがない | タグを JavaScript でしか入れていない |
| 直したのに古いカード | 共有ボットのキャッシュ |
| OGP・シェアカード プレビューと実際の KakaoTalk で表示が違う | ツールは現在のタグ、KakaoTalk はキャッシュされた値を表示する |
OGP・シェアカード プレビューが「ブロックされました」と知らせてくる場合もあります。これはみなさんのタグの問題ではなく、そのサイトがデータセンターからのアクセスを拒否しているという意味です。YouTube や Google のページが代表例で、Kakao や Facebook のボットは別の経路でアクセスするため、実際のカードは正常に作られることがあります。
Naver ブログも例外です。PC 用アドレス(blog.naver.com)はフレーム構造のため、記事本来のタグではなくブログサービス自体の情報が読み取られます。そこでツールはこの場合、モバイル用アドレス(m.blog.naver.com)に切り替えて確認し、切り替えたことを画面に表示します。
まとめ
- カードは Kakao のスクレイピングボットがページを直接訪問し、
<head>の og タグを読んで作ります。自分のブラウザの画面は根拠になりません。 - 規格上の必須プロパティは
og:title・og:type・og:image・og:urlで、カードの見え方を左右するのはこれにog:descriptionを加えた値です。 - 確認の順序は、① ページのソースで
og:を検索 ②og:imageのアドレスを新しいタブで開いてみる ③ シークレットウィンドウでログインなしに開けるか確認、です。 og:imageは絶対 URL で、1200×630 ピクセル以上・1.91:1 の比率・8MB 以下が安全です。- タグが正常なのに古いカードが見えるならキャッシュです。Kakao の共有デバッガーでその URL のキャッシュを初期化してください。
登録もインストールも不要。URLを入れるだけで、こちらのサーバーが代わりにページを取得してogタグを読み取り、カードの見え方を表示します。
よくある質問
タグを直したのに、カカオトークでは昔の画像のままです。
カカオトークは、スクラップボットが URL 単位で読み取った結果を保存しています。ページをどれだけ再読み込みしても、トーク画面のカードはその保存された値から作られるため変わりません。カカオの開発者サイトにある共有デバッガーで該当アドレスのキャッシュを初期化すると、次に共有したときから新しいカードが作られます。
og:image は何ピクセルで作ればいいですか?
Facebook の共有に関するドキュメントでは、許容される最小サイズは 200×200 ピクセルで、大きな画像カードとして表示させたい場合は 1200×630 ピクセル以上が推奨されています。比率は 1.91:1 に近づけ、ファイルサイズは 8MB を超えないようにしてください。この規格は、複数のサービスで事実上の共通仕様として使われています。
カードが出るリンクと出ないリンクがあります。違いは何ですか?
ボットがそのアドレスで og タグを読み取れたかどうかの違いです。ログインが必要なページ、ボットからのアクセスを遮断しているページ、タグを JavaScript でしか埋め込んでいないページは、ボットが読むものがなくカードが作られません。ページのソース表示で og: が見えるかどうかから確認すると、ほとんどの場合そこで区別できます。
プレビューツールでは正しく出るのに、実際のカカオトークのカードは違います。
見ている時点が違うためです。プレビューツールは今この瞬間にページへ書かれているタグを読み取って表示し、カカオトークはボットが以前に読み取った値を表示します。両者が違うなら、タグはすでに直っていてキャッシュだけが残っている状態なので、キャッシュを初期化すれば一致します。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む