WordPressからNoteへ自動移行ツール【完全ガイド】設定・実行手順・トラブル対処

WordPressで長年書いてきた記事、移行を始めたはいいものの手作業で気力が持たず断念しかけた――そんな経験はありませんか。私も200本以上の記事を前にして「これを手で移すのは無理だ」と直感しました。衝動的に始めては飽き、気づけばハイパーフォーカスで数時間コマンドを書き続けることも。ADHD的な特性（決断疲れ、実行機能の弱さ、衝動的な作業開始）が混ざると、単純作業はとにかく苦痛です。そこで作ったのが「WordPressからNoteへ自動移行ツール」です。本記事では、なぜ作ったか、何ができるか、仕組み、環境、使い方（STEP0～7）、トラブル対応まで、現場目線で丁寧に解説します。エンジニアが使うことを前提に、実例と判断基準も交えてお伝えします。

なぜ作ったか — 感情と実務の両面から

単純に時間が足りなかった、というのが最初の動機です。1記事をNoteに移す作業は次のような手順が必要で、これを200回繰り返すと単純作業だけで数十時間になります。

• WordPress管理画面で記事をコピー
• Noteエディタで貼り付け、タイトル入力
• アイキャッチ画像をダウンロードしてアップロード
• ハッシュタグ設定、公開設定

この繰り返しはADHDの「実行が続かない」「決断疲れ」を加速させます。私はまず少数を手で移してみて、すぐに挫折しました。そこで「自動化すれば衝動で始めても、途中で止まっても再開できるはず」と考え、短いハイパーフォーカスタイムを利用して開発を始めました。

「これは絶対に自動化できるはずだ」と思い、このツールを作り始めました。

例えば、手作業で1記事5分かかると仮定すると、200記事で約16〜17時間。ツール化でこの時間が数十分に短縮されます。

実現できること（概要）

次の目的を自動化します。まずは目的をはっきりさせ、どこまで自分で確認すべきかを判断してください。以下は「何が自動化されるか」を一覧にしたものです。

どんな仕組みか（アーキテクチャ）

ツールは4つのステップに分かれ、順に実行します。技術的にはNode.jsで書かれ、ブラウザ自動操作にはPlaywrightを使用しています。人がブラウザでクリックや入力する代わりにプログラムが同じ操作を再現します。

STEP 1：WordPress記事の取り出し

WordPressのAPIを通じて記事データをすべて取り出し、テキストファイルに変換して保存します。

STEP 2：Noteへの自動投稿

ブラウザを自動で操作して、テキストファイルを1件ずつNoteのエディタに入力して保存します。

STEP 3：下書きの一括公開

Noteの下書き一覧を自動で開き、ハッシュタグを設定してから順番に公開していきます。

STEP 4：アイキャッチ画像の設定

WordPressのアイキャッチ画像をダウンロードしてNoteの各記事にアップロードします。

動作環境とソース

このツールは以下の環境で動作確認済みです。

• macOS 12 以上（推奨）
• Windows 10 / 11

ソースコードはGitHubで公開しています。自由にクローンしてカスタマイズしてください。

GitHubリポジトリ

GitHub - atueda/NoteWordpress

Contribute to atueda/NoteWordpress development by creating an account on GitHub.

github.com

使い方：STEP 0〜7（実行手順）

ここからは実際に使う手順を順番に説明します。エンジニアとしては「まず環境整備→検証→本番」の流れを守ると精神的負担が減ります。

STEP 0：Node.jsをインストールする

まずターミナルでバージョン確認します。

node -v

例：v22.0.0 のように表示されればOK。未インストールなら公式サイトからインストーラーを入手してください。

Node.js ??? Run JavaScript Everywhere

Node.js?? is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web...

nodejs.org

STEP 1：ツールをダウンロードする

GitHubからZIPでダウンロード、または git clone で取得します。

git clone https://github.com/atueda/NoteWordpress.git

STEP 2：フォルダを開く

ターミナルでツールのフォルダへ移動します。

cd ~/Downloads/wp-to-note

STEP 3：必要なソフトをインストールする

初回のみ実行します。

npm install
npx playwright install chromium

これで依存パッケージとChromiumがインストールされます。

STEP 4：設定ファイルを作成する

プロジェクトフォルダに .env を作成し、以下を記述します（例は抜粋）。

# WordPress 設定
WP_URL=https://あなたのWordPressサイトのURL
WP_PER_PAGE=20
WP_MAX_PAGES=11
WP_OUTPUT_DIR=./note-export

# Note 設定
NOTE_EMAIL=あなたのNoteのメールアドレス
NOTE_PASSWORD=あなたのNoteのパスワード
NOTE_TAGS=タグ1,タグ2,タグ3
NOTE_PUBLISH_MODE=draft

説明：NOTE_PUBLISH_MODE を draft にすれば一旦下書き保存されるため、安全です。公開モードは publish。

STEP 5：WordPressの記事を取得する

記事ファイルを生成します。

node wp-to-note.js

完了すると note-export フォルダに記事ごとのテキストファイルと _index.txt が生成されます。開発時のチェックポイントとして、まずは2〜3件だけ確認する習慣をつけるとよいです。

実行時の画面例

=== WordPress → Note 移行スクリプト ===
対象サイト: https://example.com
出力先: ./note-export/
記事を取得中...
ページ 1 を取得中... 20件取得
ページ 2 を取得中... 20件取得
ページ 3 を取得中... 20件取得
...
合計 205 件取得完了
ファイルを生成中...
[1/205] 001_記事タイトルの例.txt
[2/205] 002_別の記事タイトル.txt
...
✓ 完了！ 205 記事を取り出しました

STEP 6：Noteへ投稿する

実行するとブラウザが起動します。

node note-auto-post.js

投稿モードについて

設定ファイルの NOTE_PUBLISH_MODE を変えることで、投稿時の動作が変わります。

STEP 7：下書きをまとめて公開する（draft利用時）

NOTE_PUBLISH_MODE=draft を利用した場合のみ実行します。

node note-publish-one.js

この処理を行うと「下書きを探す → ハッシュタグを設定する → 公開する」を自動で繰り返します。Note上にある全ての下書き記事が公開されるまで処理が続きます。

実行時の画面例

公開処理 1 件目
下書き記事を発見しました
ハッシュタグを設定しています... #ADHD #大人の発達障害
公開しました
累計: 1 件公開
公開処理 2 件目
...
完了: 205 件公開しました

アイキャッチ画像をまとめて設定する（オプション）

WordPressの画像をNoteに反映する場合：

node note-set-eyecatch.js

STEP 5で取り出した記事のURLをもとに、WordPressのアイキャッチ画像を探してNoteにアップロードします。すでに画像が設定済みの記事はスキップされます。

途中で止まってしまった場合の再開方法

初めて使うときのおすすめ手順

いきなり全記事を公開するのではなく、まず少数で試してみることをおすすめします。

1. NOTE_PUBLISH_MODE=draft（下書き保存）に設定する
2. node wp-to-note.js でWordPressの記事を取得する
3. note-export フォルダのテキストファイルを数件確認する
4. node note-auto-post.js で下書きとして一括投稿する
5. Noteの管理画面でいくつか内容を確認する
6. 問題がなければ node note-publish-one.js で一括公開する
7. node note-set-eyecatch.js でアイキャッチ画像を設定する

トラブルシューティング（よくある問題と対応）

現場で実際に起きた問題と対処法を記します。まずは落ち着いてログを読み、progress ファイルを確認する習慣をつけるとADHDの「焦って間違える」状況を防げます。

開発プロセス：AI（Claude）との共同作業について

このツールはAIアシスタント（Claude）と対話しながら開発しました。要件を日本語で伝えることで、実際のコード生成や設計決定を補助してもらえました。私の経験から言うと、AIは「小さな反復的タスク」を素早くコード化してくれるため、ADHDの衝動的なやる気を短時間で形にするのに向いています。ただし、最終的なテストと例外処理は自分で確認する必要があります。

結論

手作業で200記事を移行するのは心身ともに負担が大きいです。自動移行ツールを使えば、記事取得→投稿→公開→アイキャッチ設定を効率化でき、精神的負荷も大幅に軽減できます。まずは小さく試し、問題がなければ本番で一気に移行するのがおすすめです。

よくある質問

Q. Nodeのバージョンは何が良いですか？

安定版（LTS）を推奨します。開発・本番で差異が出るとトラブルの元なので、nvm 等で固定してください。

Q. Noteの二段階認証がある場合はどうすればいいですか？

初回実行時に手動でログインして二段階認証を完了してください。一度セッション保存されれば次回は自動化できます。

Q. 途中で止まったらどうやって再開しますか？

note-post-progress.txt を確認し、表示された番号を note-auto-post.js の startFrom に設定して再実行してください。

Q. アイキャッチ画像が設定されない記事があるのはなぜですか？

WordPress側にアイキャッチが設定されていない場合はスキップされます。手動で差分を補完してください。

Q. Note側のUI変更でエラーが出た場合は？

まず GitHub の最新版に更新してください。UIが変わるとボタン位置などがずれるため、スクリプトの修正が必要です。

ここまで読んでいただきありがとうございます。まずは少数の記事で試し、動作を確認してから全件移行することを強くおすすめします。

投稿 WordPressからNoteへ自動移行ツール完全ガイド は ADHDエンジニア成長日記 ― 障害を抱えながらIT業界で活躍するためのブログ に最初に表示されました。

料理中に「次に何をすればよかったっけ？」と立ち止まってしまう経験は、ADHDの人だけでなく多くの人にとって身近な悩みです。しかし、特に注意散漫になりやすいADHDの特性を持つエンジニアにとっては、調理の途中で手順を飛ばしたり、食材を焦がしたり、作業の順序が崩れてしまうことが頻繁に起こります。本記事では、エンジニアの思考パターン（論理的分割、フロー設計、デバッグ）を活かしつつ、料理の手順忘れを劇的に減らすレシピの「構造化術」を紹介します。実践例、テンプレート、ツール活用法、トラブルシューティングの考え方までカバーします。

ADHDと料理の困りごと：何が問題か

ADHDの人は以下のような特性が料理中のミスにつながりやすいです。

• 注意持続が難しい：長時間の連続作業で注意力が低下する
• 作業の切り替えが難しい：同時進行のタスクで混乱しやすい
• ワーキングメモリが弱い：次に何をするかを頭の中で保持するのが困難
• 刺激追求傾向：新しいことに注意が移りやすい（スマホ通知など）

これらを理解した上で、対策は「頭の中で覚えておく負担を減らす」ことが基本です。外部に手順を出し、視覚化・時間化し、エラーに強い構造を作ることが有効です。

基本原則：外部化・単純化・可視化

まず押さえるべき3つの原則：

1. 外部化（Offload memory）
   • 頭の中で覚えず、紙やデバイスに書く。
2. 単純化（Reduce cognitive load）
   • タスクを小さな単位に分割し、一度に一つだけ意識する。
3. 可視化（Make state visible）
   • 今の進捗や残タスクを見える化する（チェックリスト、進捗バーなど）。

これらはエンジニアが設計でよく使う考え方（キャッシュ、分割統治、ロギング）と対応します。料理に応用することで、手順忘れを劇的に減らせます。

エンジニア視点でのレシピ設計：モジュール化・フロー制御・条件分岐

エンジニアの思考法を料理レシピに落とし込むと、次のような要素が有効です。

• モジュール化（関数化）
  • レシピを「下ごしらえモジュール」「加熱モジュール」「仕上げモジュール」などに分ける。
  • それぞれのモジュールは独立してテスト（実行）できるべき。
• フロー制御（シーケンス）
  • ステップを厳密に番号付けし、前提条件（preconditions）を明記する。
  • 各ステップに「期待する状態（expected state）」を記載するとチェックしやすい。
• 条件分岐（if/else）
  • 料理は生ものや火加減で変わるため、状況に応じた分岐を事前に書く。
  • 例：「もしソースが濃すぎたら水を追加」「もし焦げ付き始めたら弱火にする」など。
• 同期と非同期の扱い（Concurrency）
  • 何が並列で可能か、何が直列（順に）でなければならないかを区別する。
  • 例：ご飯を炊くのはほぼ非同期（待ち時間あり）だが、卵を炒める手順は短時間で注意が必要（直列）。

実践テクニック

1. チェックリスト化：最も簡単で効果的

• 「やること」を箇条書きにして、逐次チェックするだけで作業負荷が下がります。
• チェックボックスは視覚的満足感を与え、続行意欲を高めます。

例：

• [ ] ご飯を炊く（30分）
• [ ] 玉ねぎをみじん切り
• [ ] フライパンを温める

2. Mise en place（ミゼンプラス）：事前準備の徹底

• 使う食材・器具をすべて並べ、分量を計っておく。
• 「始める前に全部揃っていないと始めない」というルールにすると手順忘れが減ります。

3. タイムライン化（時間管理）

• 所要時間を書いたタイムラインを作る。たとえば「00:00 炊飯開始、00:10 下ごしらえ完了、00:12 フライパンに油」など。
• タイマを複数使い分け（キッチンタイマー、スマホ、スマートスピーカー）。

4. 小さなタスクに分割（マイクロステップ）

• 「玉ねぎを切る」ではなく、「玉ねぎの皮をむく→上下を切る→縦に切る→横に切る」と細分化する。
• ADHDの人は「次に何をすればいい？」が明確だと動きやすい。

5. 目で見えるトリガー（ポストイット・ラベル・色分け）

• ステンレスのボウルに「下ごしらえ済」と貼る、フライパンに材を置いておくなど。
• 色分けした器に分配しておくと忘れにくい。

6. 音声アシスタント・リマインダ活用

• 「OK Google、5分経ったら教えて」などタイマーやリマインダを活用。
• スマホのリマインダにステップごとの通知を設定。

7. 進捗ログ（クックログ）

• 失敗や成功を短く記録しておく（日時、気温、材料の違い、調理時間）。
• エンジニアなら「コミットログ」風に書くと楽しい（例：2026-05-21: 玉ねぎを焦がした→弱火にするフラグ追加）。

レシピテンプレート：構造化フォーマット（使い回し可能）

以下は構造化されたレシピテンプレートの例です。印刷して使うか、スマホに保存しておくと便利です。

レシピ名：
所要時間：総（　　　）分（準備：　　分／調理：　　分）
サービング：　　　　人分
難易度：

メタ情報：
- 事前準備（必須/任意）：
- 必要器具：
- アレルギー注意：

材料（工程別にグループ化）：
- 下ごしらえ：
  - 玉ねぎ：1個（みじん切り）
  - 卵：2個（溶く）
- 調理：
  - ご飯：茶碗2杯
  - 醤油：大さじ1

タイムライン（推奨）：
00:00 炊飯開始（またはご飯を用意）
00:05 玉ねぎの皮をむく/みじん切り
00:10 フライパン予熱/油を入れる
00:12 炒め開始

ステップ（番号と期待状態を明記）：
1. 前提：ご飯が炊けている／冷やご飯を用意済（期待：粒がほぐれている）
2. フライパンを中火で温める（期待：水滴で弾く程度）
3. 玉ねぎを入れ、透明になるまで炒める（期待：透明化／焦げない）
...
チェックポイント（必須確認）：
- 塩味のチェック
- 粒感の確認（焦げ付きなし）
条件分岐（if / else）：
- もし焦げ付き始めたら→火を弱め、油を追加
- もし味が薄ければ→醤油を少量ずつ足す

後処理：
- 火を止めるタイミング
- 片付けの手順（使った器具はすぐ洗う／放置OK）

トラブルログ（メモ欄）

このテンプレートをコピーして、よく作る料理ごとにバージョン管理（ファイル名に日付）をすると、改善サイクルが回せます。

具体的な料理例：チャーハン（炒飯）を構造化してみる

以下は「手順忘れ」を防ぐために構造化したチャーハンの例です。工程別に材料を分け、タイムラインと条件分岐を明記しています。

タイトル：基本のチャーハン（2人分）
所要時間：20分（準備10分／調理10分）

メタ情報：

• 必要器具：フライパン、中華鍋、ボウル、ヘラ
• 前提：ご飯は冷やご飯推奨（粘りが少ない）

材料：

• 冷やご飯：茶碗2杯
• 卵：2個
• ネギ：1本（小口切り）
• ハムorベーコン：50g（1cm角）
• 塩：小さじ1/2
• 醤油：小さじ1
• 胡椒：少々
• 油：大さじ1.5

下ごしらえ：

• 卵を溶いて塩少々を混ぜる（ボウルA）
• ネギを切る（ボウルB）
• ハムを切る（ボウルC）
• ご飯の塊をほぐしておく（ボウルD）

タイムライン（推奨、開始→完了）：
00:00 フライパンを中火で温める、油を入れる
00:01 ハムを炒める（30秒〜1分）
00:02 ご飯投入→中火でほぐす（1分）
00:03 溶き卵を回しかける→手早く混ぜる（30秒）
00:04 醤油とネギを加えて味を整える（30秒）
00:05 火を止め、皿に盛る

ステップ（期待状態を記載）：

1. 前提：全材料がボウルに分けられている（期待：手が塞がれても次の材料がすぐ取れる）
2. フライパンを中火で温め、油を入れる（期待：油が拡がる）
3. ハムを炒めて香りが出たらご飯を入れる（期待：ご飯がほぐれる）
4. ご飯が温まって粒が分かれるようになったら、溶き卵を周囲に回し入れる（期待：卵が固まり始めるが焦げない）
5. 全体を手早く混ぜ合わせ、最後に醤油を鍋肌から回し入れる（期待：香ばしさが増す）
6. 味見→必要なら塩・胡椒で調整（期待：塩気が均一）

条件分岐（if/else）：

• もしご飯がべちゃべちゃ→ご飯を広げて水分を飛ばす／火力を上げ気味にして短時間で炒める
• もし卵が固まりすぎてパサつく→火を弱め、サッと混ぜる
• もし焦げる兆候→即座に火を弱め、ヘラで底をこそげる

チェックポイント（作業中に必ず確認）：

• ご飯がほぐれているか（粒感）
• 卵がひとかたまりになっていないか（均一に混ざっているか）
• 焦げ付きの兆候がないか（鍋底を確認）

後処理：

• 火を止める→余熱で1分置くことで味が馴染むことがある
• 使った器具を普段通りに洗う（「洗い物タイマー」を設定しておくと片付け忘れ防止）

この構造なら「溶き卵を入れ忘れた」「醤油を入れたか忘れた」などのミスを減らすことができます。チェックポイントで味見や状態確認を組み込むのがポイントです。

ツールとガジェット：アプリ・ハードウェア活用法

• 紙のテンプレート（キッチンに貼る）：
  • 印刷したテンプレートに手書きでチェック。ADHDの人は物理的に触れるものが習慣化しやすい。
• スマホのリマインダ / タイマー：
  • ステップ毎に通知を設定。短い音で注意を引く。
• スマートスピーカー（音声アシスタント）：
  • 「次のステップ教えて」や「10分タイマーセット」など音声で操作。手が汚れていても使えるのが利点。
• レシピ管理アプリ（写真・チェックリスト付き）：
  • 手順を分けて保存、写真と合わせて保存しておくとビジュアルで確認可能。
• カラフルな容器やラベリング：
  • 食材を小分けにして色つきのボウルに入れておくと見落としが少ない。
• スマート時計（振動リマインド）：
  • 振動で気付けるのでキッチンの騒がしさに紛れにくい。

デバッグ術：失敗したときの振り返りと改善

エンジニアはバグ発生時にログを見て再現手順を洗い出します。同じ手法を料理に応用します。

1. 事象を記録（What happened）
   • 何を忘れたか、何が焦げたか。具体的にメモ（例：「卵入れ忘れ」「焦げ目が付いた」）。
2. 再現手順を洗い出す（How to reproduce）
   • どの手順で注意が逸れたか、どのタイミングで別作業に移ったか。
3. 根本原因を仮説化（Why）
   • 「下ごしらえが不十分でバタバタした」「スマホ通知で気が散った」など。
4. 改善策を導入（Fix）
   • スマホを別室に置く、下ごしらえのチェックリストを追加、ステップをさらに細分化する。
5. 再実行して確認（Verify）
   • 改善を施したレシピで再度作ってみて、ログを比較。

このサイクルを短く回すと、レシピはどんどん改善され、手順忘れの頻度は下がります。

習慣化・環境設計：忘れにくいキッチン作り

• 「作業開始の儀式」を作る：
  • 例：「タイマーを3分セット→エプロンをつける→手を洗う」など。毎回同じルーチンにすることで心理的にスタートが切りやすくなる。
• 余分な刺激を減らす：
  • スマホの通知をオフ、キッチンBGMは単調なものにする（変化が少ないほど注意は逸れにくい）。
• 作業スペースを最小限に：
  • 物が多いと注意が散るため、必要な器具だけを出す。
• 「一時停止ステーション」を作る：
  • 作業中に中断が必要になったとき、どの状態で一時停止するかのルールを決める（例：「フライパンは火を止める」「具材は蓋をして保温」）。

よくある質問（短めのQ&A）

Q：細かく分けすぎると作業が遅くならない？
A：最初は時間がかかるかもしれませんが、ミスが減ることで総合的な時短になります。慣れると効率が上がります。

Q：家族と料理を分担するときは？
A：各人に「担当モジュール」を割り当てる（下ごしらえ係・炒め係など）。コミュニケーション用チェックリストを共有すると連携が楽になります。

Q：外食や惣菜を活用しても構造化は必要？
A：必要です。惣菜を使う場合は「温め・盛り付け」手順をテンプレ化すると忘れにくいです。

結論（まとめ）

ADHDの特性を持つエンジニアは、論理的な思考と構造化の強みを活かせば、料理中の手順忘れを大幅に減らすことができます。ポイントは「頭で覚えない」こと——外部化と可視化、タスクの単純化、条件分岐の明文化、タイムラインの設定、そして実験（デバッグ）による継続的改善です。最初はテンプレートやチェックリストを用いることが最も効果的。慣れてきたら、自分なりの最小限の指示セットが作れるようになります。

まずは一つのレシピをテンプレ化してみましょう。下ごしらえを完了させ、タイマーをセットし、チェックボックスを一つずつ埋めていく――その小さな成功体験が継続と自信につながります。料理はエンジニアリングです。構造化して、焦らず、楽しく作っていきましょう。

投稿 料理の「手順忘れ」をなくす！ADHDエンジニアのためのレシピ構造化術 は ADHDエンジニア成長日記 ― 障害を抱えながらIT業界で活躍するためのブログ に最初に表示されました。