WordPress REST API 技能（高级）

目的

提供一个可用于生产环境的CLI，用于WordPress REST API自动化。此技能专注于内容工作流（文章/页面）、分类法（类别/标签）、用户读取以及安全的自定义请求，无需外部HTTP库。

最佳适用场景

• 您需要一个用于自动化和机器人工作流的稳定CLI。
• 您需要JSON输入/JSON输出的管道。
• 您更喜欢简单HTTP，无需额外依赖。

不适用场景

• 您必须处理OAuth流程或基于浏览器的复杂身份验证。
• 您需要高级媒体上传（多部分流式传输）。

要求

• Node.js 18+（用于原生fetch）。

一次性设置

1. 启用WordPress REST API（现代WordPress默认启用）。
2. 为WordPress用户创建一个应用程序密码。
3. 确认用户具有正确的角色（例如，编辑/管理员）。

安装

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

凭证

支持的选项（首次匹配优先）：

• 基本认证令牌：WP_BASIC_TOKEN（用户名:应用密码的 base64 编码）
• 用户名 + 应用密码：WP_USER+WP_APP_PASSWORD
• JWT 承载令牌：WP_JWT_TOKEN

必需的环境变量

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

输入约定

• JSON 可以内联或从文件加载，使用@路径。
• 查询参数使用--query 键=值（可重复）或--query 键1=值1,键2=值2。

命令映射（高层级）

文章：

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

页面：

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

分类法：

• categories:list,分类：创建
• 标签：列表,标签：创建

用户：

• 用户：列表,用户：获取

高级：

• 请求（原始方法 + 路径）

操作指南

• 对于只读列表调用，建议使用context=view。
• 暂存内容时，请使用status=draft。
• 在编排器中，为429和暂时性5xx错误实施重试机制。

预期输出

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

安全须知

• 切勿记录或提交令牌或应用程序密码。
• 尽可能使用专用的低权限WordPress账户。