1ms.tools
APIMCPSkills定价
REST · OpenAPI 3.1

SEO Checker API

通过 URL 提交网页 SEO 检测任务，将页面标题、描述、结构和链接等检查结果接入自己的报表与巡检流程。

  • 成功结果提供页面级 SEO 检查信息。它不代替搜索引擎排名数据，也不承诺收录或排名提升。
  • 成功任务 1 积分 / 次
  • 对外调用 10 次 / 分钟 / 账号
获取 API Key在线使用 API
响应结果预览

example.com

100/ 100 · 检测评分
1 通过0 注意0 未通过
网站访问

什么是 SEO Checker API？

通过 URL 提交网页 SEO 检测任务，将页面标题、描述、结构和链接等检查结果接入自己的报表与巡检流程。

应用场景

  • 发布前检查

    在 CMS 发布流程中检查网页，提前发现影响搜索收录的基础问题。

  • 网站定期巡检

    定期巡检网站，对比检测分数和问题变化，安排修复优先级。

  • 客户 SEO 报告

    为客户网站生成 SEO 检查报告，汇总问题与改进建议。

Playground

发送真实 API 请求，查看任务状态和返回结果。

输入
正在加载…

填写下面的字段即可开始。只有需要直接编辑请求内容时才切换到 JSON。

输入、来源或生成的 URL。

输出
运行 API 后在这里查看结果。

接口参考

将示例密钥替换为控制台创建的密钥。输入仅作为接入示例，完整字段和校验规则见 API 文档。 API 文档

请求示例
POST /openapi/v1/tools/1ms/seo-audit/execute
curl 'https://1ms.tools/openapi/v1/tools/1ms/seo-audit/execute' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -d '{"url":"https://example.com"}'

JSON 请求参数

字段类型必填检测到的网页描述，可能为 null。
urlstring必填输入、来源或生成的 URL。

data.result 结果字段

字段类型检测到的网页描述，可能为 null。
urlstring输入、来源或生成的 URL。
finalUrlstring重定向后的最终 URL。
summaryobject结构化摘要，上游未提供的字段可为 null。
checksarray逐项检查状态及建议。
suggestionsarray建议后续操作。
relatedToolsarray关联在线工具 slug。

响应示例

接口结构示例，非实时查询或注册局实测记录。
{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "succeeded",
    "result": {
      "url": "https://example.com",
      "finalUrl": "https://example.com/",
      "summary": {
        "status": "healthy",
        "score": 100,
        "passed": 1,
        "warnings": 0,
        "failed": 0
      },
      "checks": [],
      "suggestions": [],
      "relatedTools": []
    },
    "error": null,
    "creditCost": 1,
    "creditsRefunded": false,
    "pollAfterMs": 6000,
    "statusUrl": "/openapi/v1/jobs/JOB_ID"
  }
}
异步响应与结果获取
至少等待 6 秒后使用同一密钥查询。状态为 succeeded 时读取 result；failed 或 canceled 时读取 error。
curl 'https://1ms.tools/openapi/v1/jobs/JOB_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

成功结果提供页面级 SEO 检查信息。它不代替搜索引擎排名数据，也不承诺收录或排名提升。

需要处理的错误

执行错误通过失败任务的 data.error 返回。状态查询成功仍可返回 HTTP 200。

400参数不合法，不创建任务、不预扣积分。
401缺少密钥，密钥无效、撤销或过期。
402账号积分不足，不创建任务。
404资源不存在，或不属于当前账号。
409幂等键与参数冲突，或任务不能取消。
429账号调用额度达到上限，等待 Retry-After。
500提交异常，使用原幂等键重试确认。
在智能体中使用SEO Checker API
通过共用的 1ms.tools MCP 服务或 Agent Skill 调用 execute_1ms/seo_audit。共用 API Key 与计费标准，成功任务每次 1 积分。
MCP server Agent Skill

API 接入常见问题

通过 URL 提交网页 SEO 检测任务，将页面标题、描述、结构和链接等检查结果接入自己的报表与巡检流程。

成功结果提供页面级 SEO 检查信息。它不代替搜索引擎排名数据，也不承诺收录或排名提升。

可以。使用 API Key 或浏览器 OAuth 授权连接 MCP 服务，或安装可下载的 Agent Skill。这些入口均使用异步任务，共用账号积分与限流。

使用 Authorization: Bearer YOUR_API_KEY 或 X-API-Key 请求头。对外接口必须提供有效密钥，网页 Cookie 无法替代。请将密钥保存在服务器或可信应用环境中。

创建任务时预扣 1 积分，任务成功后完成计费。输入校验失败或积分不足时不创建任务、不扣积分。任务查询不扣积分，但计入调用次数。

任务执行失败、在服务端超时或排队时取消，预扣积分会自动全额退回账户，无需申请；成功完成的任务正常计费。仅排队中的任务可取消，关闭页面或客户端请求超时不代表任务已取消或失败。以任务最终状态和 creditsRefunded 字段为准，退回记录可在积分明细查看。

本接口使用异步任务，先返回 HTTP 202 和 Job ID。通过返回的 statusUrl 获取状态，成功后读取 result。建议使用 Idempotency-Key 处理提交重试。

每个账号每自然分钟最多 10 次对外业务请求，所有 Key 共用额度，与网页请求计数分开。任务查询、上传和执行都计入额度；遇到 429 时遵守 Retry-After。