WordPress REST API 技能（高级）

目的

提供一个可用于生产环境的 WordPress REST API 命令行工具（CLI），实现自动化操作。本技能聚焦于内容工作流（文章/页面）、分类法（分类目录/标签）、用户信息读取，以及在不依赖外部 HTTP 库的前提下执行安全的自定义请求。

适用场景

• 你需要一个稳定可靠的 CLI 工具来支持自动化任务或机器人工作流。
• 你希望输入和输出均为 JSON 格式，便于集成到数据处理流水线中。
• 你倾向使用原生、轻量的 HTTP 实现，不引入额外依赖。

不适用场景

• 你必须处理 OAuth 流程或复杂的基于浏览器的身份验证机制。
• 你需要高级媒体上传功能（例如 multipart 流式上传）。

前提要求

• Node.js 18+（以支持原生 fetch）。

一次性初始化配置

1. 启用 WordPress REST API（现代 WordPress 默认已启用）。
2. 为某位 WordPress 用户创建一个 Application Password。
3. 确认该用户拥有合适的角色权限（例如 Editor 或 Admin）。

安装

cd wordpress
npm install

运行

node scripts/wp-cli.js help
node scripts/wp-cli.js posts:list --query per_page=5
node scripts/wp-cli.js posts:create '@post.json'

你也可以通过 npm 运行：

npm run wp -- posts:list --query per_page=5

认证凭证

支持以下凭证方式（按顺序匹配，首个有效者生效）：

• Basic Auth Token：WP_BASIC_TOKEN（格式为 user:app_password 的 Base64 编码）
• 用户名 + 应用密码：WP_USER + WP_APP_PASSWORD
• JWT Bearer Token：WP_JWT_TOKEN

必需的环境变量

• WP_BASE_URL（例如：https://example.com）

输入约定

• JSON 数据可内联传入，也可通过 @path 从文件加载。
• 查询参数使用 --query key=value（可重复指定），或合并写为 --query key1=value1,key2=value2。

命令映射（高层概览）

文章（Posts）：

• posts:list、posts:get、posts:create、posts:update、posts:delete

页面（Pages）：

• pages:list、pages:get、pages:create、pages:update、pages:delete

分类法（Taxonomy）：

• categories:list、categories:create
• tags:list、tags:create

用户（Users）：

• users:list、users:get

高级功能（Advanced）：

• request（原始 HTTP 方法 + 路径）

运行建议

• 对只读列表类请求，优先使用 context=view。
• 在内容预发布阶段，请使用 status=draft。
• 在编排器（orchestrators）中应针对 429 及临时性 5xx 错误实现重试逻辑。

预期输出

• 标准输出（stdout）返回 JSON；出错时返回非零退出码。

安全注意事项

• 切勿记录或提交任何 Token 或 Application Password。
• 尽可能使用专用的低权限 WordPress 账户。