ソーシャルシェア画像とアイコン は何をしますか?
誰かがサイトのリンクをX、LinkedIn、Slack、Discord、WhatsAppに貼り付けたとき、大きな画像と読みやすい見出しが表示されるべきです。ブラウザやスマートフォンでは、くっきりとしたアイコンが表示されるべきです。
1. 調査
- Appフォルダ(
src/app/またはapp/)、既存のfavicon.ico、icon.*、apple-icon.*、opengraph-image.*、twitter-image.*。 - ルートレイアウトの
metadataBase。これがないと、og:imageのURLが相対パスになり、ソーシャルプラットフォームが無視します。 もし欠けている場合は追加してください(launch-seoスキルを参照するか、metadataBase: new URL("https://your-domain.com")を設定します)。 next.config.*:output: "export"になっていませんか?- ブランド:名前、タグライン、プライマリカラー、ロゴ(SVG推奨)。
globals.cssからトークンを再利用します。 - バージョンに合わせたドキュメントを読む:
node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.mdnode_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.mdnode_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md
2. Open Graph画像(サイト全体)
assets/opengraph-image.tsx を app/opengraph-image.tsx にコピーし、ブランドの値を編集します。これは alt、size(1200×630)、contentType をエクスポートし、next/og の ImageResponse で画像を描画します。
シェア画像のデザインルール:
- 見出しは3~8語、最低64px、高コントラスト。300px幅のサムネイルとしても読める必要があります。
- 重要なコンテンツは中央の1000×500領域内に収めてください。一部のプラットフォームは端を切り取ります。
- ブランドマーク+ドメイン名を隅に配置し、リンクの行き先がわかるようにします。
- Flexboxのみ:
ImageResponseはCSSのサブセット(display: flex、gridなし)をサポートします。複数の子要素を持つ要素はすべてdisplay: "flex"が必要です。 - フォント:デフォルトフォントはそのまま使えます。カスタムフォントを使用する場合は、
.ttf/.otf/.woffファイル(.woff2は不可)をreadFileで読み込み、fontsオプションに渡します(ドキュメントの例を参照)。 - サイズ制限:Open Graphは8MB、Twitterは5MB。生成されるPNGは通常100KB以下です。
twitter-image はオプションです:これがない場合、XはOpen Graph画像を使用します。ルートメタデータで twitter: { card: "summary_large_image" } が設定されていることを確認してください。
3. ページごとの画像(ブログ記事、ドキュメント、商品ページ)
動的セグメント内に opengraph-image.tsx を追加します(例:app/blog/[slug]/opengraph-image.tsx)。これは params(Promise)を受け取り、記事のタイトルを読み込めます;画像ファイルから generateStaticParams をエクスポートして、すべての画像がプリレンダリングされるようにします。同じテンプレートを使用して、すべてのシェアが同じブランドに見えるようにします。
これは見た目以上に重要です:ページが metadata/generateMetadata で独自の openGraph を設定すると、親の openGraph オブジェクトが置き換えられ、そのページからルートのシェア画像が消えます。セグメントレベルの opengraph-image ファイル(または明示的な openGraph.images)で修正します。
4. アイコン
ファイル(app/ 内) | サイズ | 目的 |
|---|---|---|
favicon.ico | 32×32(マルチサイズ可) | ブラウザタブ、アプリルートに必須 |
icon.png または icon.svg | 512×512 PNGまたはSVG | モダンブラウザ、Android |
apple-icon.png | 180×180 | iOSホーム画面 |
ImageResponse を使って icon.tsx / apple-icon.tsx を生成することもできます — assets/icon.tsx を参照してください。ローンチ前にcreate-next-appのデフォルト favicon.ico を置き換えてください;.ico ツールがない場合、32×32の icon.png を作成し、古い favicon.ico を削除しても問題ありません。
5. 静的書き出しに関する注意
output: "export" の場合(Next.js 16.4でテスト済み):
- 静的書き出しでは
cacheComponentsをオフにする必要があり、生成されるすべての画像ファイル(opengraph-image.tsx、icon.tsx、apple-icon.tsx)ではexport const dynamic = "force-static";が必要です。そうしないとビルドが失敗します。動的セグメントではgenerateStaticParamsも必要です。 - 生成された画像は ファイル拡張子なし で書き出されます(
out/opengraph-image)。そのため、静的ホストではContent-Typeヘッダーなしで提供されます(Cloudflare Pagesで確認済み)。一部のクローラーはこれを拒否します。サイト全体の画像に対する最善の修正方法:実行中のサイトで/opengraph-imageを開き、保存してapp/opengraph-image.pngとしてコミットします(その後.tsxを削除します)。これにより、正しいタイプでopengraph-image.pngとして書き出されます。アイコン(app/icon.png、app/apple-icon.png)も同様です。記事ごとの画像については、ホストのヘッダーファイル(Cloudflare Pages/Netlifyのpublic/_headers)で該当パスにContent-Type: image/pngを設定します。
6. 確認
-
npm run buildが成功すること。ビルド出力にopengraph-imageルートが表示されます。 -
サイトを起動し(
npm run start、またはout/フォルダを配信)、チェッカーを実行します(Node 18以上、依存関係なし)。<skill-dir>はこのSKILL.mdを含むフォルダです:node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-postこれはページの
og:*タグとtwitter:*タグを読み取り、画像をダウンロードし、絶対URL、HTTPステータス、ファイルサイズ、寸法(1200×630)、og:image:alt、twitter:cardをチェックします。タグ内のlocalhost URLは報告されます。これはmetadataBaseが本番環境で欠けているか間違っていることを意味します。 -
ブラウザで画像URLを開いて確認します。ブラウザウィンドウを狭くしてもテキストが読めるか確認します。
-
デプロイ後、ユーザーに各プラットフォームのツール(LinkedIn Post Inspector、Facebook Sharing Debugger)でテストするよう伝えてください。これらのツールはキャッシュされたプレビューも更新します。
レポート
作成した画像ファイルとアイコンファイル、チェッカーの出力、そしてプラットフォームがプレビューをキャッシュすることを忘れずに伝えてください:画像を変更した後は、上記のツールで再スクレイピングしてください。