はじめに

noteに記事が90本貯まってきました。さすがに増えてくると、見通しが悪くなります。そこで、WordPressに移行をします。
記事数が増えてくると、だんだん別の問題が出てきます。

それが、カテゴリーとタグの整理です。

WordPressの管理画面から1記事ずつ開いて、

カテゴリーを選ぶ
タグを付ける
slugを直す
次の記事へ行く

という作業を100回やるのは、なかなか厳しいです。

私は普段エンジニアではなく、マーケティングやデータ分析寄りの業務をしています。SQLを書くことはありますが、WordPressのAPIを日常的に触っているわけではありません。

ただ、最近Codex CLIを使うことで、こういう作業もかなり現実的にできるのではないかと思うようになりました。

今回は、Codex CLIを使って、WordPressの記事整理をするためのローカル環境を作った話です。

この記事では、まだWordPressの記事は更新しません。

まずは、

Codex CLIを使えるようにする
WordPress REST APIを叩く準備をする
.env で認証情報を管理する
AGENTS.md で安全ルールを書く

ところまでを扱います。

やりたいこと

最終的にやりたいことは、WordPressの記事100本を以下のように整理することです。

WordPress REST APIで既存記事を取得する
記事一覧をCSVに出力する
Codexでカテゴリー分類案を作る
CSVを人間が見直す
WordPressにカテゴリー・タグを一括反映する
長すぎるslugも短く整える

ただし、いきなり本番のWordPressを更新するのは怖いです。

そこで、最初から以下の方針にしました。

WordPress管理画面を直接操作しない
WordPress REST APIを使う
Pythonスクリプト経由で操作する
更新系処理は必ずdry-runをデフォルトにする
--apply を付けたときだけ更新する
最初は5件だけテストする
本文やタイトルは変更しない

AIエージェントに本番環境を触らせる場合、便利さより先に安全設計が必要だと思っています。

全体構成

今回作る作業ディレクトリは、だいたい以下のような構成です。

wp-codex-tools/
  .env
  .gitignore
  requirements.txt
  AGENTS.md

  scripts/
    wp_client.py
    export_posts.py
    classify_posts.py
    sync_taxonomies.py
    suggest_slugs.py
    apply_slugs.py

  data/
    posts_export.csv
    posts_export.json
    categorized_posts.csv
    taxonomy_map.json
    slug_suggestions.csv

今回の記事では、このうち以下を準備します。

wp-codex-tools/
  .env
  .gitignore
  requirements.txt
  AGENTS.md

  scripts/
  data/

実際にWordPress記事をCSVに出力するスクリプトは、次回の記事で扱います。

Codex CLIをインストールする

まずCodex CLIをインストールします。

私の環境はMacです。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

インストールできると、以下のような表示が出ました。

Codex CLI 0.141.0 installed successfully.

もし codex コマンドが見つからない場合は、PATHが通っていない可能性があります。

私の場合は以下のように案内されました。

export PATH="/Users/noriyuki/.local/bin:$PATH"

確認します。

codex --version

これでバージョンが表示されればOKです。

作業ディレクトリを作る

次に、WordPress整理用の作業ディレクトリを作ります。

mkdir ~/wp-codex-tools
cd ~/wp-codex-tools

Git管理もしておきます。

git init

必要なディレクトリを作ります。

mkdir -p scripts data

Python仮想環境を作る

WordPress REST APIを叩くために、Pythonの仮想環境を作ります。

python3 -m venv .venv
source .venv/bin/activate

必要なライブラリをインストールします。

pip install requests python-dotenv beautifulsoup4 pandas
pip freeze > requirements.txt

使うライブラリは以下です。

requests
- WordPress REST APIを叩く
python-dotenv
- .env から認証情報を読み込む
beautifulsoup4
- WordPress本文のHTMLからテキストを取り出す
pandas
- CSVの読み書きや確認に使う

WordPressのアプリケーションパスワードを発行する

WordPress REST APIを認証付きで使うために、WordPress側でアプリケーションパスワードを発行します。

WordPress管理画面で以下を開きます。

ユーザー
→ プロフィール
→ アプリケーションパスワード

名前は、たとえば以下のようにしました。

codex-local-wp-tools

発行されたパスワードは一度しか表示されないため、控えておきます。

ここで使うのは、WordPressの通常ログインパスワードではありません。

外部ツール用に発行する専用パスワードです。

.envを作る

認証情報は .env に書きます。

nano .env

中身は以下のようにします。

WP_BASE_URL=https://www.example.com
WP_USERNAME=your_wordpress_username
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

実際には、自分のWordPressのURL、ユーザー名、アプリケーションパスワードに置き換えます。

たとえば、WordPressのREST API Base URLは以下のようになります。

https://www.example.com/wp-json/wp/v2

注意点として、WP_USERNAME はメールアドレスで通る場合もありますが、WordPressのユーザー名が別に設定されている場合は、そのユーザー名を使う必要があります。

.gitignoreを作る

.env をGitに入れると危険です。

必ず .gitignore に入れます。

nano .gitignore

中身は以下です。

.env
.venv/
__pycache__/
data/*.csv
data/*.json
data/*.log

今回は記事データをCSVやJSONで出力するため、data/ 配下の生成ファイルもGit管理しない方針にしました。

AGENTS.mdを書く

ここが今回かなり重要です。

Codex CLIには、リポジトリ内に AGENTS.md を置くことで、そのプロジェクトで守ってほしいルールを書いておけます。

今回は、WordPress本番環境を扱う可能性があるため、最初に安全ルールを書いておきました。

# AGENTS.md

## このリポジトリの目的

WordPress REST APIを使って、既存投稿を取得し、カテゴリー・タグの分類案を作り、確認後にカテゴリー・タグだけを反映する。

## 絶対ルール

- `.env` の中身を表示しない。
- `WP_APP_PASSWORD` をログに出さない。
- WordPressへの更新処理は、必ず dry-run をデフォルトにする。
- `--apply` が指定されたときだけWordPressを更新する。
- 最初から全件更新しない。必ず `--limit 5` でテストできるようにする。
- 本文、タイトル、slug、公開状態、excerpt は変更しない。
- 変更してよいのは `categories` と `tags` のみ。
- 削除系APIは実装しない。
- 既存カテゴリー・タグがある場合は再利用する。
- 新規作成する場合は、作成前に一覧表示する。
- すべての更新前に対象 post_id, title, category, tags を表示する。
- APIエラー時も認証情報は表示しない。

## カテゴリー方針

メインカテゴリーは原則1つ。タグは複数可。

初期カテゴリー候補：

- 旅の設計
- ポイント・マイルをためる
- 旅行記
- クレカ・保険
- 通信・スマホ
- 家族・暮らしのデザイン
- 思考のデザイン

この AGENTS.md は、あとで本当に役立ちました。

実際にslugを変更しようとしたとき、Codexがこのルールを読んで、

現在の AGENTS.md と衝突するため実装できません。

と止めてくれました。

これはかなり良い挙動でした。

AIエージェントに「やって」と言うだけではなく、「やってはいけないこと」を先に書いておくのは大事だと感じました。

Codexを起動する

準備ができたら、作業ディレクトリでCodexを起動します。

cd ~/wp-codex-tools
source .venv/bin/activate
codex

最初は、Codexに以下のように指示しました。

このリポジトリで、WordPress REST APIを使って既存投稿を取得するPythonツールを作ってください。

前提：
- 認証情報は .env にあります。
- .env には WP_BASE_URL, WP_USERNAME, WP_APP_PASSWORD があります。
- WordPress REST API Base URL は WP_BASE_URL + /wp-json/wp/v2 です。

まず作るファイル：
- scripts/wp_client.py
- scripts/export_posts.py
- README.md

実装内容：
1. scripts/wp_client.py
   - .env を読み込む
   - WP_BASE_URL, WP_USERNAME, WP_APP_PASSWORD を取得する
   - Basic認証でWordPress REST APIを叩く
   - 共通の get/post 関数を用意する
   - 認証情報をログに出さない

2. scripts/export_posts.py
   - /wp/v2/posts から投稿を取得する
   - ページネーションに対応する
   - --limit N で取得件数を制限できる
   - --all で全件取得できる
   - data/posts_export.csv と data/posts_export.json に保存する

取得項目：
- post_id
- title
- slug
- date
- status
- link
- excerpt_text
- content_text の先頭2000文字
- categories のID配列
- tags のID配列

注意：
- WordPressへの更新はまだ実装しない
- 削除系APIは実装しない
- .env の中身は絶対に表示しない
- WP_APP_PASSWORDをログに出さない
- APIエラー時はHTTPステータスとエラー概要だけ表示する

このように、最初は「更新」ではなく「取得」だけを指示しました。

いきなりWordPressを更新する処理を作らせるよりも、まずは読み取りだけに限定した方が安心です。

今回のポイント

今回やったことは、コードそのものよりも、作業の土台作りです。

特に重要だったのは以下です。

WordPress管理画面を手作業で触らない
WordPress REST APIを使う前提にする
認証情報は .env に逃がす
.env はGit管理しない
Codexに作業ルールを伝えるため AGENTS.md を作る
更新処理はdry-run前提にする
最初は取得だけにする

Codex CLIを使うと、非エンジニアでもかなり高度な作業ができるようになります。

ただし、その分、本番環境を壊す可能性もあります。

だからこそ、最初に「安全柵」を作っておくことが大事だと思いました。

次回

次回は、WordPress REST APIを使って、既存記事をCSVにエクスポートします。

やることは以下です。

/wp/v2/posts から記事を取得する
ページネーションに対応する
タイトル、slug、本文、カテゴリー、タグを取り出す
posts_export.csv を作る
WordPressの記事100本を一覧データとして扱えるようにする

WordPress管理画面で1記事ずつ見るのではなく、記事群をCSVとして俯瞰できるようになると、かなり整理しやすくなります。