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。