WordPress セットアップ

WordPress サイトに接続し、WP-CLI または REST API 経由のアクセスが機能することを確認します。コンテンツ管理と Elementor 編集に対応した検証済みの接続設定を生成します。

ワークフロー

ステップ 1: WP-CLI の確認

wp --version

インストールされていない場合、ユーザーにガイダンスを提供します:

# macOS/Linux
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

また、SSH エクステンションが利用可能であることを確認します(リモートサイトに必要):

wp package install wp-cli/ssh-command

ステップ 2: サイトに接続する

オプション A: WP-CLI over SSH (推奨)

wp --ssh=user@hostname/path/to/wordpress option get siteurl

一般的なパターン:

• Rocket.net: wp --ssh=user@hostname/www/sitename/public option get siteurl
• cPanel: wp --ssh=user@hostname/public_html option get siteurl
• カスタム: ユーザーに SSH ユーザー名、ホスト、WordPress パスを確認

まずは簡単なコマンドでテストします:

wp --ssh=user@host/path core version

オプション B: Application Password を使用した REST API

SSH が利用できない場合:

1. https://example.com/wp-admin/profile.php にアクセスします(またはブラウザオートメーションを使用)
2. "Application Passwords" セクションまでスクロール
3. 名前を入力(例: "Claude Code")して「新しい Application Password を追加」をクリック
4. 生成されたパスワードをコピーします(スペースは含まれていますが、認証では任意です)

接続をテストします:

curl -s https://example.com/wp-json/wp/v2/posts?per_page=1 \
  -u "username:xxxx xxxx xxxx xxxx xxxx xxxx" | jq '.[0].title'

ステップ 3: 認証情報を保存する

WP-CLI SSH の場合 — プロジェクトルートに wp-cli.yml を作成:

ssh:
  sitename:
    cmd: ssh -o StrictHostKeyChecking=no %pseudotty% user@hostname %cmd%
    url: /path/to/wordpress

その後、使用: wp @sitename option get siteurl

REST API の場合 — .dev.vars に保存:

WP_SITE_URL=https://example.com
WP_USERNAME=admin
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

.dev.vars が .gitignore に含まれていることを確認します。プロジェクト間での使用では、優先される secrets manager(環境変数、1Password CLI など)に保存します。

ステップ 4: 完全なアクセスを確認する

包括的なチェックを実行します:

# サイト情報
wp @sitename option get siteurl
wp @sitename option get blogname

# コンテンツアクセス
wp @sitename post list --post_type=page --posts_per_page=5 --fields=ID,post_title,post_status

# プラグインステータス(Elementor を確認)
wp @sitename plugin status elementor

# テーマ情報
wp @sitename theme status

ステップ 5: サイト設定を保存する

他のスキルが参照できるように wordpress.config.json を作成:

{
  "site": "example.com",
  "siteUrl": "https://example.com",
  "accessMethod": "ssh",
  "sshAlias": "sitename",
  "wpPath": "/path/to/wordpress",
  "hasElementor": true,
  "elementorVersion": "3.x.x"
}

---

重要なパターン

SSH 接続の問題

症状	解決方法
Permission denied (publickey)	SSH キーを確認: ssh -v user@host
SSH 経由で wp: command not found	WP-CLI がリモート PATH にない — フルパスを使用: /usr/local/bin/wp
Error: This does not appear to be a WordPress installation	パスが間違っている — wp-path 引数を確認
大規模操作でタイムアウト	--ssh=user@host/path --allow-root を追加するか SSH タイムアウトを増加

WP-CLI エイリアス

頻繁にアクセスするサイトに対して、~/.wp-cli/config.yml でエイリアスを定義:

@client1:
  ssh: user@client1.example.com/www/public
@client2:
  ssh: user@client2.rocketcdn.me/www/client2/public

その後: wp @client1 post list

REST API の落とし穴

• Application passwords は HTTPS が必要です(HTTP では機能しません)
• セキュリティプラグインによっては REST API をブロックする場合があります — 401/403 レスポンスを確認
• キャッシング プラグインは REST レスポンスを古いままにする可能性があります — ?_=${timestamp} キャッシュバスターを使用
• カスタム投稿タイプは API に表示されるようにするには show_in_rest: true が必要です

---

参照ファイル

• references/wp-cli-essentials.md — SSH エイリアスパターン、一般的なフラグ、トラブルシューティング