接入 AI Agent

RankLoop 检测出问题并给出结构化建议，AI 负责修复并重新提交。 平台本身不含 AI——判断由规则引擎给出，可复现、可解释。

为什么能自动闭环

Webhook 推送的是机器可读的结构化数据，不是给人看的文字。 接收端是人还是 AI，平台都不用改。

{
  "event": "content.gate_failed",
  "data": {
    "blocking": ["MISSING_TITLE", "EMPTY_CONTENT"],
    "score": 1
  },
  "links": {
    "recommendations": "/api/v1/contents/{id}/recommendations"
  }
}

拉取 recommendations 得到每条问题的规则码、证据、修复建议， 以及修好能加几分和大概要花几分钟—— 按性价比排好序，AI 从头做即可。

{
  "code": "MISSING_TITLE",
  "message": "页面缺少 title",
  "evidence": "title 为空或未提供",
  "recommendation": "添加 10-60 字符的标题，包含核心关键词。",
  "gain": 30, "minutes": 8, "blocking": true
}

三步接入

curl -X POST https://rankloop.miaokit.cloud/api/v1/webhooks \
  -H "Authorization: Bearer $RANKLOOP_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://your-app.com/hooks/rankloop"}'

GET /api/v1/contents/{contentId}/recommendations

PUT  /api/v1/contents/{contentId}
POST /api/v1/contents/{contentId}/publish

用 Python SDK 更省事

零依赖，把「被门槛拦截」做成可直接读取的异常。

pip install "git+https://github.com/LordFoxFairy/RankLoop.git#subdirectory=sdk/python"

from rankloop import Client

client = Client(api_key="rkl_live_xxx")
ok, todo = client.publish_when_ready(content_id)

if not ok:
    for r in todo:
        print(r.message, r.recommendation, f"约 {r.minutes} 分钟")

社区 SEO Skills

以下是社区维护的 SEO 技能包，可与 RankLoop 配合使用： 它们提供 SEO 知识与写作指导，RankLoop 提供可验证的检测与发布门槛。

SEO 相关 MCP Server

让 AI 直接读取搜索数据。注意 Google 官方没有 Search Console MCP，现有的都是第三方项目。

关于效果的说明

平台负责消除技术层面的障碍：拦截会导致不被收录的问题、 生成合规 sitemap 并提交 Search Console、发布后持续回读真实搜索表现。