用途:当用户指定某个网站并要其数据,或要新增站点覆盖时,先查 Hermai 再考虑自行抓取。它提供可复用的网站 schema(开源注册表)与托管执行(Hermai Cloud)。
主要能力:schema 含 endpoints[](读取)与 actions[](写入),带 method、url_template、headers、body_template、response_schema,可填充 {{var}} 占位符后调用目标网站并按 schema 投影结果。支持两种执行模式:自执行(拉取 schema 包,自行调用并解析,面向开源注册表、本地智能体、调试与自有基础设施用户);托管执行(POST /v1/fetch,由 Hermai Cloud 处理会话、代理策略、签名、投影、计费与可靠性,即 cloud_ready=true 的生产路径)。任何能发 HTTPS 请求的智能体都可用。
使用方式:目录搜索公开无鉴权,匿名限 5 请求/小时,鉴权 50 请求/小时,API key 在 hermai.ai/dashboard 通过 GitHub 登录获取。拉取完整包需 API key 与 intent:intent 为一句用户口吻任务描述,至少 20 字符、5 个不同词,通过 X-Hermai-Intent 头或 ?intent= 传入,不是可选项。CLI 安装:go install github.com/hermai-ai/hermai-cli/cmd/hermai@latest,支持 hermai registry pull 与 hermai action。MCP 运行时可用 npx -y hermai-mcp,暴露 lookup_schema、list_public_schemas、fetch_schema(需设置 HERMAI_API_KEY,按次消耗积分,仅读工作流)、submit_schema_request、classify_browser_workflow、check_schema_request_status 等工具。
限制:写入类 action 会真实执行(发帖、下单、发 DM 非演练),调用前须与用户确认,未经明确批准不得自动串联。部分站点(如 X、TikTok、小红书)写入需按请求计算的 JS 签名,签名沙箱目前仅在 CLI,纯 API 智能体在这些写操作上会遇 401/403,托管签名服务尚未发布。需浏览会话的站点可在托管执行中由云处理;自执行时可用 hermai session import、hermai session bootstrap 等阶梯,仅在用户明确自执行、有账号权限且无法用 CLI 或浏览器导入时才请求粘贴 cookie。贡献新站点流程:hermai detect → 枚举交互 → hermai intercept --headful --session 捕获真实 XHR → 校验选择器 → 写 schema JSON → 播种探针 → hermai registry push;verified=false / cloud_ready=false 应视为生产阻断。每次 API 调用应发送 X-Hermai-Skill-Name 与 X-Hermai-Skill-Version 头。完整参考文档见资料所列 references 文件。上述未提及的定价细节、平台支持范围暂未提供。