把 RankOps AI 文章发布到你自己的网站

  ① 在 RankOps AI 这一侧                ② 你的网站
  ─────────────────────                ─────────────────────────────────
  发现关键词机会
  生成文章
  审核并通过
  发送已审核文章            ─────►    接收文章
                                       保存文章
  记录文章链接              ◄─────    返回文章链接

箭头左边的事情都在 RankOps AI 完成。你的网站只需要接收文章、返回上线 URL。

你只需要准备一个能接收文章的地址，然后回到 RankOps AI 保存发布连接。

适合谁看：负责给你的网站增加接收地址的开发者。

你的接收地址通过 HTTP POST 接收一篇已经在 RankOps AI 审核通过的文章。它把文章保存到你网站上，并把上线后的 URL 返回给 RankOps AI，方便我们记录文章发到了哪。

3.1 接口约定

方法和路径你自己定，但请求体格式是固定的。默认建议： POST /api/seo-content/publish

Authorization: Bearer SEO_CONTENT_PUBLISH_TOKEN

3.2 必填字段

3.3 可选字段

3.4 请求体示例

{
  "sourceArticleId": "rankops-article-id",
  "title": "Article title",
  "slug": "article-url-slug",
  "description": "Meta description",
  "content": "## Markdown 正文\n\n这里是正文段落，可以包含链接、列表和小标题。",
  "language": "en",
  "authorName": "RankOps AI",
  "authorImage": "https://example.com/avatar.png",
  "categories": ["SEO", "Content Marketing"],
  "tags": ["keyword research", "content strategy"],
  "status": "published"
}

3.5 成功响应示例

{
  "targetPostId": "post-id-from-your-site",
  "publishedUrl": "https://example.com/blog/article-url-slug",
  "status": "published",
  "slug": "article-url-slug"
}

3.6 连接测试（dryRun）

为什么有 dryRun：当用户在 RankOps AI 点击「测试连接」时，我们不想为了验证连接就在你网站上建一篇真文章。所以我们发一个 dryRun 请求。你的接收地址只需要验证安全 key，然后返回 { ok: true, dryRun: true }，不要写入任何东西。

测试连接时你的接收地址会收到这个请求体。只验证 token、返回成功，不要保存文章。

{
  "dryRun": true,
  "source": "rankops",
  "purpose": "connection_test"
}

3.7 连接测试成功响应

{
  "ok": true,
  "dryRun": true,
  "settings": {
    "autoCreateCategories": false,
    "autoCreateTags": true
  },
  "taxonomies": {
    "categories": [
      { "title": "Payroll and Benefits", "slug": "payroll" }
    ],
    "tags": [
      { "title": "payroll calculator", "slug": "payroll-calculator" }
    ]
  }
}

3.8 安全清单（必须做）

• 读取请求体之前，先验证 Authorization: Bearer <token> 请求头。
• token 只放在服务端环境变量里。不要写进前端代码，也不要提交到 git。
• 接收地址必须用 HTTPS。RankOps AI 不会调用纯 http 地址。
• token 不匹配时返回 401，不要返回 200。
• 如果接收地址公开可访问，加一道基础限流防止滥用。
• 文章已经保存并公开后，缓存刷新、IndexNow、Webhook、统计等发布后附加任务即使失败，接口仍然必须返回成功。附加任务失败只单独记日志，不能把已写入的文章返回为 500。

打开 RankOps AI 控制台 → 网站接入 → 选择要发布的网站，按下面对应关系填写：

目标类型       →  选择你的网站接收方式
Publish URL    →  你的网站接收地址
Security key   →  和接收地址里验证的安全 key 完全一致
保存设置       →  点击保存
测试连接       →  点击测试连接，确认连接已验证

点击「测试连接并获取分类与标签」，看到 ✓ 连接已验证 后，RankOps AI 会读取你的网站已有分类和标签。第一次先让文章保持手动发布，手动发送一篇文章检查标题、正文、分类、标签和 slug。

分类和标签不需要在 RankOps AI 手动填写。你的网站应该在测试连接响应里返回已有分类和标签。如果 RankOps AI 提示目标站没有返回分类与标签，请先在目标站创建分类 / 标签，或让开发者在 dryRun 响应里返回 taxonomies，然后回到 RankOps AI 点击「重新获取分类与标签」。

1. 1测试连接

   在 RankOps AI 网站接入页，点击已保存发布信息旁的「测试连接」按钮。

   成功：你的接收地址能接收请求，且安全 key 一致。
   失败：往下翻到「故障排查」。

2. 2先手动发布一篇

   在 RankOps AI 生成并审核一篇文章后，先手动触发发布。

   成功：文章出现在你的网站内容列表里。
   失败：在 RankOps AI 打开这篇文章，文章页会显示失败原因。

3. 3在网站后台检查这篇文章

   打开网站后台里的文章，确认标题、正文、分类、标签和 slug 都正确。

   成功：内容和你在 RankOps AI 审核时一致。
   失败：通常是字段映射问题，看下面「故障排查」。

4. 4确认后再开启自动处理

   第一篇确认无误后，再按你的需要开启发布计划，或把文章处理方式改成质检通过后自动处理。

   成功：URL 能打开一个公开文章页。
   失败：看下面「故障排查」里的「发布后 404」。