About nansen-web-searcher
nansen-web-searcher is a web-search feature in the Nansen CLI. It runs one or more queries in parallel through the Serper API and returns results such as titles, links, snippets, and dates; a separate command can fetch content from specified URLs.
Key features
- 01Search multiple queries in parallel
- 02Set results per query
- 03Return titles, links, snippets, and dates
- 04Optionally include a knowledge graph
- 05Fetch content from specified URLs
Use cases
- 01Search for crypto-asset price information
- 02Research news across multiple ecosystems
- 03Retrieve page content from a specified URL
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ nansen-ai/ nansen-cli --skill nansen-web-searcherAfter installing, type/nansen-web-searcherin Claude Code to confirm it loaded.
Details
From the project READMEAuthentication
Nansen account API calls accept a selected nansen:api browser session or conventional API key with the same permissions. NANSEN_API_KEY takes precedence; optional primaryEnv preserves configured-key injection. Run nansen auth status for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.
Web Search
Search the web for one or more queries in parallel via the Serper API.
nansen web search "bitcoin price"
nansen web search "solana ecosystem news" --num-results 5
nansen web search --query "ethereum ETF" --query "bitcoin ETF" --num-results 3
Positional args and --query flags can be combined — all become queries.
| Flag | Values | Default | Purpose |
|---|---|---|---|
--query | string | — | Query string (repeatable for multiple queries) |
--num-results | 1–20 | 10 | Results per query |
--pretty | flag | off | Human-readable JSON |
Returns results[] — one entry per query, each with organic[] (title, link, snippet, date) and optional knowledge_graph.
Note: Some domains are excluded from results (paywalled/unfetchable sites like bloomberg.com, twitter.com). Use nansen web fetch to retrieve content from specific URLs.