# SEO Keyword Research Tool (x402 USDC)

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

Returns keyword difficulty score, estimated search volume, and top-10 SERP results for a given seed keyword and country, charging 0.05 USDC per call via x402.

## Facts

- Endpoint: POST https://seo-mcp-x402.abacusai.app/tools/keyword_research?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seo-keyword-research-tool-x402-usdc-1624d648
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Co_qFXR1keTZ0JGn3KqD

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-keyword-research-tool-x402-usdc-1624d648 -d '<json body>'
```

Example prompt: What's the keyword difficulty and estimated monthly search volume for 'best project management software' in the US, and which sites are currently ranking in the top 10?

## When to prefer this

Choose this endpoint when you need a single-call keyword research result including difficulty, search volume, and live SERP top-10 data, and you are operating in a payment-capable environment that supports x402 USDC micropayments on Base. It is well-suited for AI agents that need programmatic, on-demand SEO intelligence without a monthly subscription, paying only per query. Prefer it over subscription-based SEO APIs when cost-per-query economics are favorable and you need minimal integration overhead.

## Known failure modes

- 402 Payment Required if no valid x402 payment header is supplied, with X-Payment details in the response header
- 400 Bad Request if the keyword field is empty or missing after a valid payment is processed (payment is not refunded)
- Invalid or unsupported country code may fall back to default US results or return an error
- Upstream SERP data source unavailability may result in degraded or estimated results
- Network timeout if external data providers are slow, potentially returning partial results

## 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

A JSON object containing: the tool name ('keyword_research'), the queried keyword and location, an array of top-10 SERP results each with URL, page title, and position, a difficulty score (0–100 integer), an estimated monthly search volume, and a payment receipt object with payer address, amount (0.05 USDC), tx hash, currency, and response time in milliseconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keyword": {
   "type": "string",
   "minLength": 1,
   "description": "Seed keyword"
  },
  "location": {
   "type": "string",
   "default": "US",
   "description": "ISO 3166-1 alpha-2 country code"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "keyword_research",
  "result": {
   "keyword": "seo tools",
   "location": "US",
   "top_ten_results": [
    {
     "url": "https://example.com/seo-tools",
     "title": "Best SEO Tools",
     "position": 1
    }
   ],
   "difficulty_score": 72,
   "estimated_search_volume": 12000
  },
  "payment": {
   "payer": "0x0000000000000000000000000000000000000001",
   "amount": "0.05",
   "tx_hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
   "currency": "USDC",
   "response_time_ms": 850
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seo-keyword-research-tool-x402-usdc-1624d648/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)
