mcpField
N
nansen-web-searcher

nansen-web-searcher

github.com/nansen-aiProductivity144654 installsUpdated today
Repository

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

  1. 01Search multiple queries in parallel
  2. 02Set results per query
  3. 03Return titles, links, snippets, and dates
  4. 04Optionally include a knowledge graph
  5. 05Fetch content from specified URLs

Use cases

  1. 01Search for crypto-asset price information
  2. 02Research news across multiple ecosystems
  3. 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-searcher

After installing, type/nansen-web-searcherin Claude Code to confirm it loaded.

Details

From the project README

Authentication

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.

FlagValuesDefaultPurpose
--querystring—Query string (repeatable for multiple queries)
--num-results1–2010Results per query
--prettyflagoffHuman-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.

Comments

Markdown supported