REST API + MCP 服务器

面向开发者与 AI 代理的
SEO 报告 API

通过 REST API 创建报告、轮询状态，并读取团队在网站上看到的同一份已保存报告对象。同一个 API 密钥即可连接任何支持 MCP 的代理。

访问模型

免费账户 + API 密钥

API 访问与账户关联。创建一个免费账户，发放一个 API 密钥，然后开始使用评分预览。评估路径不需要信用卡。

一个报告对象

网站会话、API 调用和代理会话均读取自相同的已保存报告状态。

简洁流程

创建报告，轮询状态，然后从同一对象读取预览或完整结果.

查看定价

可用端点

POST/api/v1/reports/preview

为合作伙伴和产品发布流程创建评分预览.

POST/api/v1/reports

创建新报告或重用已存在的报告.

GET/api/v1/reports/:id

获取最新报告状态和章节.

GET/api/v1/reports/:id/result

报告解锁后读取完整结果。

GET/api/v1/reports/:id/download?format=json

将报告负载导出为 JSON 以供程序化集成。

官方 TypeScript 客户端

零配置身份验证，免费层已准备好，启动平台已准备好.

查看启动平台集成查看文档

命令行

在终端运行报告。一次全局安装，即时预览.

Bash

npm install -g @seoreport/client

获取您的 API 密钥

MCP 服务器 — 同一套 API，同一把密钥

将任何支持 MCP 的客户端指向 https://seoreport.dev/mcp，并使用与 REST 相同的 Bearer API 密钥进行认证。连接时会自动公布报告与账户工具，代理无需任何胶水代码即可运行审计并读取结果。

MCP 客户端配置JSON

{
  "mcpServers": {
    "seoreport": {
      "url": "https://seoreport.dev/mcp",
      "headers": {
        "Authorization": "Bearer sr__live_your_api_key"
      }
    }
  }
}

create_report

为某个网址启动报告并获取任务 ID。

get_report_status

轮询任务，直到报告完成。

get_report

读取已完成报告的评分与发现项。

list_reports

列出账户下的报告。

get_report_download

获取 JSON、Markdown、文本或 PDF 的下载链接。

get_usage

查看剩余额度与当前计费周期。

结账、取消订阅和账户删除不会直接执行，而是返回一个浏览器确认链接。代理可以发起，但只有人才能完成。

代理配置指南完整 API 参考

示例响应JSON

{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

准备构建?

获取您的免费 API 密钥，并开始将 SEO 报告集成到您的产品中。

开始报告获取您的 API 键

面向开发者与 AI 代理的SEO 报告 API