AgentWeb.live — Global Business Directory

检索 AgentWeb.live 全球商业目录：按关键词、类别、地理范围或国家搜索商家，获取名称、电话、邮箱、网站、地址、营业时间与坐标；支持贡献和纠错商家数据，需要免费 API 密钥，为多轮交互。

zerabic

热度 36.45

最近更新 2026-05-11 17:27:29

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 推荐

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add agentweb

Metadata

name: agentweb
description: Search and retrieve business data from the AgentWeb.live global business directory. Use when: user needs to find a business, get a phone number, address, email, website, or opening hours. Covers 11M+ businesses across 195 countries. Free API. Requires an API key from https://agentweb.live
metadata: {"openclaw":{"emoji":"🌐","requires":{"bins":["curl"],"envVars":["AGENTWEB_API_KEY"]},"primaryCredential":"AGENTWEB_API_KEY"}}

AgentWeb.live — Global Business Directory for AI Agents

API base: https://api.agentweb.live/v1
Homepage: https://agentweb.live

Setup

An API key is required. Check for AGENTWEB_API_KEY env var first. If not set, ask the user:

"To search AgentWeb's business directory, you'll need a free API key. You can either:

Sign up at https://agentweb.live and paste me the key

Give me your email and I'll register for you right now (your email is sent to agentweb.live to create the key)

Which do you prefer?"

If they choose option 2, register via curl:

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

Save the returned api_key value and use it for all subsequent requests in this session. Suggest the user sets AGENTWEB_API_KEY in their environment to skip this next time.

Auth: ?api_key=KEY or header X-API-Key: KEY

Endpoints

Search businesses

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"

Parameters (all optional): q (text), category, lat+lng+radius_km (geo), country_code (ISO 2-letter), limit (1-100).

Get business details

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

Returns: name, phone_numbers, email, website, address, opening_hours, category, coordinates, trust score.

Contribute a business

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"}'

Only name is required. Optional: phone, email, website, category, address (object), country_code, hours (object), lat, lng.

Important: Always ask the user for approval before contributing data. Only contribute publicly available business information.

Report a problem

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"}'

Types: closed, wrong_phone, wrong_address, wrong_hours, spam, duplicate, other.

Workflow

Search or get business → use the data
If data is missing or business not found, and you find it elsewhere → ask the user if they'd like to contribute it, then POST /v1/contribute
If data is wrong → POST /v1/report

Privacy: Never contribute personal/private data. Only contribute publicly available business information (name, public phone, public website, address, hours).

Rate Limits

100 requests/minute per key (free tier). 429 response includes retry_after seconds.

Full API Reference

For detailed response formats and all parameters, read references/api-docs.md.