Actuent
DOCS v0.3.0

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

ToolWhat it doesTier
actuent_searchSearch Actuent — returns ranked LAWP for any query or domainFREE
actuent_get_actionsGet available actions for a specific sitePRO
actuent_get_pageGet LAWP for a specific URL pathPRO
actuent_execute_actionExecute an action on a site (book, search, contact)PRO
actuent_compareCompare two or more sites side by sideFREE
actuent_trendingTop 10 most searched sites and queries this weekFREE
actuent_newsStructured news from BBC, Guardian, NYT, TechCrunch, WiredFREE
actuent_nearbyFind physical places near the user relevant to their queryFREE
actuent_historySearch history for this API keyPRO
actuent_summariseSingle paragraph summary of any domainFREE

@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

FeatureFreePro
actuent_search✓ (fresh crawl each time)✓ (cached, instant)
Result limit3 resultsFull results
Agent memory
Priority results
Pro MCP tools
Analytics dashboard
Rate limit20 req/min60 req/min
API keyNot requiredRequired

API Reference

POSThttps://api.actuent.ai/api/search

FieldTypeDescription
querystringSearch 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.