Novada MCP

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

跳转到： API密钥 · 快速开始 · 何时使用 · 工具 · 提示 · 资源 · 示例 · 用例 · 比较

______________________________________________________________________

快速安装

克劳德代码：

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

把钥匙拿到 dashboard.novada.com.

______________________________________________________________________

API键和环境变量

不同的功能需要不同的凭据。这是你需要的东西，以及在哪里可以买到每一个。

哪些工具仅适用于 NOVADA_API_KEY:

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

哪些工具需要额外的密钥：

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

最低设置（立即开始）：

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

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

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

对于AI代理： 在MCP客户端配置中设置这些环境变量（请参阅快速入门）。代理将自动使用最佳可用方法——如果 NOVADA_WEB_UNBLOCKER_KEY 设置后，需要时使用JS渲染；如果 NOVADA_BROWSER_WS 设置后，它将回退到指纹保护网站的完整浏览器。

______________________________________________________________________

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"

______________________________________________________________________

实际输出示例

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 → 批量提取工作流

# 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

______________________________________________________________________

快速开始

克劳德代码（1个命令）

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

--scope user 对于所有项目：

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

使用JS渲染+浏览器自动化：

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次）

通过安装 铁匠铺 --支持克劳德桌面、光标、VS代码等。

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

Cursor / VS Code / Windsurf / Claude Desktop

光标 — .cursor/mcp.json:

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

VS代码 — .vscode/mcp.json:

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

帆板运动 — ~/.codeium/windsurf/mcp_config.json:

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

克劳德桌面版 — ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Python (via CLI)

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)

______________________________________________________________________

何时使用哪种工具

常见工作流程：

# 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)

不要：

• 使用 novada_crawl 对于单个页面，请使用 novada_extract
• 使用 novada_research 当你已经有了网址时——使用 novada_extract
• 使用 novada_map 要读取内容，它只返回URL，请使用 novada_extract 下一个

______________________________________________________________________

工具

novada_search

通过谷歌、必应或其他3个引擎搜索网络。返回带有标题、URL和代码段的结构化结果。

内联提取： 通过 extract_options: { top_n: 3, format: "markdown" } 在一次通话中自动从前N个搜索结果中提取内容。

novada_extract

从任何URL提取主要内容。支持批量提取（最多并行提取10个URL）。从静态自动升级→ JS渲染→ JS-heavy网站上的浏览器API。使用70域注册表跳过已知站点的探测延迟。

fields 示例输出：

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

novada_crawl

抓取网站并同时从多个页面中提取内容。

novada_map

发现网站上的所有URL。快速--收集链接而不提取内容。

novada_research

多步骤网络研究。运行3-10个并行搜索，消除重复，返回引用报告。

novada_proxy

生成即用型代理凭据（住宅、移动、ISP、数据中心）。

要求： NOVADA_PROXY_USER, NOVADA_PROXY_PASS，以及 NOVADA_PROXY_ENDPOINT 环境变量。从以下地址获取这些 dashboard.novada.com → 住宅代理→ 端点生成器。

novada_scrape

来自129个平台（亚马逊、Reddit、TikTok、领英、谷歌购物……）的结构化数据。返回干净的记录——不需要HTML解析。

注： 需要激活Scraper API产品。联系 novada.com 如果您看到错误11006，请提供支持。

示例操作：

# 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"

完整平台/操作列表： developer.novada.com

novada_verify

根据实时网络资源验证事实声明。运行3个并行搜索（支持、怀疑和中立的事实检查角度），并返回结构化的判断。

判决值： supported · unsupported · contested · insufficient_data

信心： 0–100——距离50/50的差距有多远。100=所有证据都一致，0=完全不确定。

注： 裁决是基于信号的（搜索结果平衡），而不是明确的事实裁决。对于有争议的索赔，请使用 novada_extract 在返回的源URL上查看完整上下文。

novada_unblock

使用Web Unblocker或浏览器API CDP强制JS呈现或取消阻止特定URL。使用时 novada_extract 和 render="render" 太慢了，您需要直接取消阻止呼叫。

要求： NOVADA_WEB_UNBLOCKER_KEY 或 NOVADA_BROWSER_WS

novada_browser

通过CDP（Playwright）实现云浏览器自动化。每个会话最多执行20个链式操作。适用于需要登录流程、表单填写或屏幕截图的网站。

要求： NOVADA_BROWSER_WS

支持的操作： navigate · click · type · screenshot · aria_snapshot · evaluate · wait · scroll · hover · press_key · select

例子：

{
  "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" }
  ]
}

______________________________________________________________________

提示

MCP提示是在支持的客户端（Claude Desktop、LobeChat等）中可见的预构建工作流模板。

______________________________________________________________________

资源

在决定调用哪个工具之前，只读数据代理可以访问。

______________________________________________________________________

用例

______________________________________________________________________

为什么是诺瓦达？

______________________________________________________________________

先决条件

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

______________________________________________________________________

中文文档

跳转至： API 密钥 · 快速开始 · 工具 · 提示 · 资源 · 示例 · 用例 · 对比

______________________________________________________________________

简介

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

Cursor / VS Code / Windsurf / Claude Desktop

光标 — .cursor/mcp.json:

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

VS代码 — .vscode/mcp.json:

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

帆板运动 — ~/.codeium/windsurf/mcp_config.json:

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

克劳德桌面版 — ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "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+

______________________________________________________________________

关于

诺瓦达 --面向开发人员和人工智能代理的web数据基础设施。195个国家的1亿+代理IP。

许可证

麻省理工学院