文档
一个 Key、一个余额、一条 /v1/run。Agent 直接读 https://haitu.mumong.cn/SKILL.md 即可。
调用
POST https://haitu.mumong.cn/v1/run
Authorization: Bearer <key>
X-Playbook: buyers.multichannel@1 # 可选，账本归因
X-Step: S1 # 可选
{"endpoint":"maps/search","input":{"q":"nuts wholesale","location":"Berlin,Germany"},"country":"DE"}
→ {"run_id","cost":{"usd","costCny","priceCny","feeCny","cny","billing","units"},"route":{"adapterId","attempted"},"count","fetched_at","source_urls","data"}其他：GET /v1/discover?q= 自然语言找端点；POST /v1/estimate 只估价；GET /v1/balance；GET /v1/runs；POST /v1/runs/:id/dispute；GET /v1/catalog；GET /v1/routing/:endpoint；GET /v1/playbooks。错误统一为 {"error","message"}，失败不计费。
| HTTP | error | 含义 |
|---|---|---|
| 400 | invalid_input | 缺少 endpoint 或必填参数 |
| 401 | unauthorized | Key 无效、已吊销或账号停用 |
| 402 | insufficient_balance | 可用余额不足，先充值 |
| 404 | unknown_endpoint | 端点不存在，用 /v1/discover 找 |
| 409 | monthly_cap_reached | 本月预算已用完，去「预算」页调整 |
| 409 | dispute_window_closed | 超过争议窗口 |
| 413 | payload_too_large | 请求体超过 64KB |
| 429 | rate_limited | 超过每 Key 600 次/分钟 |
| 502 | upstream_failed | 上游失败（已尝试备用），不计费 |
| 503 | no_route | 该端点在该国家没有可用上游 |
端点
单价 = 上游实际成本 × 汇率 × 加价率，示例按各端点典型成本计| 端点 | 说明 | 输入 | 计费 | 参考单价 |
|---|---|---|---|---|
| maps/search | 按关键词和地点搜本地商户，含评分、电话、网站 | q* location* limit | per_call | ¥0.0166 |
| maps/profile | 单个商户完整档案：联系方式、营业时间、属性。按商户名 + 国家查，或传 maps/search 返回的 place_id | name place_id country | per_call | ¥0.0447 |
| serp/web | 区域网页搜索。引擎由路由表按国家决定，返回统一 Schema | q* country* lang page | per_call | ¥0.0166 |
| web/extract | 任意网页（含同站最多 5 页）按 JSON Schema 抽取结构化字段，适合参展商名录、协会会员表 | url* schema* instructions max_pages | per_call | ¥0.1656 |
| company/enrich | 按域名补全企业画像：规模、行业、社媒 | domain* | per_call | ¥0.1076 |
| trade/importers | 海关提单数据：按产品关键词 / HS 编码 / 目的国找进口商，带交易次数与金额 | q hs_code country limit start_date end_date | per_result | ¥0.1573 |
| email/find | 姓名 + 域名推断邮箱，带置信度。按上游条款 BYOK：自带 Hunter API Key（input.api_key），费用由 Hunter 直接向你收取，海图 0 元 | api_key* domain* first_name last_name | byok | 0（自带 Key） |