Agent Bridge 是一个 WordPress MCP（模型上下文协议）与 REST 桥接插件，专为 AI 智能体管理自托管 WordPress 站点（WordPress.org 安装，非 WordPress.com）的 SEO、schema 和安全而设计。它常与负责 Elementor 布局编辑的 EMCP 配合使用，Claude Code 是主要文档化客户端，但任何 MCP 客户端（如 Cursor、Windsurf、Codex CLI、Gemini CLI）都可通过官方 WordPress MCP Adapter 端点或 WordPress 应用密码连接 REST 接口。
用途
Agent Bridge 解决的是 Builder 类工具常忽略的一层：Rank Math SEO 字段、JSON-LD schema、内容快照，以及可验证收敛的还原。它不写入 _elementor_data，而是与 EMCP 分工——EMCP 编辑页面，Agent Bridge 负责 SEO、schema 与安全网。
主要能力
可验证写入
每次 SEO 字段或 schema 写入后，立即通过 get_post_meta() 从数据库回读。只有回读匹配才报告成功，并考虑 WordPress 自身的类型转换（数组顺序、数字字符串型图片 ID）。若不匹配，路由返回 500，并附带字段名、尝试写入的值以及数据库实际持有的值。
稳定内容哈希
每个页面和文章有一个 SHA-256 哈希，在文章本身、Elementor 数据、桥接范围内的 SEO 字段或 Rank Math schema 元数据变化时自动重新计算。哈希覆盖 post_content、逐字的 Elementor 数据块以及排序后的 SEO 与 schema 元数据，因此调用 /snapshot/manifest 即可获知全站每个页面和文章自上次查看后是否被改动。
可验证还原
还原快照文档需要先通过两个独立证明：一是文档自洽——请求中的 confirm 令牌须等于文档自身声明的哈希，且根据文档内容重新计算出的哈希须一致；二是调用者须证明刚刚读取了文章实时状态，即提供 Additive-Only 门所要求的请求头。两个门都通过后，还原会将文章内容、Elementor 数据、SEO 和 schema 收敛到文档所描述的状态，并删除文档未提及的字段，最后返回结果文档以供直接检查。
仅增量写入门（Additive-Only Gate）
针对在 Agent Bridge 激活前已存在的文章，写入默认被拒绝，除非请求通过在 X-Agent-Bridge-Confirm 请求头中发送该文章当前内容哈希，证明刚刚捕获了该文章的新鲜快照。激活后创建的内容不受此限制。站点可通过 agent_bridge_additive_only 过滤器关闭该门。
两个总开关
在 wp-config.php 中设置的两个 PHP 常量会在其他逻辑之前检查：AGENT_BRIDGE_DISABLED 使所有路由（包括读取）返回 503；AGENT_BRIDGE_READ_ONLY 拒绝所有写入（包括通过 GET 发出的快照 manifest 的 ?rebuild=1 哈希回填），但读取照常工作。两者均为配置时开关，不经 API 暴露。
缓存清理与验证
缓存清理是独立路由 POST /cache/purge，有意不并入写入路由，以支持“写入、清理 LiteSpeed 缓存、回读验证”的顺序，避免验证读取遇到缓存中的过期页面。
Abilities API 与 MCP
当 WordPress Abilities API 存在时（WordPress 6.9+ 内置，或旧核心通过独立 mcp-adapter 插件添加），Agent Bridge 在 agent-bridge 类别下注册八个能力。每个能力设置 meta.public = true，由官方 mcp-adapter 自动暴露为 MCP 工具。每个能力的 permission_callback 执行与 REST 对应项相同的权限、只读和仅增量检查。还原操作刻意未注册为能力，仅保留 REST，因其请求体（完整快照文档）不适合 Abilities API 的类型化输入模式。
支持的 SEO 字段
GET/POST /posts/{id}/seo 覆盖 15 个 Rank Math 字段。发送空字符串、空数组或 null 可清除该字段至默认值。*_image_id 字段与普通 *_image URL 字段并存：Rank Math 前端仅通过 _id 字段解析自定义 Open Graph 或 Twitter 图片，因此两者须同时设置图片才会显示。
使用方式
环境要求
- WordPress 6.9 或更高。
- PHP 8.1 或更高。
- HTTPS：所有路由强制，代理感知，仅可通过 agent_bridge_allow_http 过滤器在本地开发时关闭。
- Rank Math：仅 SEO 和 schema 路由需要；插件无它也可激活。
- LiteSpeed Cache：仅 /cache/purge 路由需要。
- WordPress Abilities API 与官方 mcp-adapter 插件：仅当希望将八个能力暴露为 MCP 工具而非直接调用 REST 时需要。
安装
- 从最新 release 下载 agent-bridge.zip（不要用 GitHub 的 “Source code” 归档），通过“插件 → 安装插件 → 上传插件”上传，或解压到 wp-content/plugins/agent-bridge/。
- 在插件页面激活 Agent Bridge。
- 为智能体使用的账户创建 WordPress 应用密码：用户 → 个人资料 → 应用程序密码。角色按需最小化：SEO 和 schema 路由仅需对目标文章的 edit_post 权限，Editor 账户即可满足常规内容工作。站点级路由（/health、/restore/{id}、/cache/purge、快照 manifest 的 ?rebuild=1 回填）需要 manage_options，须使用管理员能力账户。
- 调用 /health 确认插件可达（此调用需要上一步的管理员凭证）。
典型工作流
Claude Code + EMCP + Agent Bridge 的规范配置：在同一自托管 WordPress 上安装两个插件，创建一个应用密码供两者认证，分别按各自文档连接，并在项目指令中说明分工——“EMCP 编辑布局；Agent Bridge 是 SEO、schema 和安全的事实来源，在任何布局编辑前后都应调用”。示例：“更新 hero 区域，然后修正页面标题和 meta 描述”——Claude 先用 EMCP 编辑 hero，再调用 Agent Bridge 的 POST /posts/{id}/seo 更新 rank_math_title 和 rank_math_description，并回读确认值后再报告完成。完整设置见 docs/CLAUDE-CODE-SETUP.md。
路由参考
所有路由位于 agent-bridge/v1 命名空间：https://example.com/wp-json/agent-bridge/v1/...。每个路由要求 HTTPS 与已认证的 WordPress 用户。每个写入追加到 50 条滚动审计日志（时间戳、用户、路由、文章 ID，可通过 agent_bridge_audit 选项读取）；任何路由都不执行原始 SQL、不写文件系统、不发起出站 HTTP 请求。
限制与说明
- 仅支持自托管 WordPress（WordPress.org 安装），不支持 WordPress.com。
- 还原操作未注册为 MCP 能力，只能通过 REST 调用并需双重确认令牌。
- 写入到激活前已存在的文章需要额外提供当前内容哈希，否则被拒绝。
- 图片字段需同时设置 URL 和 _id 两个字段才会在前端显示。
- 快照 manifest 的 ?rebuild=1 回填属于通过 GET 发出的写入，在只读模式下同样被拒绝。
- 具体性能指标、收费与价格信息暂未提供。
