EmDash情報局

検索

相談する

このサイトは非公式の日本語訳です。Cloudflare・EmDashプロジェクトが運営するサイトではありません。

ハンズオン：WordPressの記事を移す

完成するもの

  • WordPressの投稿・固定ページなどを取り込んだEmDashのサイト
  • 取り込んだ内容を、元のWordPressサイトと突き合わせた確認結果

EmDashの管理画面で、WordPressサイトの解析、互換性のあるコレクションの準備、コンテンツのインポート、メディアのコピー、URLの書き換えまでを進めます。取り込んだサイトの確認が終わるまで、WordPressのサイトは残しておきます。（公式「WordPressからの移行」）

所要時間

目安：60分（移す記事とメディアの量によって変わります）

AIエージェントによる実測のあとに、この時間を更新します。

必要なもの

種類 必要なもの 補足
EmDashのサイト メディアをコピーする場合は、ストレージを設定済みのサイト 「ハンズオン：AIとブログを作って公開する」で作ったサイトを使えます
アカウント EmDashの管理者アカウント WordPressのインポートには import:execute の権限が必要です。最初に作ったユーザーは必ず管理者になります（公式「認証」）
バックアップ WordPressのデータベースと wp-content/uploads のバックアップ 作業の前に用意します
移行元のデータ WordPress eXtended RSS（WXR）の完全なエクスポートファイル、またはWordPressサイトにインストールしたEmDash Exporterプラグイン どちらを使うかはステップ2で決めます
ツール 生成AIツール ターミナルでコマンドを実行できるAIツール（Claude Code、Cursor、Codexなど）、またはチャット型のAI（ChatGPT、Claudeのチャットなど）。使い方の違いは「依頼文の使い方」で説明します

手順の全体像

WXREmDash Exporter1.移行前の記録を取る2.インポート方法を選ぶ3a.WXRファイルを書き出す3b.移行キーを発行する4.管理画面でインポート5.メディアを取り込む6.切り替え前の確認
図のテキストを読む
flowchart TD
    S1["1. 移行前の記録を取る"] --> S2["2. インポート方法を選ぶ"]
    S2 -->|WXR| S3A["3a. WXRファイルを書き出す"]
    S2 -->|EmDash Exporter| S3B["3b. 移行キーを発行する"]
    S3A --> S4["4. 管理画面でインポート"]
    S3B --> S4
    S4 --> S5["5. メディアを取り込む"]
    S5 --> S6["6. 切り替え前の確認"]

依頼文の使い方

  • 依頼文は、そのままコピーしてAIに貼り付けられる形にしています。
  • WordPressのパスワード、アプリケーションパスワード、移行キーはAIに送らないでください。
  • AIツールによって、コマンドを実行する人が違います。依頼文はどちらの種類でも同じ文面で使えます。
    • ターミナルでコマンドを実行できるAIツール（Claude Code、Cursor、Codexなど）：依頼文を渡すと、AIがコマンドを実行します。
    • チャット型のAI（ChatGPT、Claudeのチャットなど）：AIが示したコマンドを、自分でターミナルに貼って実行します。

ステップ

ステップ1：移行前の記録を取る

移行を始める前に、移行後のサイトで維持する必要があるものを記録します。公式ドキュメントが挙げる項目は、現在のパーマリンク構造、正規のオリジン（canonical origin）、リダイレクト、メニュー、使っている投稿タイプ、タクソノミー、プラグインが持つフィールドです。

ステップ2：インポート方法を選ぶ

インポートの方法は2つあります。

方法 使える場合 取り込まれるデータ
WXRファイルのアップロード WordPressの「ツール → エクスポート」から書き出せる エクスポートに含まれるデータ。投稿、固定ページ、カスタム投稿タイプ、タクソノミーのターム、再利用ブロック、投稿者、添付ファイルのURLなど
EmDash Exporter WordPressサイトを管理していて、Exporterをインストールできる 認証が必要なコンテンツに加え、対応しているコメント、メニュー、サイト設定、SEOフィールド、タクソノミー、メディアのメタデータ

Exporterを使わずにサイトのURLだけを入力した場合は、WordPressの公開REST APIを調べるだけです。WordPressかどうかの判定や、公開されている投稿・固定ページ・メディアの数は分かりますが、REST APIから直接インポートすることはできません。（公式「WordPressからの移行」）

ステップ3a：WXRファイルを書き出す（WXRを使う場合）

WordPressで「ツール → エクスポート」を開き、「すべてのコンテンツ」を選択して、XMLのエクスポートファイルをダウンロードします。WXRファイルはWordPressのサーバー上のメディアを指しているだけで、添付ファイルそのものは含みません。（公式「WordPressからの移行」）

ステップ3b：移行キーを発行する（EmDash Exporterを使う場合）

WordPressで「ツール → EmDash Migration」を開き、移行キーを発行します。発行したキーを、EmDashのインポート画面に貼り付けます。

WordPressサイトのURLを入力する方法もあります。Exporterが検出されると、WordPressのアプリケーションパスワードの画面で、EmDashとの接続を許可します。ローカルのHTTPの開発サイトでは、許可のあとの戻り先にHTTPSが必要なため、WordPressのユーザー名とアプリケーションパスワードを手動で入力します。（公式「WordPressからの移行」）

ステップ4：管理画面でインポートする

  1. EmDashのサイドバーで「インポート」を開くか、/_emdash/admin/import/wordpress にアクセスします。
  2. WXRファイルをアップロードするか、Exporterの移行キーを貼り付けるか、WordPressのURLを入力します。
  3. 解析結果を確認します。WordPressの投稿タイプごとに、取り込み先のコレクション、必須フィールド、既存フィールドとの互換性を確認します。
  4. WordPressの投稿者をEmDashのユーザーに割り当てます。割り当てのない投稿者は、ゲストのバイラインとして表示できます。表示上のクレジットのためにEmDashのログインを発行する必要はありません。
  5. Exporterでインポートする場合は、メニュー、サイトタイトルとキャッチフレーズ、ロゴとファビコン、対応しているSEOの値を取り込むかを選択します。WXRの場合、この選択肢はありません。
  6. インポートを開始します。EmDashは、足りないコレクションとフィールドを作ってから、エントリーを作ります。

ステップ5：メディアを取り込む

添付ファイルが見つかった場合は、メディアの手順を実行します。EmDashは元のファイルをダウンロードし、設定済みのストレージに保存して、本文中の該当するURLを書き換えます。ダウンロードが終わるまで、元のサイトにアクセスできる状態を保ちます。（公式「WordPressからの移行」）

ステップ6：切り替え前に確認する

取り込んだサイトを、元のサイトと突き合わせて確認します。新しいサイトが本番で問題なく動き、巻き戻しが不要になるまで、バックアップとWordPressのサイトは残しておきます。（公式「WordPressからの移行」）

うまくいかないときの確認点

症状 確認すること 公式ページ
XMLファイルを解析できない WordPressの「ツール → エクスポート」からもう一度書き出し、ダウンロードが完了したかを確認します。文字コードを変えるツールでXMLを編集しないでください WordPressからの移行（トラブルシューティング）
コレクションが「非互換」と表示される 既存のフィールドに、同じスラッグで型の違うものがあります。投稿タイプの取り込み先を変えるか、「コンテンツタイプ」でフィールドを調整してからやり直します。準備の段階では足りないフィールドは追加されますが、既存のフィールドの型は変わりません WordPressからの移行（トラブルシューティング）、コンテンツのインポート（トラブルシューティング）
メディアのURLをダウンロードできない 元の添付ファイルに、WordPressにログインしていない状態でアクセスできるかを確認します。認証が必要なメディア、削除されたファイル、プライベートネットワークのアドレスへのリダイレクトは、個別に失敗してメディアのエラー一覧に残ります WordPressからの移行（トラブルシューティング）
サイトは検出されたが、直接インポートできない wordpress-rest の結果は調査だけです。WXRファイルをアップロードするか、EmDash Exporterをインストールしてもう一度調べます コンテンツのインポート（トラブルシューティング）
インポートが途中で止まった 既存のコンテンツは、WordPressのIDではなく、コレクション・スラッグ・ロケールで照合されます。やり直しの間にスラッグが変わった場合は、両方のエントリーを確認して重複を手作業で解消します。中断したあとは、WordPressのサイトを削除したりリダイレクトしたりしないでください WordPressからの移行（途中まで進んだインポートのやり直し）

このほかの症状は「つまずきやすいポイント」にまとめています。

根拠にした公式ページ

  • WordPressからの移行：https://docs.emdashcms.com/migration/from-wordpress/
  • コンテンツのインポート：https://docs.emdashcms.com/migration/content-import/
  • 認証：https://docs.emdashcms.com/guides/authentication/
  • AIツール向けDocs MCP：https://docs.emdashcms.com/docs-mcp/

次に読むページ