WordPress REST API 内容同步

它解决什么问题

WordPress 多站点（multisite）部署下，不同站点之间的内容长期靠人工复制粘贴或整库导入导出，容易出现格式丢失、媒体引用失效、短代码指向错误等问题。这个技能把这件事收敛到官方提供的 REST 通道：通过 /wp/v2/posts 端点在站点之间结构化搬运文章、页面等对象，而不是简单拷贝原始 HTML。

技能如何工作

核心流程大致是：

• 认证：使用 OAuth 1.0a 对请求签名，两端都需正确配置 consumer key/secret，这是访问受保护资源的门槛；
• 内容搬运：从源站点拉取 /wp/v2/posts 的 JSON 数据，在目标站点按其结构重建文章，而非文本级拷贝；
• 媒体侧载：文中引用的图片等媒体会从源站下载并重新上传到目标站，替换掉原 URL，避免"图床永远指向源站"的外链依赖；
• 短代码转换：源内容里携带站点路径或 ID 的短代码会被改写为目标站点可用的形式；
• 冲突处理：源与目标已存在同 ID 或同标题内容时，按一套规则决定保留哪一份。

适用边界

几个注意点：方案依赖两端 REST API 与 OAuth 凭据的可用性，凭据轮换或权限收紧后同步会直接失败；它面向文章、页面这类结构化内容，自定义 post type 需要额外适配；上游仓库没有自动提取到完整的安装与使用说明，建议先审阅源码再投入敏感流程。