# SEO Page Crawler (x402 USDC)

> SEO Page Crawler (x402 USDC) is a paid API for AI agents from seo-mcp-x402.abacusai.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-19).

Crawls a given web page URL and returns its title, headings, word count, internal links, and meta description for SEO analysis.

## Facts

- Endpoint: POST https://seo-mcp-x402.abacusai.app/tools/crawl_page?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seo-page-crawler-x402-usdc-21496a73
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zik2ys7IQboOK1Q6xMOOO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability seo-page-crawler-x402-usdc-21496a73 -d '<json body>'
```

Example prompt: Crawl https://www.example.com/blog/seo-tips for me and give me its title, headings, word count, internal links, and meta description so I can do an SEO audit.

## When to prefer this

Use this endpoint when you need fast, structured on-page SEO data (title, headings, word count, meta description, internal links) from a specific URL without running a full site crawl. Ideal for spot-checking individual pages, auditing landing pages, or comparing competitor pages. Costs only 0.01 USDC per call via x402 USDC payment on Base, making it suitable for lightweight per-page SEO analysis within an agent workflow.

## Known failure modes

- Invalid or unreachable URL returns an error response
- Payment not included or invalid returns HTTP 402 with X-Payment header specifying required 0.01 USDC payment details
- Malformed URL (missing scheme) may still be accepted as https:// is prepended automatically
- Page behind authentication or bot-blocking may return incomplete or empty content
- Timeout on slow pages may result in partial data

## How this service works

Paid SEO tools and the **Token Security & Verdict API** (`POST /verdict`, 0.02 USDC), exposed both as REST
endpoints and as an **MCP server** (`POST /mcp`, Streamable HTTP).

### Token Security & Verdict API
`POST /verdict` with `{"address": "0x...", "chain": "base" | "ethereum"}` returns a risk score (0-100), flags,
liquidity, holder concentration, honeypot indicators, top holders and a short summary. Data: GoPlus Security,
DexScreener and public JSON-RPC; if every source is down the result is an estimate marked `"source": "estimated"`.
Payments go to `0x4C5D82B27E857E4FCE5607b34041aD2d9c74eD1B`; its EIP-712 domain name is **"Token Verdict x402"** (all other domain fields are as below).
Every unpaid GET/HEAD/POST returns 402 with
`X-Payment: {"amount":"0.02","currency":"USDC","recipient":"0x4C5D82B27E857E4FCE5607b34041aD2d9c74eD1B","network":"base","mimeType":"application/json","resource":"token_verdict"}`.
Invalid input after a valid payment returns **400** and the payment proof is not consumed.

### Standard x402 payments (recommended - settled on-chain, indexed by x402scan)
Every 402 carries a base64 `PAYMENT-REQUIRED` header (x402 v2): scheme `exact`, network `eip155:8453`,
asset USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`. Retry with a `PAYMENT-SIGNATURE` header (v2 PaymentPayload, EIP-3009
`transferWithAuthorization`; v1 payloads in `X-PAYMENT` are also accepted). The server verifies via the PayAI facilitator,
runs the tool, then settles on-chain (facilitator pays gas) and returns the receipt in `PAYMENT-RESPONSE`.
Tool errors (e.g. 400 bad input) are **not** settled. Works out of the box with `@x402/fetch` + `@x402/evm`.

### Legacy payment flow (custom tx_hash proof)
1. Call a tool without payment -> **HTTP 402**. The `X-Payment` response header contains JSON:
   `{"amount","currency":"USDC","recipient","network":"base","mimeType","resource"}`.
2. Pay `amount` USDC on Base to `recipient`, then sign the EIP-712 typed data below with the payer wallet.
3. Retry with header `X-PAYMENT: {"tx_hash":"0x..","payer":"0x..","amount":"0.01","signature":"0x.."}`
   (raw JSON or base64 JSON) -> **HTTP 200** with results and an `X-Payment-Response` receipt header.

EIP-712 domain: `{name: "SEO MCP x402", version: "1", chainId: 8453, verifyingContract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913}`;
type `Payment(address payer, address recipient, uint256 amount, bytes32 txHash)` with `amount` in USDC atomic units (6 decimals).
Each `tx_hash` can be redeemed once. Rate limit: 10 calls / 60s per payer (HTTP 429).
If a tool fails (4xx/5xx tool_error) the payment is **not** consumed and can be retried.

## Output

Returns a JSON object with the crawled page's URL, title, list of headings (with tag and text), word count, internal links array, internal link count, and meta description. Also includes payment proof metadata (payer address, amount, tx hash, currency, and response time).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "minLength": 1,
   "description": "Absolute URL of the page (https:// is added if missing)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "crawl_page",
  "result": {
   "url": "https://example.com",
   "title": "Example Domain",
   "headings": [
    {
     "tag": "h1",
     "text": "Example Domain"
    }
   ],
   "word_count": 25,
   "internal_links": [],
   "meta_description": "",
   "internal_links_count": 0
  },
  "payment": {
   "payer": "0x0000000000000000000000000000000000000001",
   "amount": "0.01",
   "tx_hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
   "currency": "USDC",
   "response_time_ms": 850
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seo-page-crawler-x402-usdc-21496a73/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seo-mcp-x402.abacusai.app](https://www.zero.xyz/host/seo-mcp-x402.abacusai.app/llms.txt)
