Skip to main content
這份文件說明 Hermai 的 web data API:一個 schema registry 加上 hosted fetch API。查詢 registry 裡的網域,即可取得可呼叫端點清單:endpoint name、HTTP method、參數和回應形狀。你可以自行執行 schema,也可以對支援的端點呼叫 hosted fetch。
Hermai 的主要產品線是提供給機器人實驗室的 physical AI 訓練資料,不在本文件範圍內。本站只說明 web data API,也就是 hermai.ai/web-data 上的產品。

運作方式

用 CLI 貢獻

使用探索工具組(hermai detect、probe、extract、intercept)記錄網站端點,然後執行 hermai registry push 將其新增到目錄。

從 registry 查詢

呼叫 GET /v1/catalog/{domain} 取得該網站所有已知端點。社群貢獻的 schema 讓呼叫方複用既有探索工作。

Hosted fetch

呼叫 POST /v1/fetch,讓 Hermai 替你執行支援的已註冊端點並回傳結構化結果。
在 Claude Code、Codex、Cursor 或其他 coding agent 裡使用? 透過 npx skills add hermai-ai/hermai-skills 安裝 Hermai skills,替它加入 Hermai registry 工作流。

從這裡開始

Quickstart

註冊、取得 API key,並在兩分鐘內查詢第一份 schema。

Hermai 如何運作

心智模型:貢獻者負責探索,agent 負責使用。

Schemas

什麼是 schema、如何貢獻,以及認證徽章制度。

Catalog

agent 在執行期呼叫的查詢 API。

Hosted fetch

透過 Hermai 執行已註冊端點。

Brand API

把公司網域或工作 email 轉成結構化的品牌資料。

Actions

schema 提供的讀取與寫入動作。

MCP server

把 Hermai schema 暴露為本地 MCP tools。

API keys

驗證請求並管理存取權限。

開源

hermai-cli 以 AGPL-3.0 授權開源。你可以在本機執行探索工具,不需要註冊帳號。平台 registry 在此基礎上提供瀏覽、搜尋和 hosted fetch。