WordPress からヘッドレス CMS への移行:実践ガイド
ヘッドレス化は WordPress のコンテンツとレンダリングを分離し、編集者は慣れた管理画面を使い続けながら、高速な Next.js のフロントエンドを公開できるようにします。正しく行えば順位を保ったまま速度を得られます。雑に行えば重複サイトをインデックスさせ、公開当日にトラフィックを失います。ここでは正しいやり方を説明します。
ヘッドレス WordPress とは実際に何を意味するか
従来の WordPress はコンテンツと表示を結合しています。PHP のテーマがリクエストのたびにデータベースから取得して HTML をレンダリングします。ヘッドレスはこれらの関心事を分離します。WordPress は引き続きコンテンツを管理し(編集者は同じ管理画面を使い続けます)、ページをレンダリングする代わりに API を通じてコンテンツを公開します。独立したフロントエンド、2026 年ではほぼ常に Next.js が、そのコンテンツを取得して公開サイトをレンダリングします。見返りは確かなものです。静的または edge でレンダリングされたページは、CDN から日常的に 1 秒未満で読み込まれ、集計データもこれを裏付けています。HTTP Archive Web Almanac は、WordPress のモバイルサイトのうち Core Web Vitals をすべて通過するのはわずか約 40% で、主要 CMS プラットフォームの中で最も低いと報告しており、一方でしっかり作られたヘッドレスのフロントエンドは一般に 90% を超えます。しかしアーキテクチャはその結果を可能にするだけで、保証するわけではありません。コンポーネントを過剰にハイドレートし、500KB を超える React バンドルを送り出す出来の悪いヘッドレスサイトは、きちんとキャッシュされた従来の WordPress サイトに毎回負けます。
まず決める:本当にこれが必要か?
この分野全体で最も正直な助言は、理由がないなら移行しないことです。WordPress サイトが遅いなら、より良いホスティング、WP Rocket または Nginx FastCGI キャッシュ、Redis オブジェクトキャッシュ、画像最適化によって、月 50 ドルで直せることがよくあります。ヘッドレス構築は、独立したフロントエンドアプリケーション、デプロイ基盤、カスタムの SEO 配管を維持することになるため、同等の従来型 WordPress プロジェクトの通常 2 ~ 3 倍のコストがかかります。ヘッドレスが見合うのは、要求の厳しいパフォーマンス要件にそれに見合う予算があるとき、単一のコンテンツソースから複数のフロントエンド(ウェブ、アプリ、キオスク)に配信するとき、あるいはチームが長期的に維持する近代的なコンポーネントベースの開発体験が欲しいときです。現在のサイトがすでに PageSpeed で 80 点を超えているなら、まず手元のものを直してください。
REST API か WPGraphQL か
これが中心となる技術的な分岐点です。REST API は WordPress に同梱されており(4.7 以降)、プラグインは不要で、半分の複雑さでおよそ 80% の道のりを進められます。WPGraphQL は有効インストール数 10 万超の無料プラグインで、フロントエンドが必要なフィールドだけを 1 回のクエリで正確に要求でき、REST が陥りがちなオーバーフェッチを避けられます。1 回のリクエストにネストされたデータ(投稿、著者、タクソノミー、カスタムフィールド)を含むコンテンツ重視のサイトでは、WPGraphQL は追加の依存関係と学習曲線に見合う価値があります。チームが GraphQL を知らず、データ構造が単純なら、REST が現実的な既定です。いずれにせよ、Advanced Custom Fields を使うなら追加の配線が必要です。ACF の値は wp_postmeta に格納され、フィールドグループごとに REST 出力を有効にしないと REST には現れず、GraphQL スタックには WPGraphQL と WPGraphQL for ACF プラグインの両方が必要です。
データを失わずにコンテンツとメディアをエクスポートする
ここが移行が静かに壊れる場所です。WordPress の標準的な XML エクスポートはメディアを壊します。画像は投稿として保存され、その ID がインポート時に再生成されるため、古い ID を参照する ACF の画像フィールドが何も指さなくなるのです。信頼できる手順はメディア優先です。コンテンツをインポートする前に、アセットを CDN またはクラウドストレージ(S3、Cloudinary、または CMS のアセットパイプライン)にアップロードし、変換中にメディア参照を新しい URL に書き換えます。フィールドデータについては、ACF アドオン付きの WP All Export Pro でも、acf_get_field_groups() をループして JSON に出力するスクリプトでも、どちらでも機能します。ACF のフィールドグループ定義は ACF > Tools から別途エクスポートしてください。ビルダーコンテンツには余分な時間を確保してください。Elementor、Divi、WPBakery はショートコードやシリアライズされたデータの中でコンテンツとレイアウトのマークアップを織り交ぜており、きれいな自動抽出に抵抗します。ビジュアルに作られたページは手作業の移行対象として扱ってください。
SEO を守る:成否を決める部分
ヘッドレス移行における順位低下のほとんどは、2 つの失敗から生じます。第一に、メタタグと JSON-LD が読み込み後に JavaScript で注入されることです。Google はそれらを見ないかもしれません。修正は交渉の余地がありません。SSG、SSR、または ISR を使って、メタタイトル、ディスクリプション、canonical、Open Graph、構造化データを実際の HTML レスポンスにレンダリングし、決してクライアント側だけにしないことです。それらのメタデータについては Yoast または Rank Math を唯一の信頼できる情報源として保ち、API を通じて読み取ります。第二に、稼働し続ける WordPress オリジンが重複としてインデックスされることです。これをロックダウンします。robots.txt で REST と GraphQL のエンドポイント以外をすべてブロックし、オリジンのすべての HTML レスポンスに X-Robots-Tag: noindex を送り、オリジンのサイトマップを削除するか 410 を返します。最も安全な URL 戦略はパスを同一に保つことです(/blog/my-post が /blog/my-post のままなら、Google はほとんど気づきません)。URL を変更しなければならない場合は、公開前に CSV ですべてを 301 にマッピングして QA します。適切に構成された 301 は PageRank を完全に引き継ぎます。
公開前 QA と切り替えの時間枠
何かに触れる前に、Screaming Frog、Sitebulb、または Ahrefs で既存サイトを完全にクロールし、明白な URL だけでなく、アーカイブ、タグページ、ページネーションされたシリーズ、著者ページ、カスタム投稿タイプも取得します。次に同じクローラーをステージングに向け、404、欠落した canonical、壊れた内部リンク、誤ったステータスコードを探します。古い URL を 50 件無作為に抽出し、それぞれが正しい宛先への 301 を返すことを確認します。フロントエンドから 1 つの正規サイトマップを生成し、URL が公開サイトと正確に一致するようにして、古い WordPress のサイトマップをそこへ 301 リダイレクトします。DNS の切り替えは最もリスクの高い瞬間です。切り替えから完全な検証までを 4 時間未満で行うことを目指し、その後すぐに Search Console でサイトマップを再送信します。大規模サイトでは段階的に行います。ブログを移行し、1 ~ 2 週間検証してから、影響範囲を限定するために次のセクションを移します。
公開後もコンテンツを新鮮に保つ
静的ページは高速ですが古くなるので、時間ベースの再ビルドを待つ代わりにオンデマンドの再検証を組み込みます。パターンはこうです。WordPress の webhook(WP Webhooks プラグインまたはカスタムの save_post フック)が、シークレットトークンと影響を受けるパスまたはタグを添えて Next.js の /api/revalidate ルートに POST を送り、変更されたページだけが再生成されます。1 回の編集が多数のページに影響する場合は、タグベースの無効化のほうがすっきりします。チームを悩ませるホスティングの注意点が 1 つあります。オンデマンド ISR には Next.js の再検証 API をサポートするホストが必要です。Vercel はネイティブに対応していますが、一部のマネージド WordPress ホストやマルチコンテナの Docker または Kubernetes 構成では対応していません。再検証の呼び出しは 1 つのコンテナにしか届かないからです。WordPress 側に Redis オブジェクトキャッシュと GraphQL レスポンスキャッシュを追加し、API レスポンスが再生成のたびに再計算されないようにします。
予算と Pineido の立ち位置
フロントエンドのホスティングは当初は控えめですが従量制です。Vercel Pro はシートあたり月 20 ドルで 20 ドルの利用クレジット付きで、人を驚かせるコストは帯域幅(Pro の 1TB の割り当てを超えると GB あたり 0.15 ドルで課金)、edge リクエスト、ISR の読み書きです。支出アラートを 75% と 100% に設定してください。より大きな項目は移行のエンジニアリングそのものであり、これはまさに固定スコープのスプリントに向いた、境界が明確で重大性の高い作業です。Pineido は WordPress からヘッドレスへの移行を、30 日間の固定価格スプリント 8,500 ドルで実施します。参照の書き換えを伴うコンテンツとメディアのエクスポート、WPGraphQL または REST 上の Next.js フロントエンド、サーバーレンダリングの SEO、完全な 301 リダイレクトマップ、オリジンのロックダウン、オンデマンド再検証に加え、公開前のクロール差分により、DNS を切り替える前に何も後退していないことを確認できます。
よくある質問
ヘッドレス化すると SEO の順位を失いますか?
移行が正しく行われれば失いません。順位低下は避けられる 2 つのミスから生じます。メタタグと構造化データを HTML にレンダリングする代わりにクライアント側の JavaScript で注入すること、そして古い WordPress オリジンをクロール可能なまま残して重複としてインデックスさせることです。すべての SEO メタデータをサーバー側でレンダリングし、可能な限り URL を同一に保ち(または変更ごとに 301 へマッピングし)、オリジンに noindex と robots ブロックを施します。canonical、リダイレクト、サイトマップ、構造化データを保つ移行は、その後たいてい同等以上の順位になります。
WordPress の REST API と WPGraphQL のどちらを使うべきですか?
REST は WordPress に同梱され、プラグインが不要で、データが単純なサイトにとってより簡単な既定です。WPGraphQL(インストール数 10 万超の無料プラグイン)は、フロントエンドが必要なフィールドだけを 1 回のクエリで取得でき、投稿、著者、タクソノミー、カスタムフィールドのようなネストされたデータを持つコンテンツ重視のサイトに適しています。簡単さなら REST、複雑なコンテンツモデルでのクエリの精度とパフォーマンスなら WPGraphQL を選んでください。
Advanced Custom Fields は移行で生き残りますか?
はい、ただし追加の扱いが必要です。ACF の値は wp_postmeta に格納され、フィールドグループごとに REST 出力を有効にしない限り REST API には現れず、GraphQL の構成には WPGraphQL と WPGraphQL for ACF の両方が必要です。フィールドグループの定義は ACF > Tools から別途エクスポートし、実際のフィールドデータは ACF アドオン付きの WP All Export Pro かスクリプトでエクスポートします。特に画像フィールドに注意してください。WordPress の標準エクスポートはメディアの ID 参照を壊すからです。
移行後もチームは WordPress でコンテンツを編集できますか?
はい、それがヘッドレスの主な魅力です。WordPress はコンテンツのバックエンドとして残り、編集者は同じ管理画面、投稿、固定ページ、メディアライブラリを使い続けます。変わるのは、コンテンツが API を通じて独立した Next.js のフロントエンドに公開される点だけです。webhook 経由でオンデマンド再検証を組み込んでおけば、編集は保存してから数秒以内に本番サイトに反映され、完全な再ビルドや開発者のデプロイは不要です。
ヘッドレス WordPress 移行の費用はどれくらいですか?
ヘッドレス構築は、独立したフロントエンドアプリケーション、デプロイ基盤、カスタムの SEO 配管を維持するため、通常は同等の従来型 WordPress プロジェクトの 2 ~ 3 倍かかります。フロントエンドのホスティングは控えめに始まります(Vercel Pro はシートあたり月 20 ドルで、帯域幅と ISR の利用がその上に従量課金されます)。Pineido は移行そのものを 30 日間の固定価格スプリント 8,500 ドルで実施し、エクスポート、Next.js フロントエンド、サーバーレンダリングの SEO、リダイレクト、再検証をカバーします。
WordPress のヘッドレス移行はどのくらいかかりますか?
一般的なコンテンツサイトは 2 ~ 4 週間かかります。参照の書き換えを伴うコンテンツとメディアのエクスポート、Next.js フロントエンドの構築、サーバー側 SEO と再検証の配線、そして入念な公開前クロールです。大規模なサイトやビルダーを多用したサイトはより時間がかかります。Elementor、Divi、WPBakery のコンテンツはきれいな自動抽出に抵抗し、しばしば手作業の移行を必要とするからです。5,000 件以上の投稿、多言語コンテンツ、複雑なカスタムフィールドを持つサイトは別格のプロジェクトであり、段階的なセクションごとの展開が有効です。
毎週、オペレーションのヒントを受け取る
サービス業の経営者・運営者と一緒に、オペレーション、自動化、成長に関する実践的なヒントを毎週1つ受け取りましょう。
スパムは送りません。いつでも配信停止できます。
登録が完了しました。次号を受信トレイでお待ちください。
送信できませんでした。もう一度お試しいただくか、[email protected] までご連絡ください。