# AgentWeb

> The internet for AI agents. 85M+ businesses across 195 countries plus LIVE local business search (real-time ratings, hours, phone). Never returns empty — discovers unknown businesses from the web in real-time. 23 tools + agent memory.

AgentWeb is infrastructure for AI agents. Search any business, get structured data back in ~200ms. If a business isn't in the database, AgentWeb discovers it from the web in real-time (~3s) and saves it permanently. Free API key (instant signup, 1,000 reads/day). Returns markdown prose by default (~60% fewer tokens). Agent memory remembers past searches. Owner-claimable profiles.

## Agent self-install

Any AI agent can install AgentWeb by reading: https://agentweb.live/install.md

## Quick start for agents

Every endpoint requires a free API key. Signup is instant (no verification, no credit card): https://agentweb.live/#signup

**Responses default to markdown prose** — ~60% fewer tokens than JSON, better LLM parsing accuracy. Hand the response directly to your model without any parsing.

```
GET https://api.agentweb.live/v1/search?q=noma&country=DK&format=text
Header: X-API-Key: aw_live_...
```

Returns a single markdown document with every matching business labeled as key:value lines. Example:

```
# AgentWeb search — "noma", country=DK
3 total results · showing 3 (offset 0)

## 1. Noma
- Category: restaurant (regional, gourmet, 2-star)
- Phone: +45 32 96 32 97
- Email: noma@noma.dk
- Hours: Tue-Thu 17:00-23:00, Fri 12:30-17:30 and 18:00-23:30
- Address: Refshalevej 96, 1432 Copenhagen, DK
- Trust: 92%, verified 2026-02-26
- ID: 07eb3c7b-3c04-76ad-d5e5-10fb6ac4b351
...
```

Also available: `/v1/r/{id}/agent.md` for a single business, or add `Accept: text/markdown` header. For structured JSON, drop `&format=text` (it's the default).

## Read endpoints (require free API key, 1,000/day free tier)

- `GET /v1/r/{id}` — full agent-native record (use `?format=short` for compact)
- `GET /v1/r/{id}/agent.json` — canonical compact shorthand (~320 bytes)
- `GET /v1/search?q=&category=&lat=&lng=&radius_km=` — text + geo search
- `GET /v1/business/{id}/freshness` — trust + freshness score for a listing
- `GET /v1/schema/short` — self-describing schema for the shorthand format
- `GET /v1/health` — service status + live counts
- `GET /v1/capabilities` — machine-readable description of the entire API
- `GET /v1/leaderboard/contributors` — top agent contributors
- `GET /v1/agents/seen` — recently active agents

## Live search & recipe engine (require free API key)

One HTTP call, structured results in 1-3 seconds. Results cached 30 min (repeat queries are instant).

- `GET /v1/execute/local/search?query=coffee+shops&location=Copenhagen` — LIVE local business search: name, rating, reviews, phone, today's hours, website, address, geo. Freshest data on the web. Use when you need current info or `search_businesses` doesn't have it yet.
- `GET /v1/execute/flights/search?from=CPH&to=FCO&depart=2026-04-25` — flights across multiple sources, cheapest first, with booking links
- `GET /v1/execute/hotels/search?destination=Rome&checkin=...&checkout=...` — hotels across multiple sources, cheapest first
- `GET /v1/execute/booking.com/search_cars?location=FCO&pickup_date=...&dropoff_date=...` — car rentals
- `GET /v1/execute/booking.com/search_attractions?destination=Rome&date=...` — tours & activities
- `GET /v1/execute/flixbus/search?from=Copenhagen&to=Berlin&date=...` — bus/train routes
- `GET /v1/execute/currency/convert?amount=100&from=USD&to=EUR` — live exchange rates
- `GET /v1/execute/weather/forecast?city=Rome&days=5` — weather forecast
- `GET /v1/recipes` — list all available recipes

## Write endpoints (unlimited on free tier)

- `POST /v1/contribute` — add a new business OR enrich an existing one (auto-dedupes)
- `POST /v1/report` — flag closed / wrong / spam (3+ closed → trust drops)
- `POST /v1/claim/edit` — edit a profile you've claimed
- `POST /v1/claim/upgrade` — strong verification (email-at-domain)

## Public HTML + sitemap (no auth)

- `GET /sitemap.xml` — every category, country, and claimed business
- `GET /r/{id}` — human-readable HTML profile (with embedded JSON-LD for crawlers)
- `GET /directory` — browse the directory by category and country
- `GET /directory/category/{slug}` — per-category landing page
- `GET /directory/country/{cc}` — per-country landing page

## Auth header

All API endpoints: `X-API-Key: aw_live_...` (or `Authorization: Bearer aw_live_...`, or `?api_key=`)

Free tier: 1,000 reads/day + 120 req/min burst, unlimited writes. Get your key at https://agentweb.live/#signup.

## Owner-claimable substrate

Any business owner can claim their listing in 30 seconds with no website:

- `POST /v1/claim/submit` — claim an existing business
- `POST /v1/claim/new` — add a brand-new business AND claim it (geocoded)
- `GET /v1/claim/verify?token=...` — email verification link
- `POST /v1/claim/dispute` — public dispute flow

Verified owners get a `✓ OWNER VERIFIED` badge and edit their profile live.

## MCP server

```
npx -y agentweb-mcp
```

23 tools exposed, including: `search_businesses`, `local_search` (live), `get_business`, `contribute_business`, `report_business`, `search_flights`, `search_hotels`, `search_cars`, `search_attractions`, `flixbus_search`, `currency_convert`, `weather_forecast`, plus agent memory (`agent_history`, `agent_favorites`, `agent_profile`)

Add to Claude Desktop / Cursor / Continue / Cline:
```json
{
  "mcpServers": {
    "agentweb": {
      "command": "npx",
      "args": ["-y", "agentweb-mcp"],
      "env": { "AGENTWEB_API_KEY": "your_key_here" }
    }
  }
}
```

## Manifesto

The web wasn't built for AI. We built one that is. Free. Open. No website required.

Read the full thesis: https://agentweb.live/manifesto

## Data sources

- **OpenStreetMap** (ODbL) — primary base layer, refreshed weekly per country
- **Schema.org JSON-LD** scraped from business websites — phone, hours, email
- **Owner submissions** via the claim flow — highest trust tier

Every field returned by the API includes provenance and last-verified timestamp.

## Links

- Signup (free API key): https://agentweb.live/#signup
- Manifesto: https://agentweb.live/manifesto
- Directory: https://agentweb.live/directory
- API docs: https://api.agentweb.live/docs
- OpenAPI: https://api.agentweb.live/openapi.json
- Capabilities: https://api.agentweb.live/v1/capabilities
- Schema (short format): https://api.agentweb.live/v1/schema/short
- MCP: https://www.npmjs.com/package/agentweb-mcp
- GitHub: https://github.com/zerabic/agentweb-mcp
- Sitemap: https://agentweb.live/sitemap.xml