1ms.tools
APIMCPSkills定价
REST · OpenAPI 3.1

GEO Checker API

通过 API 检查网页的 AI 抓取访问、内容可读性、结构化数据和引用准备情况，获取 27 项 GEO 信号的检测结果。

  • 结果描述可观测的抓取与内容信号，不保证 AI 平台会引用网页。完整检查项和结果字段见接口文档。
  • 成功任务 1 积分 / 次
  • 对外调用 10 次 / 分钟 / 账号
获取 API Key在线使用 API
响应结果预览

example.com

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

什么是 GEO Checker API？

通过 API 检查网页的 AI 抓取访问、内容可读性、结构化数据和引用准备情况，获取 27 项 GEO 信号的检测结果。

应用场景

  • 网站上线检查

    网站发布前检查 AI 爬虫访问与内容结构，发现影响机器读取的问题。

  • 内容改版复查

    内容改版后复查可读性与结构化数据信号，确认变化是否引入问题。

  • 内容优化诊断

    为内容团队生成 GEO 诊断报告，按五个维度安排优化工作。

Playground

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

输入
正在加载…

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

输入、来源或生成的 URL。

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

接口参考

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

请求示例
POST /openapi/v1/tools/1ms/geo-audit/execute
curl 'https://1ms.tools/openapi/v1/tools/1ms/geo-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。
generatedAtstring报告生成时间。
summaryobject结构化摘要，上游未提供的字段可为 null。
sectionsarrayGEO 维度、分数及检查项。

响应示例

接口结构示例，非实时查询或注册局实测记录。
{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "succeeded",
    "result": {
      "url": "https://example.com",
      "finalUrl": "https://example.com/",
      "generatedAt": "2026-10-14T00:00:00.000Z",
      "summary": {
        "score": 100,
        "grade": "A",
        "passed": 1,
        "warnings": 0,
        "failed": 0,
        "info": 0
      },
      "sections": []
    },
    "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'

结果描述可观测的抓取与内容信号，不保证 AI 平台会引用网页。完整检查项和结果字段见接口文档。

需要处理的错误

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

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

API 接入常见问题

通过 API 检查网页的 AI 抓取访问、内容可读性、结构化数据和引用准备情况，获取 27 项 GEO 信号的检测结果。

结果描述可观测的抓取与内容信号，不保证 AI 平台会引用网页。完整检查项和结果字段见接口文档。

可以。使用 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。