Community画像github.com

ソーシャルシェア画像とアイコン

Next.js App Routerサイトに必要なOG画像(1200×630)、Twitter/Xカードタグ、ファビコン、アプリアイコン、Appleタッチアイコン、ブログ記事ごとのOG画像を作成し、確認スクリプトで検証します。

ソーシャルシェア画像とアイコン とは?

このスキルは、Next.js App Routerサイトに必要なソーシャルシェア用画像とアイコン一式を自動生成・検証するためのものです。1200×630のOG画像(Open Graph)を `next/og` の `ImageResponse` を使って作成し、サイト全体のシェアプレビューとして機能させます。さらに、ブログ記事やドキュメントページごとに個別のOG画像も生成でき、セグメントレベルで適切に設定することで、親メタデータのOG画像が上書きされる問題も解決します。対応プラットフォームはX(Twitter)、LinkedIn、Slack、Discord、WhatsAppで、`check-og.mjs` スクリプトがURL、サイズ、ファイルサイズ、`og:image:alt` などを自動チェックします。静的書き出し(`output: "export"`)にも対応しており、`metadataBase` の設定やファビコン、アプリアイコン、Appleタッチアイコンの生成にも役立ちます。ユーザーが「OG画像」「ソーシャルプレビュー」「リンクプレビュー」「シェアカード」「Twitterカード」「ファビコン」「アプリアイコン」などのキーワードを口にしたときや、サイトリンクのプレビュー画像が表示されないときに利用するよう設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nandot12/nextjs-launch-skills/tree/main/skills/launch-social-images

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ソーシャルシェア画像とアイコン は何をしますか?

誰かがサイトのリンクを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.md
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.md
    • node_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.ico32×32(マルチサイズ可)ブラウザタブ、アプリルートに必須
icon.png または icon.svg512×512 PNGまたはSVGモダンブラウザ、Android
apple-icon.png180×180iOSホーム画面

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. 確認

  1. npm run build が成功すること。ビルド出力に opengraph-image ルートが表示されます。

  2. サイトを起動し(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 が本番環境で欠けているか間違っていることを意味します。

  3. ブラウザで画像URLを開いて確認します。ブラウザウィンドウを狭くしてもテキストが読めるか確認します。

  4. デプロイ後、ユーザーに各プラットフォームのツール(LinkedIn Post Inspector、Facebook Sharing Debugger)でテストするよう伝えてください。これらのツールはキャッシュされたプレビューも更新します。

レポート

作成した画像ファイルとアイコンファイル、チェッカーの出力、そしてプラットフォームがプレビューをキャッシュすることを忘れずに伝えてください:画像を変更した後は、上記のツールで再スクレイピングしてください。

関連スキル