Web Search: Ranked SERP Results JSON
web-searchWeb search: ranked title/url/snippet results (Serper upstream). Use when you need live search results for a query. Not for fetching a known URL (use url-extract). Returns a free sample plus the paid URL and pay steps (no charge here); the full result costs $0.02 Base USDC via x402.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "web-search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Input for the paid endpoint: search query; optional n=5..10 via JSON. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sku | Yes | ||
| note | No | ||
| payTo | No | ||
| price | No | ||
| method | No | ||
| network | No | ||
| paid_url | Yes | ||
| how_to_pay | Yes | ||
| teaser_url | No | ||
| your_input | No | ||
| free_teaser | No | Free sample output of this SKU (truncated); null if unavailable. | |
| ready_request | No | Exact paid HTTP request (method, url with your input, optional json_body) to send with an x402 client. |