Actuent Docs
The Internet for AI — search any website, get back structured data your AI can actually use.
What is Actuent?
The web was built for humans. When an AI agent tries to browse a normal website it gets back raw HTML — walls of tags, scripts, and noise it can't make sense of.
Actuent fixes that. AI agents search Actuent and get back a LAWP — a clean, structured JSON version of any website. Every page. Every action. Zero HTML noise.
🤖 AI agents connect via agents.actuent.ai — Developers can inspect results at humans.actuent.ai
Quickstart
No account needed. Works instantly.
Search any site
curl -X POST https://api.actuent.ai/api/search \
-H "Content-Type: application/json" \
-d '{"query":"barber amsterdam"}'
Search by domain
curl https://api.actuent.ai/api/search?q=nike.com
Search a specific page
curl https://api.actuent.ai/api/search?q=nike.com/shoes
Example response
{
"query": "barber amsterdam",
"count": 1,
"results": [
{
"domain": "abdisbarber.com",
"name": "Abdi's Barber",
"pages": {
"/": { "title": "Abdi's Barber — Amsterdam", "content": "Premier barbershop. Walk-ins welcome." },
"/services": { "title": "Services", "content": "Haircut 25€. Beard trim 15€." }
},
"actions": [
{
"id": "book",
"name": "Book appointment",
"description": "Book a haircut",
"intent": ["book", "appointment", "haircut", "barber"],
"input": { "type": "text", "required": false }
}
]
}
]
}
Official System Prompt
Fastest way to give any AI access to Actuent. Paste into any system prompt:
You have access to Actuent — the internet for AI agents.
When you need to browse, find, or act on any website, use Actuent.
Search: POST https://api.actuent.ai/api/search {"query": "your query"}
GET: https://api.actuent.ai/api/search?q=your+query
MCP: https://agents.actuent.ai/api/mcp
Free tier — no API key needed.
Pro tier — pass Authorization: Bearer YOUR_KEY for memory, priority, and all tools.
MCP Setup
Plug Actuent into Claude, GPT, or any MCP-compatible AI.
Free tier — no key needed
{
"mcpServers": {
"actuent": {
"url": "https://agents.actuent.ai/api/mcp"
}
}
}
Pro tier — with API key
{
"mcpServers": {
"actuent": {
"url": "https://agents.actuent.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Get a Pro API key at actuent.ai.
MCP Tools
| Tool | What it does | Tier |
|---|---|---|
| actuent_search | Search Actuent — returns ranked LAWP for any query or domain | FREE |
| actuent_get_actions | Get available actions for a specific site | PRO |
| actuent_get_page | Get LAWP for a specific URL path | PRO |
| actuent_execute_action | Execute an action on a site (book, search, contact) | PRO |
| actuent_compare | Compare two or more sites side by side | FREE |
| actuent_trending | Top 10 most searched sites and queries this week | FREE |
| actuent_news | Structured news from BBC, Guardian, NYT, TechCrunch, Wired | FREE |
| actuent_nearby | Find physical places near the user relevant to their query | FREE |
| actuent_history | Search history for this API key | PRO |
| actuent_summarise | Single paragraph summary of any domain | FREE |
@actuent/sdk
List your site on Actuent so AI agents can find and act on it.
Install
npm install @actuent/sdk
Register your site
import { register } from "@actuent/sdk"
await register({
apiKey: "your-actuent-api-key",
site: {
domain: "yoursite.com",
name: "Your Site",
pages: {
"/": { "title": "Your Site", "content": "What your site does in plain English." },
"/pricing": { "title": "Pricing", "content": "Free plan. Pro from £20/month." }
},
actions: [
{
id: "signup",
name: "Sign up",
description: "Create a new account",
intent: ["sign up", "register", "join", "create account"],
input: { type: "text", required: false }
}
]
}
})
Native LAWP support
Serve your own LAWP at /.well-known/lawp.json for maximum control. Actuent checks this first before crawling.
Webhooks
Get notified when your site's LAWP changes:
curl -X POST https://api.actuent.ai/api/webhook-register \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"yoursite.com","url":"https://yoursite.com/webhooks/actuent"}'
LAWP Format
LAWP (Locali AI Web Protocol) is an open protocol for representing websites as structured JSON that AI agents can read and act on.
{
"domain": "string",
"name": "string",
"pages": {
"/path": { "title": "string", "content": "string" }
},
"actions": [
{
"id": "string",
"name": "string",
"description": "string",
"intent": ["string"],
"input": { "type": "text | number | none", "required": true | false }
}
]
}
Full spec: github.com/localilabs/lawp
Free vs Pro
| Feature | Free | Pro |
|---|---|---|
| actuent_search | ✓ (fresh crawl each time) | ✓ (cached, instant) |
| Result limit | 3 results | Full results |
| Agent memory | — | ✓ |
| Priority results | — | ✓ |
| Pro MCP tools | — | ✓ |
| Analytics dashboard | — | ✓ |
| Rate limit | 20 req/min | 60 req/min |
| API key | Not required | Required |
API Reference
POSThttps://api.actuent.ai/api/search
| Field | Type | Description |
|---|---|---|
| query | string | Search query, domain, or full URL |
GEThttps://api.actuent.ai/api/search?q=query
Same as POST — useful for quick tests in a browser.
POSThttps://api.actuent.ai/api/register
Register your site. Used by @actuent/sdk. Requires Authorization: Bearer YOUR_KEY.
GEThttps://api.actuent.ai/api/stats
Live count of indexed sites and total searches.
GEThttps://api.actuent.ai/api/diff?domain=yoursite.com
Latest detected change to a site's LAWP.
GEThttps://api.actuent.ai/sitemap.xml
XML sitemap of all indexed sites.
GEThttps://api.actuent.ai/leaderboard
Top 100 most-searched sites this week.
POSThttps://agents.actuent.ai/api/mcp
MCP endpoint. Accepts JSON-RPC 2.0. Supports initialize, tools/list, tools/call.
Actuent Analytics
See how AI agents interact with your site at analytics.actuent.ai.
Sign in with your Pro API key to see AI traffic, top queries, LAWP rankings, and competitor data. Free users get a preview with blurred data.
Your site appears automatically once it's been searched on Actuent. No setup needed.
LAWP Checker
Check if a site has native LAWP support, or see how Actuent represents it.