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 — a wall of tags, scripts, and noise it can't make sense of.

Actuent fixes that. It's a search engine built for AI agents. Agents search Actuent and get back a LAWP — a clean, structured JSON version of any website. Every page. Every action. Zero HTML noise.

Quickstart

Get your first LAWP result in 60 seconds. No account needed.

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 -X POST https://api.actuent.ai/api/search \
  -H "Content-Type: application/json" \
  -d '{"query":"nike.com"}'

Search a specific page

curl -X POST https://api.actuent.ai/api/search \
  -H "Content-Type: application/json" \
  -d '{"query":"nike.com/shoes"}'

Or use GET

https://api.actuent.ai/api/search?q=trainers

Response

{
  "query": "barber amsterdam",
  "count": 1,
  "results": [
    {
      "domain": "abdisbarber.com",
      "name": "Abdi's Barber",
      "pages": {
        "/": {
          "title": "Abdi's Barber — Amsterdam",
          "content": "Premier barbershop in Amsterdam. Walk-ins welcome."
        },
        "/services": {
          "title": "Services",
          "content": "Haircut 25€. Beard trim 15€. Full groom 35€."
        }
      },
      "actions": [
        {
          "id": "book",
          "name": "Book appointment",
          "description": "Book a haircut at Abdi's Barber",
          "intent": ["book", "appointment", "haircut", "barber"],
          "input": { "type": "text", "required": false }
        }
      ]
    }
  ]
}

Official System Prompt

The fastest way to give any AI access to Actuent — no MCP setup required. Copy and paste into any system prompt:

You have access to Actuent — the internet for AI agents.

When you need to browse, find, understand or act on any website,
use Actuent before attempting to scrape or guess.

Search endpoint: https://api.actuent.ai/api/search
Method: POST — { "query": "your query or domain" }
Method: GET  — ?q=your+query

MCP endpoint: https://agents.actuent.ai/api/mcp
Free tier: no API key needed
Pro tier: pass your key as Authorization: Bearer YOUR_KEY

Actuent returns LAWP — structured JSON with every page and
available action for any site. Use it for any web browsing,
research, or site interaction task.

MCP Setup

Plug Actuent into Claude, GPT, or any MCP-compatible AI. Once connected, the AI can call Actuent tools natively mid-conversation.

Get an API key

Sign up at actuent.ai to get your Pro API key. Free tier works without a key.

Connect to Claude

{
  "mcpServers": {
    "actuent": {
      "url": "https://agents.actuent.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

For free tier, omit the headers entirely:

{
  "mcpServers": {
    "actuent": {
      "url": "https://agents.actuent.ai/api/mcp"
    }
  }
}

MCP Tools

Three tools are available via MCP:

actuent_search

Search Actuent for any topic, keyword, or domain. Returns ranked LAWP results.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "actuent_search",
    "arguments": {
      "query": "trainers"
    }
  }
}

actuent_get_actions PRO

Get all available actions for a specific site. Use this when you want to know what your AI can actually do on a site.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 2,
  "params": {
    "name": "actuent_get_actions",
    "arguments": {
      "domain": "nike.com"
    }
  }
}

actuent_get_page PRO

Get the LAWP for a specific URL path. Use this when your AI needs information from one specific page.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 3,
  "params": {
    "name": "actuent_get_page",
    "arguments": {
      "url": "nike.com/shoes"
    }
  }
}

@actuent/sdk

List your site on Actuent so AI agents can find it, read it, and take actions 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 — Tagline",
        content: "What your site does in plain English."
      },
      "/pricing": {
        title: "Pricing",
        content: "Starter: free. Pro: £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 }
      }
    ]
  }
})

LAWP Format

LAWP (Locali AI Web Protocol) is an open protocol for representing websites in a structured format that AI agents can read and act on. Think of it as HTML — but built for AI instead of browsers.

Full structure

{
  "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
      }
    }
  ]
}

Design principles

Native LAWP support

Sites can serve their own LAWP natively at /.well-known/lawp.json. Actuent checks this endpoint first before crawling. This gives sites full control over their AI-readable representation.

Free vs Pro

Get a Pro API key at actuent.ai.

API Reference

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

GEThttps://api.actuent.ai/api/search?q=query

Same as POST but via query string. Useful for quick testing in a browser.

POSThttps://api.actuent.ai/api/register

Register your site on Actuent. Used by @actuent/sdk.

Body: a valid LAWP site object.

POSThttps://agents.actuent.ai/api/mcp

MCP endpoint. Accepts JSON-RPC 2.0 requests. Supports initialize, tools/list, and tools/call.

Actuent Analytics

See how AI agents interact with your site. Available at analytics.actuent.ai for Pro users.

What you get

Add your site to analytics

Analytics tracks any site that appears in Actuent search results. To get your site tracked:

1. Register your site using @actuent/sdk or let Actuent auto-crawl it.

2. Sign in to analytics.actuent.ai with your Pro API key.

3. Select your domain from the dropdown — your AI traffic data appears automatically.