WordPressに記事を自動投稿する構成（REST API + アプリケーションパスワード）

結論：投稿の口は REST API、認証はアプリケーションパスワード

WordPress の記事投稿を自動化する場合、投稿先は /wp-json/wp/v2/posts です。ここに POST すれば記事が作れます。管理画面をブラウザで操作する必要はありません。

問題は認証です。認証にはアプリケーションパスワードを使い、管理画面のログインパスワードは使いません。自動化スクリプトの中に管理画面のログインパスワードを置くのは、そもそも用途が違います。アプリケーションパスワードは用途ごとに発行して、要らなくなったらその一本だけ止められる、という前提の仕組みです。

アプリケーションパスワードの発行

wp-cli が使える環境なら、コマンド一発で発行できます。

wp user application-password create ユーザー名 用途名 --porcelain

--porcelain を付けると発行された値だけが返るので、そのまま変数に受けて設定ファイルへ流し込めます。用途名を分けておけば、後から「どのスクリプト用の鍵か」が分かります。

アイキャッチ画像は「先にアップロード」する

ここは最初につまずきやすいところです。記事の POST に画像そのものを混ぜて投げることはできません。画像は先に /wp-json/wp/v2/media へアップロードし、返ってきた media_id を記事側に渡す、という二段構えになります。

1. /wp-json/wp/v2/media に画像をアップロードする
2. レスポンスから media_id を取り出す
3. /wp-json/wp/v2/posts への投稿時に、その media_id を渡す

つまり自動投稿スクリプトは、必ず2回以上 API を叩く構造になります。1リクエストで完結する想定で組むと、途中で作り直しになります。

カテゴリとタグは「名前」では渡せない

記事の投稿時に、カテゴリやタグを文字列で指定することはできません。渡すのは ID です。ですから、自動投稿の前に必ず次のどちらかが必要になります。

• 既存のカテゴリ・タグの ID を事前に取得しておく
• 存在しない場合は先に作成して、その ID を取得する

運用してみて分かったのは、この「無ければ作る」の分岐を最初から入れておかないと、記事は投稿できているのにカテゴリだけ付いていない、という中途半端な状態が生まれることです。

初期投入は wp-cli のほうが早い

すでに手元に記事の HTML がまとまってある、という状態からの初期投入なら、REST API より wp-cli のほうが速いです。

wp post create ファイル名.html --post_title=...

これで投稿できます。既存記事をまとめて入れる最初の一回は wp-cli、そこから先の継続的な自動投稿は REST API、という使い分けが実務的でした。

用途	向いている方法
手元の HTML をまとめて初期投入	wp-cli の wp post create
継続的な自動投稿	REST API /wp-json/wp/v2/posts

ハマったところ

日本語タイトルのパーマリンクが異常に長くなる

パーマリンク設定を「記事名」にしていると、日本語タイトルがそのままスラッグになり、URL エンコードされて非常に長い URL になります。自動投稿でタイトルを機械的に入れていると、これが全記事に発生します。

対策は、英語のスラッグを別途設定することです。自動投稿の側で、タイトルとは別にスラッグを持たせる設計にしておく必要があります。ここは後から一括で直すと手間になるので、最初から組み込んでおいたほうが良い部分です。

.htaccess が無くて固定ページが 404 になる

もうひとつは、環境構築側の話です。wp core install の直後に .htaccess が作られないことがあります。この状態だと、固定ページが 404 になります。

原因が分かるまでは「投稿は成功しているのにページが見えない」という状態に見えるので、API 側を疑ってしまいがちでした。実際には .htaccess を手で作れば直ります。自動投稿の不具合ではありませんでした。

この構成で何ができて、何ができないか

• REST API で記事本文を投稿する
• アイキャッチ画像をアップロードして記事に紐付ける
• カテゴリ・タグを ID で指定する（無ければ作成する）
• wp-cli で既存 HTML をまとめて初期投入する

• 1回のリクエストで画像ごと投稿する
• カテゴリ・タグを名前のまま渡す
• タイトルだけ渡して、まともな URL のスラッグを期待する

なお、長期運用でどこが壊れやすいのか、どのくらいの頻度でトラブルが起きるのかについては、まだ十分なデータがありません。現時点で確実に言えるのは、上に書いた「詰まった箇所」とその回避方法までです。