nextjs-seo について
Next.js プロジェクトで SEO を実装・監査するスキルです。導入済みバージョンに合った資料と本番環境の証拠を重視し、順位やインデックス登録を保証せずに報告します。
主な機能
- 01導入済み Next.js バージョンに合う資料を参照
- 02メタデータ、サイトマップ、robots、canonical を確認
- 03構造化データと表示内容の整合性を確認
- 04本番 HTML、ヘッダー、クローラー応答を検査
- 05検索、インデックス、性能の証拠を区別
活用シーン
- 01Next.js のルートに対する SEO 変更の監査
- 02クロール、インデックス、canonical の問題を調査
- 03リリース前にメタデータと構造化データを検証
- 04Lighthouse だけに頼らず実ユーザー性能を評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ laguagu/ claude-code-nextjs-skills --skill nextjs-seoインストール後、Claude Code で/nextjs-seoを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/ai-search.mdchecklist.mdjson-ld.mdmetadata-api.mdsitemap-robots.mdtroubleshooting.md詳細
Next.js SEO
ページの目的、本番環境でのレスポンス、実際に観測された検索動作を起点にしてください。
インストール済みの Next.js のバージョンと、関連する node_modules/next/dist/docs/
のページ(16.2 から同梱)を確認してください。それができない場合は、対応する公式ドキュメントを参照してください。
Metadata、Viewport、MetadataRoute の型は、
node_modules/next/dist/lib/metadata/types/metadata-interface.d.ts にもあります。フレームワーク API、キャッシュモード、デプロイポリシーは、プロジェクトと整合させてください。
長いページよりも、役に立つ独自のコンテンツが重要です。タイトル、見出し、説明文にはそれぞれ異なる役割を持たせてください。FAQ、要約、バッジ、追加ページは、読者の役に立つ場合にのみ追加してください。公開日は、意味のある変更を反映させてください。著者、資格、事実に関する主張を確認してください。
実装と監査の対象範囲
- マークアップを追加する前に、公開 URL、リダイレクト、ステータスコード、クロールルール、インデックス指定、canonical を確認してください。サイトマップは発見を支援しますが、ページをインデックス可能にしたり、インデックス登録を保証したりするものではありません。
- 可能な場合は、重要な公開コンテンツを配信される HTML に含めてください。Client Component はサーバー側で事前レンダリングできます。
use clientを付けただけで、コンテンツが HTML から除外されるわけではありません。 - App Router の Metadata API とファイル規約を使用してください。相対メタデータ URL は、正しい本番環境の
metadataBaseを使って解決し、出力される絶対 URL を確認してください。バージョンやホストによって異なる、ベースが欠落した場合の動作に依存しないでください。 - データに基づくページ、メタデータ、サイトマップの更新や無効化の仕組みを設定してください。データベースへのクエリだけでは、公開内容の更新がそれらに反映されるとは限りません。Cache Components が有効な場合は、インストール済みの Next.js キャッシュドキュメント(
node_modules/next/dist/docs/)に従ってください。キャッシュは鮮度に関する判断であり、必須の SEO 指示ではありません。 - 構造化データには、実際に表示されているコンテンツと、対応している利用先を記述してください。あらゆるスキーマタイプを追加するのではなく、現在のリッチリザルトの適格性を確認してください。
- サイト運営者のクローラーポリシーを守ってください。学習、検索、ユーザーが開始する情報取得にはそれぞれ異なる制御があります。robots ルールはアクセス制御ではありません。
対象範囲に応じて読む
- メタデータ:継承、ソーシャル画像、アイコン、ストリーミング。
- サイトマップ/robots:発見、ローカライズ、プレビューポリシー。
- 構造化データ:現在の適格性と安全なシリアライズ。
- AI 検索:クローラーの目的、ポリシー、根拠。
- 監査チェックリスト:対象を絞った本番環境と Search Console の確認。
- トラブルシューティング:インデックス登録、HTML、ハイドレーションの診断。
レポートでは根拠を区別してください。パフォーマンスのエクスポートデータは、検索クエリやトラフィックを示します。URL 検査とインデックス登録レポートは、クロール、インデックス、canonical の状態を扱います。フィールド計測は Core Web Vitals を扱います。Lighthouse はラボ環境での診断であり、フィールド INP の根拠にはなりません。75 パーセンタイルでの良好なフィールド閾値は、LCP ≤ 2.5 s、INP ≤ 200 ms、CLS ≤ 0.1 です。
ステータス、ヘッダー、本番環境の完全な HTML(関連するボットへのレスポンスを含む)を確認してから、ルートを直接開き、操作をテストしてください。偽装した User-Agent で確認できるのはレスポンス処理であり、実際に検証されたボットのアクセスではありません。確認できなかった項目は明示し、ランキング、インデックス登録、引用を保証するような表現は避けてください。