vc_web_search
Search the public web and receive JSON output with titles, URLs, and snippets. Returns current information for any query.
Instructions
Run a public web search and return titles, URLs, and snippets as JSON.
Use when you need current public web results for a query. Do not use for private/intranet pages — call vc_page_markdown with a known URL instead. Sibling: vc_page_markdown (one URL), pay (generic slug caller).
Auth: free-trial or prepaid X-Vibes-Key preferred; else USDC via x402 (~$0.02). Side effects: outbound HTTP to a search provider; no local writes. Returns JSON results, or a payment_required challenge if unpaid.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "vc_web_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query string. | |
| max_results | No | Max results to return (typical 1–10). | |
| payment_signature | No | Optional x402 PAYMENT-SIGNATURE if not using X-Vibes-Key. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |