WordPressの2つのブログをAstroに移行した(全307記事)


WordPressで運用してきた2つのブログを、Astroで作っているこのサイト(y16ra.dev)に統合しました。

  • 技術ブログ「y16ra.tech」:161記事(2017〜2025年)
  • ライフログ「tricoro.blog」:146記事

合計307記事です。2025年分の11記事は先に手作業で移行していたので、今回の対象は296記事でした。

移行の方針

先に決めたのは次のルールです。

  • 記事は選別せず、全部持っていく
  • スラッグ(URLの末尾)は英語・ローマ字に統一する
  • カテゴリは元のブログの表記のまま残す(「未分類」だけ除く)
  • アイキャッチ画像は本文の最初の画像を使う。なければなし
  • 画像は幅1,600pxを上限に圧縮する
  • URLが変わるので、旧URLから新URLへの対応表を作り、記事単位で301リダイレクト(恒久的な転送)する。設定は今後対応する予定です(詳しくは「残っている作業」に書きます)

旧ドメインは移行後も契約の更新時期まで残し、リダイレクト専用にします。

変換のやり方

公開されているWordPressの記事ページをスクリプトで取得し、Cocoonの本文部分を抜き出して、Astroのコンテンツ形式(src/content/blog/<年>/<スラッグ>/index.md+画像フォルダ)に一括変換しました。変換スクリプトの作成から細かい修正までは、AIエージェントに手伝ってもらいながら進めています。

結果は296記事・画像394枚です。プルリクエストでプレビューを確認しながら進めました。

つまずいた点

一括変換で本文の大部分はそのまま移せましたが、WordPress独自の表現があちこちに残りました。

ブログカードの崩れ

WordPressのリンクカード(ブログカード)で貼っていたリンクが、プレビュー画像やファビコン(ブラウザのタブに出る小さなアイコン)の断片だけを残して崩れていました。75記事・105件を通常のリンクに置き換えています。

ショートコードの残り

[embedyt] のような、WordPressで動画などを埋め込むための [...] 形式の記法(ショートコード)がそのまま残っていたものは、埋め込みに変換しました。SlideShareの埋め込みもありましたが、こちらは元のスライドがWordPress側でもすでに表示できなくなっていたため、スライドへのリンクに置き換えています。

消えた商品表

Amazonの商品名と価格を並べた表が、変換の過程で中身ごと消えてしまった記事がありました。12記事・18商品分を、商品ページへのリンク付きで復元しています。

長い年月のリンク切れ

  • 非公開になっていたYouTube動画(埋め込みが再生できない状態)
  • 画像のURL自体が404(ページが見つからないというHTTPのエラー)で、Web Archive(インターネット上のページを保存しているサービス)にも残っていないもの

後者は復元を諦め、壊れた画像参照を取り除きました。9年も運用していると、こういう「静かなリンク切れ」が積み上がっていることを実感します。

検証

マージ前にプレビュー環境で、移行した全記事の表示、ランダムに抜いた記事、既存の2025年記事を確認しました。本番反映後にも同じ観点で再確認しています。

残っている作業

旧ドメイン側のリダイレクト設定が残っています。対応表(307件)は作成済みです。サーバー(ConoHa WING)のファイルマネージャーは、10月29日に確認した時点でメンテナンスが明けていました(いつ明けたかは確認できていません)。.htaccess(サーバーの動作を指定する設定ファイル)の差し替えは、これから行います。これが終われば引っ越しは完了です。

おまけ:HTTPSの設定漏れ

移行とは別に、Search Consoleで「HTTPS が評価されていません」と出ているページがありました(対象例:https://y16ra.dev/blog/2026/claude-haiku-5-5/)。Search ConsoleはGoogleが提供する、サイトの検索まわりの状態を確認できるツールです。調べたところ、Cloudflareの「常にHTTPSを使用」がオフになっていたのが原因でした。これをオンにして、httpでアクセスしてもhttpsへ転送されるようにしています。

まとめ

  • 2つのWordPressブログ、307記事をAstroの1サイトに統合した
  • 一括変換のあと、ブログカード・ショートコード・商品表などの残件を個別に直した
  • 残りは旧ドメインのリダイレクト設定のみ
  • おまけとして、CloudflareのHTTPS設定漏れも直した

過去記事は資産なので、プラットフォームを変えても捨てずに済んでよかったです。今後の記事はこのサイトに一本化していきます。