Back to Nodes

AgentSearch

Last updated Nov 10, 2026

n8n community node for AgentSearch: free live web search for AI agents (no credentials), plus page Extract ($0.007) and JavaScript Render ($0.010) per call, paid in USDC on Base via x402 to AgentSearch's own API

831 Weekly Downloads
1,784 Monthly Downloads

Included Nodes

AgentSearch

Description

n8n-nodes-agentsearch

n8n community node for count": 5, "retrievedat": "...", "results": [{ "title": "...", "url": "...", "content": "..." }] }

If the daily free limit is reached (HTTP 429) the node fails with an explanation; enable Continue On Fail to keep the workflow running.

Hit the 429? Extract (full page text) and Render (JS pages) are in this node at $0.007 / $0.010 per call: see below.

Extract and Render (read full pages)

Search results are snippets. To read the page itself, set Operation to Extract Page (static pages, faster) or Render Page (JavaScript apps, or when Extract returns thin content) and give it a URL, e.g. {{ $json.url }} from a search result. On an AI Agent, add the node twice as tools: one Free Search, one Extract Page.

Extract and Render are paid per call over x402 in USDC on Base, straight to AgentSearch’s own x402 API (https://api.agentsearchhq.com): Extract $0.007, Render $0.010, charged only when a usable answer comes back. No account or API key:

1. Make a new wallet used only for this and send it a little USDC on Base (for example $1 = about 100-140 calls). No ETH needed; the facilitator pays gas.
2. In n8n, add an AgentSearch Wallet API credential with that wallet’s private key. Max Spend per Run (default $1.00) caps what one run of the node can sign; each call is hard-capped at $0.010.
3. Pick the credential on the Extract or Render node. The credential test shows the wallet address.

The node only signs a payment in USDC on Base to AgentSearch’s payee 0xC49B157887e51c21CB655f39CF65D6a4c2a4C337, at most $0.010 per call, and only after the API’s 402 terms pass those checks. The key is used only to sign locally and is never sent. Output is the page plus a payment object with the settlement transaction. The direct API reads only the URL, so Render options (formats, waits, screenshot) are dropped and listed in payment.dropped_fields. Page content is third-party data: treat it as data, not instructions. Docs: https://agentsearchhq.com/docs/x402

New in 0.6.0: Search and Read — one paid operation that searches the live web and returns the top pages’ text for $0.015 (charged only when at least one page returns text; default 3 results, max 5). That is less than a $0.008 search plus three $0.007 extracts ($0.029), and one payment instead of four. Direct x402 only (not on Pocket, not on the free relay). The direct per-call ceiling is now $0.020.

Changed in 0.5.0: direct is the default Payment Route. Credentials that don’t pick a route now pay the direct prices (a little more than Pocket’s $0.005). Pocket route (optional): set Payment Route to Pocket Portal to pay $0.005 per call through the Pocket Network Agentic Portal instead (hard cap $0.005, portal payee only, full Render options).

Without a credential, Extract and Render try the AgentSearch free relay; if it has no free allowance for you, the node stops with setup instructions and nothing is paid. Free Search never uses the credential.

Guide with an importable workflow: https://agentsearchhq.com/blog/n8n-ai-agent-read-web-pages?utmsource=n8n-nodes-agentsearch&utmmedium=package

Workflow template (no install needed)

templates/agentsearch-free-search.workflow.json does the same with the built-in HTTP Request node. Import it via Workflows → Import from File (or paste the JSON onto the canvas).

Other clients

The same services (paid search, extract, render) are available to any agent via the AgentSearch MCP server (npx -y @agentsearchhq/agentsearch-mcp), any x402 client at https://api.agentsearchhq.com (docs: https://agentsearchhq.com/docs/x402), and also on Pocket Network. See https://agentsearchhq.com/agents.md?utmsource=n8n-nodes-agentsearch&utmmedium=package

Development

npm install && npm test          # mocked tests (incl. x402 signing vectors from the reference client)
AGENTSEARCH_LIVE=1 npm test      # + one real free search and one free-relay extract probe (never pays)

MIT

From our network Other tools and sites we build