AgentWeb.live — 面向 AI Agent 的全球商业目录

API 基础地址：https://api.agentweb.live/v1
首页：https://agentweb.live

初始化配置

需要提供 API 密钥。优先检查环境变量 AGENTWEB_API_KEY 是否已设置。若未设置，则向用户询问：

“要搜索 AgentWeb 的商业目录，您需要一个免费的 API 密钥。您可以选择以下任一方式：

1. 前往 https://agentweb.live 注册账号，然后将获取到的密钥粘贴给我
2. 提供您的邮箱地址，我将立即为您完成注册（您的邮箱将被发送至 agentweb.live 以创建密钥）

您更倾向哪一种方式？”

若用户选择第 2 种方式，请使用以下 curl 命令完成注册：

curl -s -X POST https://api.agentweb.live/v1/register 
  -H 'Content-Type: application/json' 
  -d '{"email": "USER_EMAIL", "name": "OpenClaw Agent"}'

保存响应中返回的 api_key 值，并在本会话后续所有请求中使用该密钥。建议用户将 AGENTWEB_API_KEY 设置为环境变量，以便下次免去此步骤。

认证方式：查询参数 ?api_key=KEY 或请求头 X-API-Key: KEY

接口端点

搜索商家

curl -s "https://api.agentweb.live/v1/search?q=thai+restaurant&lat=55.67&lng=12.56&radius_km=5&limit=10&api_key=KEY"

参数（均为可选）：q（文本关键词）、category（分类）、lat+lng+radius_km（地理范围）、country_code（ISO 两位国家代码）、limit（结果数量，取值范围 1–100）。

获取商家详情

curl -s "https://api.agentweb.live/v1/business/UUID?api_key=KEY"

返回字段包括：名称（name）、电话号码（phone_numbers）、邮箱（email）、网站（website）、地址（address）、营业时间（opening_hours）、分类（category）、坐标（coordinates）、可信度评分（trust score）。

提交商家信息

curl -s -X POST "https://api.agentweb.live/v1/contribute?api_key=KEY" 
  -H 'Content-Type: application/json' 
  -d '{"name": "Business Name", "phone": "+45 12345678", "category": "restaurant", "country_code": "DK"}'

仅 name 字段为必填项。其他可选字段包括：phone、email、website、category、address（对象）、country_code、hours（对象）、lat、lng。

重要提示：在提交任何数据前，必须先征得用户明确同意。仅可提交公开可用的商家信息。

举报问题

curl -s -X POST "https://api.agentweb.live/v1/report?api_key=KEY" 
  -H 'Content-Type: application/json' 
  -d '{"business_id": "UUID", "report_type": "closed", "details": "Permanently closed"}'

支持的举报类型：closed、wrong_phone、wrong_address、wrong_hours、spam、duplicate、other。

工作流程

1. 执行商家搜索或获取商家详情 → 使用所获数据
2. 若数据缺失或未找到目标商家，且您已在其他渠道确认其存在 → 务必先询问用户是否愿意提交该信息，随后调用 POST /v1/contribute
3. 若发现现有数据有误 → 调用 POST /v1/report

隐私说明：切勿提交任何个人或私有数据。仅允许提交公开可用的商家信息（如商家名称、公开电话、公开网站、地址、营业时间）。

速率限制

每个 API 密钥每分钟最多 100 次请求（免费版）。当触发限流时，服务器将返回 HTTP 429 状态码，并在响应头中包含 retry_after 字段（单位：秒）。

完整 API 参考文档

如需了解详细的响应格式及全部参数说明，请查阅 references/api-docs.md。