Novada Search

Search, extract, crawl, map, and research the web — from any AI agent or terminal.

Powered by novada.com — 100M+ proxy IPs across 195 countries.

Language / 语言： English · 中文

English

Jump to: API Keys · Quick Start · When to Use · Tools · Prompts · Resources · Examples · Use Cases · Comparison

Quick Install

Claude Code:

claude mcp add novada -e NOVADA_API_KEY=your_key -- npx -y novada-search

Get your key at dashboard.novada.com.

API Keys & Environment Variables

Different capabilities require different credentials. Here is what you need and where to get each one.

Which tools work with just NOVADA_API_KEY:

• novada_search, novada_extract (static mode), novada_crawl, novada_map, novada_research, novada_proxy, novada_verify

Which tools need additional keys:

• render="render" → needs NOVADA_WEB_UNBLOCKER_KEY
• render="browser" → needs NOVADA_BROWSER_WS
• novada_unblock → needs NOVADA_WEB_UNBLOCKER_KEY or NOVADA_BROWSER_WS
• novada_browser → needs NOVADA_BROWSER_WS
• novada_scrape → needs Scraper API product activation (contact support)

Minimum setup (get started immediately):

export NOVADA_API_KEY=your-key    # Free at novada.com

Full setup (all features enabled):

export NOVADA_API_KEY=your-key
export NOVADA_WEB_UNBLOCKER_KEY=your-unblocker-key   # For JS-heavy sites
export NOVADA_BROWSER_WS=wss://user:pass@upg-scbr2.novada.com  # For browser automation

For AI agents: Set these environment variables in your MCP client config (see Quick Start). The agent will automatically use the best available method — if NOVADA_WEB_UNBLOCKER_KEY is set, it uses JS rendering when needed; if NOVADA_BROWSER_WS is set, it falls back to full browser for fingerprint-protected sites.

nova — CLI

npm install -g novada-search
export NOVADA_API_KEY=your-key    # Free at novada.com

nova search "best desserts in Düsseldorf" --country de
nova search "AI funding news" --time week --include "techcrunch.com,wired.com"
nova extract https://example.com
nova extract https://example.com --render render      # JS-heavy sites
nova crawl https://docs.example.com --max-pages 10 --select "/api/.*"
nova map https://docs.example.com --search "webhook" --max-depth 3
nova research "How do AI agents use web scraping?" --depth deep --focus "production use cases"
nova proxy --type residential --country us --format env
nova scrape --platform amazon.com --operation amazon_product_by-keywords --keyword "iphone 16" --num 5 --format csv
nova verify "The Eiffel Tower is 330 meters tall" --context "as of 2024"

Real Output Examples

nova search "best desserts in Düsseldorf" --country de

## Search Results
results:3 | engine:google | country:de

---

### 1. THE BEST Dessert in Düsseldorf
url: https://www.tripadvisor.com/Restaurants-g187373-zfg9909-Dusseldorf...
snippet: Heinemann Konditorei Confiserie (4.4★), Eis-Café Pia (4.5★), Cafe Huftgold (4.3★)

### 2. Top 10 Best Desserts Near Dusseldorf
url: https://www.yelp.com/search?cflt=desserts&find_loc=Dusseldorf...
snippet: Namu Café, Pure Pastry, Tenten Coffee, Eiscafé Pia...

### 3. Good Dessert Spots : r/duesseldorf
url: https://www.reddit.com/r/duesseldorf/comments/1mxh4bj/...
snippet: "I'm moving to Düsseldorf soon and I love trying out desserts!"

---
## Agent Hints
- To read any result in full: `novada_extract` with its url
- To batch-read multiple results: `novada_extract` with `url=[url1, url2, ...]`
- For deeper multi-source research: `novada_research`

nova research "How do AI agents use web scraping?" --depth deep

## Research Report
question: "How do AI agents use web scraping?"
depth:deep (auto-selected) | searches:6 | results:28 | unique_sources:15

---

## Search Queries Used
1. How do AI agents use web scraping?
2. ai agents web scraping overview explained
3. ai agents web scraping vs alternatives comparison
4. ai agents web scraping best practices real world
5. ai agents web scraping challenges limitations
6. "ai" "agents" site:reddit.com OR site:news.ycombinator.com

## Key Findings
1. **How AI Agents Are Changing the Future of Web Scraping**
   https://medium.com/@davidfagb/...
   These agents can think, understand, and adjust to changes in web structure...

## Sources
1. [How AI Agents Are Changing Web Scraping](https://medium.com/...)

---
## Agent Hints
- 15 sources found. Extract the most relevant with: `novada_extract` with url=[url1, url2]
- For more coverage: use depth='comprehensive' (8-10 searches).

Map → Batch Extract Workflow

# Step 1: Discover pages
nova map https://docs.example.com --search "webhook" --max-depth 3

# Step 2: Batch-extract multiple pages in one call
nova extract https://docs.example.com/webhooks/events https://docs.example.com/webhooks/retry

Quick Start

Claude Code (1 command)

claude mcp add novada -e NOVADA_API_KEY=your-key -- npx -y novada-search

--scope user for all projects:

claude mcp add --scope user novada -e NOVADA_API_KEY=your-key -- npx -y novada-search

With JS rendering + browser automation:

claude mcp add --scope user novada \
  -e NOVADA_API_KEY=your-key \
  -e NOVADA_WEB_UNBLOCKER_KEY=your-unblocker-key \
  -e NOVADA_BROWSER_WS=wss://user:pass@upg-scbr2.novada.com \
  -- npx -y novada-search

Smithery (1 click)

Install via Smithery — supports Claude Desktop, Cursor, VS Code, and more.

npx -y @smithery/cli install novada-search --client claude

{
  "mcpServers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "your-key",
        "NOVADA_WEB_UNBLOCKER_KEY": "your-unblocker-key"
      }
    }
  }
}

{
  "servers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "your-key",
        "NOVADA_WEB_UNBLOCKER_KEY": "your-unblocker-key"
      }
    }
  }
}

{
  "mcpServers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "your-key"
      }
    }
  }
}

{
  "mcpServers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "your-key"
      }
    }
  }
}

import subprocess, os

result = subprocess.run(
    ["nova", "search", "AI agent frameworks"],
    capture_output=True, text=True,
    env={**os.environ, "NOVADA_API_KEY": "your-key"}
)
print(result.stdout)

When to Use Which Tool

Common workflows:

# Research workflow
novada_search → novada_extract (batch top results) → synthesize

# Docs deep-dive
novada_map → novada_crawl (select_paths=["/api/.*"]) → synthesize

# Platform data
novada_scrape (amazon.com, amazon_product_by-keywords) → analyze

# Anti-bot site
novada_unblock → novada_browser (click, scroll, screenshot)

Don't:

• Use novada_crawl for a single page — use novada_extract
• Use novada_research when you already have the URLs — use novada_extract
• Use novada_map to read content — it only returns URLs, use novada_extract next

Tools

novada_search

Search the web via Google, Bing, or 3 other engines. Returns structured results with titles, URLs, and snippets.

Inline extraction: Pass extract_options: { top_n: 3, format: "markdown" } to automatically extract content from the top N search results in a single call.

novada_extract

Extract the main content from any URL. Supports batch extraction (up to 10 URLs in parallel). Auto-escalates from static → JS render → Browser API on JS-heavy sites. Uses a 70-domain registry to skip probe latency for known sites.

fields example output:

## Requested Fields
price: $299.99 *(from schema)*
author: John Smith *(pattern)*
rating: 4.5/5 *(from schema)*
availability: In Stock *(pattern)*

novada_crawl

Crawl a website and extract content from multiple pages concurrently.

novada_map

Discover all URLs on a website. Fast — collects links without extracting content.

novada_research

Multi-step web research. Runs 3-10 parallel searches, deduplicates, returns a cited report.

novada_proxy

Generate ready-to-use proxy credentials (residential, mobile, ISP, datacenter).

Requires: NOVADA_PROXY_USER, NOVADA_PROXY_PASS, and NOVADA_PROXY_ENDPOINT environment variables. Get these from dashboard.novada.com → Residential Proxies → Endpoint Generator.

novada_scrape

Structured data from 129 platforms (Amazon, Reddit, TikTok, LinkedIn, Google Shopping…). Returns clean records — no HTML parsing needed.

Note: Requires Scraper API product activation. Contact novada.com support if you see error 11006.

Example operations:

# Amazon product search
nova scrape --platform amazon.com --operation amazon_product_by-keywords --keyword "iphone 16" --num 5

# Reddit posts
nova scrape --platform reddit.com --operation reddit_posts_by-keywords --keyword "AI agents" --num 10

# Google Shopping
nova scrape --platform google.com --operation google_shopping_by-keywords --keyword "mechanical keyboard"

Full platform/operation list: developer.novada.com

novada_verify

Verify a factual claim against live web sources. Runs 3 parallel searches (supporting, skeptical, and neutral fact-check angles) and returns a structured verdict.

Verdict values: supported · unsupported · contested · insufficient_data

Confidence: 0–100 — how far from a 50/50 split. 100 = all evidence agrees, 0 = completely uncertain.

Note: Verdict is signal-based (search result balance), not a definitive fact ruling. For contested claims, use novada_extract on the returned source URLs for full context.

novada_unblock

Force JS render or unblock a specific URL using Web Unblocker or Browser API CDP. Use when novada_extract with render="render" is too slow and you want a direct unblock call.

Requires: NOVADA_WEB_UNBLOCKER_KEY or NOVADA_BROWSER_WS

novada_browser

Cloud browser automation via CDP (Playwright). Execute up to 20 chained actions per session. Useful for sites requiring login flows, form fills, or screenshot capture.

Requires: NOVADA_BROWSER_WS

Supported actions: navigate · click · type · screenshot · aria_snapshot · evaluate · wait · scroll · hover · press_key · select

Example:

{
  "actions": [
    { "type": "navigate", "url": "https://example.com/login" },
    { "type": "type", "selector": "#email", "text": "user@example.com" },
    { "type": "type", "selector": "#password", "text": "pass" },
    { "type": "click", "selector": "button[type=submit]" },
    { "type": "aria_snapshot" }
  ]
}

Prompts

MCP prompts are pre-built workflow templates visible in supported clients (Claude Desktop, LobeChat, etc.).

Resources

Read-only data agents can access before deciding which tool to call.

Use Cases

Why Novada?

Prerequisites

• API key — Sign up free at novada.com
• Node.js v18+

中文文档

跳转至： API 密钥 · 快速开始 · 工具 · Prompts · Resources · 示例 · 用例 · 对比

简介

Novada MCP Server 让 AI 代理实时访问互联网 — 搜索、提取、爬取、映射和研究网络内容。所有请求通过 Novada 的代理基础设施（1亿+ IP，195 个国家，反机器人绕过）路由。

API 密钥与环境变量

不同功能需要不同的密钥。以下是每项功能所需的配置及获取方式。

只需 NOVADA_API_KEY 就能使用的工具：

• novada_search、novada_extract（静态模式）、novada_crawl、novada_map、novada_research、novada_proxy、novada_verify

需要额外密钥的功能：

• render="render" → 需要 NOVADA_WEB_UNBLOCKER_KEY
• render="browser" → 需要 NOVADA_BROWSER_WS
• novada_unblock → 需要 NOVADA_WEB_UNBLOCKER_KEY 或 NOVADA_BROWSER_WS
• novada_browser → 需要 NOVADA_BROWSER_WS
• novada_scrape → 需要 Scraper API 产品激活（联系客服）

最小配置（立即开始）：

export NOVADA_API_KEY=你的密钥    # 在 novada.com 免费获取

完整配置（启用所有功能）：

export NOVADA_API_KEY=你的密钥
export NOVADA_WEB_UNBLOCKER_KEY=你的解锁密钥   # 用于 JS 密集型站点
export NOVADA_BROWSER_WS=wss://用户:密码@upg-scbr2.novada.com  # 用于浏览器自动化

给 AI 代理的提示： 在 MCP 客户端配置中设置这些环境变量（参见快速开始）。代理会自动选择最佳方式 — 设置了 NOVADA_WEB_UNBLOCKER_KEY 时会在需要时使用 JS 渲染；设置了 NOVADA_BROWSER_WS 时会对指纹保护站点回退到完整浏览器模式。

快速开始

npm install -g novada-search
export NOVADA_API_KEY=你的密钥    # 在 novada.com 免费获取

nova search "杜塞尔多夫最好的甜点" --country de
nova search "AI 融资新闻" --time week --include "techcrunch.com"
nova extract https://example.com
nova extract https://example.com --render render      # JS 密集型站点
nova crawl https://docs.example.com --max-pages 10 --select "/api/.*"
nova map https://docs.example.com --search "api" --max-depth 3
nova research "AI 代理如何使用网络抓取？" --depth deep --focus "生产用例"
nova proxy --type residential --country us --format env
nova scrape --platform amazon.com --operation amazon_product_by-keywords --keyword "iphone 16" --num 5
nova verify "The Eiffel Tower is 330 meters tall" --context "as of 2024"

连接到 Claude Code

# 最小配置
claude mcp add novada -e NOVADA_API_KEY=你的密钥 -- npx -y novada-search

# 所有项目生效
claude mcp add --scope user novada -e NOVADA_API_KEY=你的密钥 -- npx -y novada-search

# 完整配置（含 JS 渲染 + 浏览器自动化）
claude mcp add --scope user novada \
  -e NOVADA_API_KEY=你的密钥 \
  -e NOVADA_WEB_UNBLOCKER_KEY=你的解锁密钥 \
  -e NOVADA_BROWSER_WS=wss://用户:密码@upg-scbr2.novada.com \
  -- npx -y novada-search

通过 Smithery 一键安装

npx -y @smithery/cli install novada-search --client claude

{
  "mcpServers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "你的密钥",
        "NOVADA_WEB_UNBLOCKER_KEY": "你的解锁密钥"
      }
    }
  }
}

{
  "servers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "你的密钥"
      }
    }
  }
}

{
  "mcpServers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "你的密钥"
      }
    }
  }
}

{
  "mcpServers": {
    "novada": {
      "command": "npx",
      "args": ["-y", "novada-search@latest"],
      "env": {
        "NOVADA_API_KEY": "你的密钥"
      }
    }
  }
}

真实输出示例

nova search "杜塞尔多夫最好的甜点" --country de

## Search Results
results:3 | engine:google | country:de

---

### 1. THE BEST Dessert in Düsseldorf
url: https://www.tripadvisor.com/Restaurants-g187373-zfg9909-Dusseldorf...
snippet: Heinemann Konditorei Confiserie (4.4★), Eis-Café Pia (4.5★)

### 2. Top 10 Best Desserts Near Dusseldorf
url: https://www.yelp.com/search?cflt=desserts&find_loc=Dusseldorf...
snippet: Namu Café, Pure Pastry, Tenten Coffee...

---
## Agent Hints
- 完整阅读任一结果：使用 `novada_extract` 传入对应 url
- 批量读取多个结果：`novada_extract` 传入 `url=[url1, url2, ...]`
- 深度多源研究：使用 `novada_research`

nova research "AI 代理如何使用网络抓取？" --depth deep

## Research Report
question: "AI 代理如何使用网络抓取？"
depth:deep (auto-selected) | searches:6 | results:28 | unique_sources:15

---

## Search Queries Used
1. AI 代理如何使用网络抓取？
2. ai agents web scraping overview explained
3. ai agents web scraping best practices real world
...

## Key Findings
1. **How AI Agents Are Changing Web Scraping**
   https://medium.com/@davidfagb/...

---
## Agent Hints
- 找到 15 个来源。用 `novada_extract` 提取最相关的页面
- 更多覆盖：使用 depth='comprehensive'（8-10 次搜索）

工具

novada_search — 网络搜索

novada_extract — 内容提取

内置 70 域名注册表（amazon、twitter、linkedin 等），对已知 JS 站点跳过静态探测，直接使用最优渲染模式。

novada_crawl — 网站爬取

novada_map — URL 发现

novada_research — 深度研究

novada_proxy — 代理凭据

生成即用代理凭据（住宅、移动、ISP、数据中心），无需单独申请账号 — 从 NOVADA_API_KEY 直接派生。

novada_scrape — 平台结构化数据

从 129 平台（Amazon、Reddit、TikTok、LinkedIn、Google Shopping 等）抓取结构化数据，无需手动解析 HTML。

注意： 需要激活 Scraper API 产品。如果遇到错误 11006，请联系 novada.com 客服。

novada_verify — 事实核查

针对实时网络来源验证一个事实性声明。并行运行 3 次搜索（支持、质疑、中立核查角度），返回结构化裁定。

裁定值： supported（支持）· unsupported（不支持）· contested（存疑）· insufficient_data（数据不足）

novada_unblock — 强制解锁

需要： NOVADA_WEB_UNBLOCKER_KEY 或 NOVADA_BROWSER_WS

novada_browser — 浏览器自动化

需要： NOVADA_BROWSER_WS

云端浏览器自动化（CDP / Playwright）。每次会话最多 20 个链式操作，支持：navigate（导航）· click（点击）· type（输入）· screenshot（截图）· snapshot（快照）· evaluate（执行 JS）· wait（等待）· scroll（滚动）。

Prompts 预置工作流

MCP Prompts 是预置工作流模板，在支持的客户端（Claude Desktop、LobeChat 等）中可直接选用。

Resources 只读数据

Agent 在选择工具之前可以读取的参考数据。

用例

为什么选择 Novada？

前置要求

• API 密钥 — 在 novada.com 免费注册
• Node.js v18+

About

Novada — web data infrastructure for developers and AI agents. 100M+ proxy IPs, 195 countries.

License

MIT