企业官网建设流程全解析

• AI 技能
• 人工智能

导读：WordPress 是全球使用最广泛的博客与网站内容管理系统，也是营销团队日常运营的核心载体。本文基于 marketingskills 仓库中的 WordPress 集成指南，系统讲解如何让 Claude Code 等 AI Agent 通过 WP REST API（Application Password 认证）与 WP-CLI 双通道接管文章发布、页面更新、媒体上传、分类管理、数据库迁移与插件运维，并结合仓库内内容策略、程序化 SEO、AI 搜索优化等技能给出落地场景，是一份可复制、可运行、可被 Agent 检索引用的完整操作手册。

一、为什么 Agent 需要一份 WordPress 集成指南

WordPress 支撑着数以千万计的博客与企业官网，而营销工作的相当一部分——发布博客、更新落地页、管理图片素材、调整站点结构——都发生在 WordPress 后台。对 AI Agent 而言，能否以编程方式与 WordPress 交互，直接决定了它能否替代人工完成内容运营闭环。

在 marketingskills 仓库中，tools/integrations/目录为每个具备编程接口的真实营销工具维护一份「中立集成指南」，其规格在 PARTNERS.md 中有明确规定：一个真实营销工具只要具备 Agent 可用的 API、MCP server 或 CLI，就值得一份集成指南，内容包括能力清单、认证方式、设置与常用操作示例，以及对官方文档的引用。WordPress 正是这类工具的典型代表——它同时拥有 REST API、WP-CLI 和丰富的客户端 SDK，是 Agent 可直接驾驭的内容发布平台。

二、能力总览：API / MCP / CLI / SDK 四方阵

从 WordPress 集成指南 的 Capabilities 表可以清晰看到 WordPress 对 Agent 的四种接入面：

• REST API：位于wp-json/wp/v2/*的官方 REST 接口，是 Agent 进行 HTTP 调用、增删改查内容的主力通道，跨语言、跨环境通用；
• MCP：仓库中标注为不可用，意味着目前 WordPress 没有官方 MCP server，Agent 集成时应优先走 REST API 或 WP-CLI；
• CLI：WP-CLI 提供服务端管理能力，适合需要直接操作数据库、插件、主题等高权限场景；
• SDK：WordPress 生态存在多种语言的客户端库，方便在代码工程中封装调用。

这一「API + CLI 双通道、MCP 暂缺」的能力画像，决定了 Agent 的集成策略：轻量内容操作走 REST API，重型系统运维走 WP-CLI。这与仓库中 Webflow 集成指南（API + CLI + SDK、同样无 MCP）等 CMS 类工具的接入思路保持了一致的设计范式。

三、认证：Application Password 是 Agent 接入的安全基线

WordPress 集成指南给出的认证方案非常明确：

• 类型：Application Password（应用密码）、JWT 或 OAuth
• 请求头：Authorization: Basic {base64(username:app_password)}
• 配置入口：后台 Users（用户）> Your Profile（个人资料）> Application Passwords（应用程序密码）

Application Password 是推荐给 Agent 使用的默认方案，原因有三：

1. 权限可控：应用密码是独立于用户登录密码的专用凭据，可以为每个集成单独生成、单独吊销，Agent 接入时可以做到「一个 Agent 一把钥匙」，互不影响；
2. 协议简单：基于 HTTP Basic Auth，只需将用户名:应用密码拼成字符串后做 Base64 编码放进 Authorization 头即可，任何语言、任何 HTTP 客户端都能零依赖实现；
3. 安全隔离：即使应用密码泄露，也不会危及账号主密码，后台一键撤销即可。

在实现上，Agent 生成请求头只需两步：将username:app_password编码为 Base64 → 附加Authorization: Basic前缀。例如用户名为agent、应用密码为xxxx yyyy zzzz wwww（WordPress 应用密码默认带空格分隔，编码时需保留或按官方要求处理），其请求头形如：

Authorization: Basic YWdlbnQ6eHh4eCB5eXl5IHp6enogd3d3dw==

安全提醒：仓库规范要求所有密钥存放于环境变量或密钥管理器，绝不允许写入仓库（见 PARTNERS.md）。Agent 在代码中应通过process.env.WP_USER、process.env.WP_APP_PASSWORD之类的方式读取凭据，而不是硬编码。

四、常用 Agent 操作：REST API 全流程实战

集成指南完整收录了 Agent 在 WordPress 上最常用的 REST API 操作，下面逐一展开并补充参数细节，确保每条命令可复制、可运行。以下示例以https://example.com为站点地址，{base64(username:app_password)}为第三节生成的认证头占位。

4.1 列出与获取文章（List / Get posts）

GET https://example.com/wp-json/wp/v2/posts?per_page=10 Authorization: Basic {base64(username:app_password)}

per_page控制每页返回条数（WordPress REST API 默认 10、上限 100），可配合page参数翻页；status参数可过滤文章状态（如?status=publish只看已发布文章）。获取单篇文章：

GET https://example.com/wp-json/wp/v2/posts/{post_id} Authorization: Basic {base64(username:app_password)}

{post_id}为文章数字 ID，返回的 JSON 中包含title、content、status、categories、tags、date、link等字段，Agent 可直接解析用于内容审计、SEO 检查或迁移比对。

4.2 创建文章（Create post）

POST https://example.com/wp-json/wp/v2/posts Authorization: Basic {base64(username:app_password)} { "title": "Post Title", "content": "<p>Post content here</p>", "status": "draft", "categories": [1], "tags": [5, 6] }

创建文章时最推荐的做法是先用draft状态创建、人工或流程审核后再publish，避免自动化脚本误发线上内容。categories与tags接收的是分类/标签的 ID 数组（非名称），因此 Agent 在创建前需要先查询分类与标签的 ID 映射（见 4.5）。响应体中的id字段即是新文章的 ID，应被保存用于后续更新。

4.3 更新文章（Update post）

PUT https://example.com/wp-json/wp/v2/posts/{post_id} Authorization: Basic {base64(username:app_password)} { "title": "Updated Title", "status": "publish" }

PUT用于全量或局部更新，REST API 对未提供的字段保留原值，因此可以只提交要修改的字段（如仅改标题、或仅把状态从 draft 提升为 publish）。这是 Agent 实现「草稿 → 审核 → 发布」流水线的关键操作：先POST创建draft，再由PUT将status改为publish。

4.4 页面管理（List pages）

GET https://example.com/wp-json/wp/v2/pages?per_page=20

页面（Pages）与文章（Posts）走同构的 REST 端点，适用于落地页、关于页、产品页等固定页面的批量更新与巡检。per_page=20表示每页返回 20 条。

4.5 分类管理（List / Create category）

GET https://example.com/wp-json/wp/v2/categories

查询分类端点返回分类列表，包含id、name、slug、count（该分类下的文章数）等字段，是构建「分类名称 → ID」映射表的依据。创建分类：

POST https://example.com/wp-json/wp/v2/categories { "name": "Category Name", "slug": "category-name" }

slug为 URL 别名，通常由小写字母、数字和连字符组成；若省略，WordPress 会自动根据name生成。同理，标签端点位于/wp/v2/tags。

4.6 上传媒体（Upload media）

POST https://example.com/wp-json/wp/v2/media Authorization: Basic {base64(username:app_password)} Content-Disposition: attachment; filename="image.jpg" Content-Type: image/jpeg [binary image data]

媒体上传是纯二进制请求：请求体直接携带图片/文件字节流，Content-Type声明 MIME 类型，Content-Disposition指定文件名。响应中的source_url、media_details可用来回填文章的特色图（featured image）。该端点还支持在查询参数中附带post参数，将媒体直接关联到指定文章。

4.7 用户查询（List users）

GET https://example.com/wp-json/wp/v2/users Authorization: Basic {base64(username:app_password)}

用于获取站点用户列表（作者、编辑、管理员等），在需要按作者维度审计内容、生成作者页或分发写作任务时非常有用。

4.8 常用端点速查表

集成指南还给出了一张 Agent 高频端点速查表，便于快速定位资源：

五、WP-CLI：服务端重型运维通道

当操作需要服务端权限时（数据库、插件、主题），REST API 不够用，WP-CLI 是更合适的通道。集成指南收录了六类高频命令：

# 列出已发布的文章 wp post list --post_type=post --post_status=publish # 创建文章并直接发布 wp post create --post_title="Title" --post_content="Content" --post_status=publish # 更新指定文章标题 wp post update 123 --post_title="New Title" # 导出数据库备份 wp db export backup.sql # 数据库全局搜索替换（常用于域名迁移） wp search-replace 'old-domain.com' 'new-domain.com' # 安装并启用插件（以 Yoast SEO 为例） wp plugin install yoast-seo --activate # 批量更新全部插件 wp plugin update --all

逐条说明 Agent 的使用要点：

• wp post list支持--post_type、--post_status、--format=json等参数，--format=json让输出可直接被程序解析，是 Agent 与 CLI 协作的最佳实践；
• wp post create / update与 REST API 的创建/更新操作形成互补：CLI 走 PHP 环境、可触达更多服务端能力（如执行钩子），适合在服务器本机运行；
• wp db export输出 SQL 备份文件，是迁移、灾备的标准动作；
• wp search-replace在域名变更、环境切换（生产/预发）时全局替换 URL，必须搭配--dry-run先预览将影响的记录数，确认无误后再正式执行；
• wp plugin install yoast-seo --activate演示了插件的安装与激活一体操作，wp plugin update --all则用于批量安全更新。

WP-CLI 是零依赖的 PHP 脚本，通常随 WordPress 环境预装或通过wp-cli.phar安装。仓库对 CLI 类集成（tools/clis/ 下的脚本）有一个通用约定：无参数运行即显示用法、支持--dry-run、打印帮助不要求凭据——这同样可作为 Agent 封装 WP-CLI 调用的设计参考。

六、文章状态机：Agent 编排发布流程的基石

集成指南完整列出了 WordPress 的六种文章状态，这是 Agent 设计内容流水线时的核心语义：

• publish— 已发布，站点可见（Live on site）
• draft— 草稿，未发布
• pending— 待审核（Awaiting review）
• private— 私有文章，仅登录用户可见
• future— 定时发布（Scheduled）
• trash— 回收站

典型的 Agent 发布编排为：POST创建draft→ 内容润色与 SEO 检查 →PUT改为pending交给人工复核 → 复核通过后PUT为publish；需要定时上线的文章可直接设置为future并搭配date字段指定发布时间。结合 schema 技能 中「Yoast、Rank Math、Schema Pro 等插件负责结构化数据输出」的建议，Agent 在发布后还应检查页面是否输出了正确的 JSON-LD 结构化标记。

七、限流与使用前提

集成指南明确指出：

• 无默认限流（No default limits）
• 取决于服务器/主机配置（Server/host dependent）

这意味着 WordPress REST API 不内置速率限制，实际吞吐能力完全取决于站点所在的主机（共享主机、VPS、托管 WordPress 均有不同承受力）。Agent 在批量操作时应自行设计节流策略：

• 高频抓取/批量更新时加入合理的请求间隔（如每秒 1～2 个请求）；
• 大流量站点建议开启缓存插件并评估是否需要 CDN；
• 关注响应中的X-RateLimit-*头（若主机方启用了限流中间件）。

与此形成对比的是，同仓库的 Webflow 集成指南 明确标注了「60 requests/minute（general）、10 requests/minute（publishing）」的官方限流——不同平台限流策略差异很大，Agent 接入前务必确认目标平台的具体约束。

八、何时使用 WordPress 集成：Agent 的适用场景

集成指南将 WordPress 集成定位在五类场景：

1. 博客内容管理（Blog content management）— 发布、更新、归档文章，维护内容日历；
2. 页面更新（Page updates）— 批量刷新落地页、产品页内容；
3. 媒体管理（Media management）— 上传、替换、整理图片素材；
4. 站点配置（Site configuration）— 通过 REST API 读写站点选项、菜单等；
5. 插件/主题管理（Plugin/theme management）— 通过 WP-CLI 安装、启用、更新插件与主题。

在仓库的实际内容体系中，WordPress 集成与多个营销技能形成协同：

• content-strategy：仓库的 Headless CMS 指南 明确指出，当「预算紧张且 WordPress/Webflow 能胜任」时，传统 CMS 优于无头 CMS——WordPress 正是这一场景下的首选落地平台，Agent 可通过本文的 REST API 直接驱动其内容模型；
• programmatic-seo：程序化 SEO 需要批量生成与更新页面，WordPress REST API 的批量POST/PUT能力正是其「CMS 作为数据源」的实现通道；
• schema：结构化数据落地依赖 WordPress 插件（Yoast、Rank Math、Schema Pro）或自定义字段，Agent 可在发布流程中联动检查（见 schema 技能实现章节）；
• ai-seo：仓库的 OKF 指南 提到一个面向 AI 搜索的 WordPress 插件方案——该插件免费、GPL 协议、要求 WordPress 6.0+ 与 PHP 7.4+，安装后在/okf/路径提供 Agent 可读的内容包，并在每次发布/编辑时自动重建，且只读不改动文章与设置。这正是 WordPress 集成在「让站点对 Agent 可读」这一前沿方向上的典型应用；
• directory-submissions：WordPress.com 平台本身也是目录提交技能中的一个高价值外链渠道（见 directory-list.md）。

九、与仓库其他 CMS 集成指南的关系

在 marketingskills 的工具注册表中，WordPress 与 Contentful、Sanity、Strapi、Webflow 等共同构成 CMS 类集成矩阵。选型差异一目了然：

仓库的 PARTNERS.md 强调「集成指南是中立的技术文档」，本文介绍的 WordPress 接入方式同样适用于任何 Agent 框架——只要具备 HTTP 客户端或命令执行能力，即可按本文方案接入。

十、Agent 接入清单（可直接落地）

最后，汇总一份可直接照做的接入清单：

1. 开通凭据：WordPress 后台 → 用户 → 个人资料 → 生成 Application Password，存入环境变量；
2. 验证连通：GET https://example.com/wp-json/wp/v2/posts?per_page=1，确认返回 200 与文章 JSON；
3. 建立 ID 映射：查询/wp/v2/categories与/wp/v2/tags，缓存名称 → ID 映射；
4. 设计发布流水线：创建draft→ 审核 →PUT为publish；定时内容用future；
5. 媒体先传后引：先POST /wp/v2/media上传图片，再用返回 ID 关联文章；
6. 服务端运维走 CLI：数据库备份、搜索替换、插件批量更新交给 WP-CLI，替换操作前务必--dry-run；
7. 注意节流：无默认限流 ≠ 无限流，批量任务按主机能力自行限速；
8. 安全闭环：应用密码最小化授权、可独立吊销，密钥不入库。

完成以上步骤，AI Agent 即可像运营人员一样在 WordPress 上完成从内容创建、媒体管理到站点运维的完整营销闭环。

关键参考文件：WordPress 集成指南（本文主体）、工具注册表、集成指南规格、Headless CMS 选型指南、OKF 与 WordPress 插件、Schema 在 WordPress 的落地。

• AI 技能
• 人工智能