WordPress REST API 命令行工具

技能简介

本技能提供面向 WordPress REST API 的生产级命令行工具，支持文章、页面、分类、标签、用户等核心资源的读写操作，以及自定义 HTTP 请求。采用原生 fetch 实现，无额外 HTTP 依赖。

业务背景

面向运营与开发团队，本工具将WordPress内容管理从网页后台迁移至命令行环境。编辑人员可批量处理文章、页面及分类标签，无需逐条操作后台；技术团队则能通过标准化JSON接口实现内容自动化流转，衔接CI/CD流水线或定时任务，显著降低重复性人工操作成本。

落地案例：某内容团队每日需同步数十篇行业资讯至官网。通过配置站点地址与应用密码，成员可直接执行posts:create命令批量导入稿件，配合–query参数筛选待发布内容；同时利用JSON管道输出对接内部审核系统，实现"采集-编辑-发布"全链路无人值守运转。

能做什么

• 列出、获取、创建、更新、删除文章与页面
• 管理分类目录与标签
• 查询用户信息
• 执行自定义 API 请求
• 支持 JSON 管道输入输出，便于自动化流程集成

使用说明

环境准备

1. 确保 WordPress 站点已启用 REST API（现代 WordPress 默认开启）
2. 为目标用户创建应用密码（Application Password）
3. 确认用户具备适当角色权限（如编辑或管理员）

安装指令

cd wordpress
npm install

运行方式

# 查看帮助
node scripts/wp-cli.js help

# 列出最近5篇文章
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（user:app_password 的 base64）
• 用户名+应用密码：WP_USER + WP_APP_PASSWORD
• JWT 令牌：WP_JWT_TOKEN

必需环境变量

• WP_BASE_URL：WordPress 站点地址，如 https://example.com

输入约定

• JSON 数据可直接内联或通过 @文件路径 加载
• 查询参数使用 --query key=value（可重复）或 --query key1=value1,key2=value2

操作建议

• 只读列表调用建议附加 context=view
• 草稿内容使用 status=draft
• 编排层应对 429 及瞬时 5xx 错误实现重试

输入与输出

见下方输入与输出表格。

风险提示

• 禁止在日志或代码仓库中记录或提交令牌及应用密码
• 建议使用权限受限的专用 WordPress 账户
• 不适用于 OAuth 流程或复杂浏览器认证场景
• 不支持高级媒体上传（多部分流式传输）

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/codedao12/wordpress/SKILL.md
来源类型：GitHub 仓库