# serp_intent (`net.2xcel.aus.serp-intent`)

> Agent Utility Service (AUS) Structured Search Intent API: Classifies search intent (informational, commercial, navigational, transactional), aggregates entity graphs, and normalizes SERP payloads.

## Metadata & Execution
- **Namespace**: `net.2xcel.aus.serp-intent`
- **Canonical HTML Page**: https://aipages.tech/tool/net.2xcel.aus.serp-intent
- **JSON Specification**: https://aipages.tech/api/tools/net.2xcel.aus.serp-intent
- **Execution Endpoint**: `POST https://aipages.tech/tool/serp-intent`
- **Connection Protocol**: `http`
- **Pricing**: $0.002 USDC per call (Base Mainnet Chain ID 8453)
- **Health Status**: `unknown`
- **Capabilities**: search-engine, intent-extraction, json-payload, entity-aggregation
- **Authentication**: x402 payment protocol (Header: x-payment-receipt; Token: USDC on Base Mainnet; Recipient: 0xE57cB8C73c4000EA04ba0eb607228CbAec7f8e9C)

## Input Parameters (JSON Schema Draft-07)
```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query or natural-language topic to evaluate"
    },
    "locale": {
      "type": "string",
      "default": "en-US",
      "description": "Target geographic and language locale"
    },
    "depth": {
      "type": "string",
      "enum": [
        "brief",
        "standard",
        "deep"
      ],
      "default": "standard",
      "description": "Intent extraction analysis depth"
    }
  },
  "required": [
    "query"
  ]
}
```

## Invocation Examples

### 1. Zero-Friction Sandbox Test (No Payment Required)
```bash
curl -X POST "https://aipages.tech/tool/net.2xcel.aus.serp-intent" \
  -H "Content-Type: application/json" \
  -H "x-playground-test: true" \
  -H "x-agent-id: markdown-agent" \
  -d '{}'
```

### 2. Production Invocation (x402 Base Mainnet Settlement)
```bash
curl -X POST "https://aipages.tech/tool/serp-intent" \
  -H "Content-Type: application/json" \
  -H "x-payment-receipt: <BASE_USDC_PAYMENT_RECEIPT>" \
  -d '{}'
```
