proxy4agents-mcp

Novada Proxy

エージェントファーストの住宅用プロキシ MCP — あらゆるプロバイダーで利用できます。

あらゆる HTTP リクエストを、Android スマートフォン、Windows PC、Mac など 200 万台以上の実在する家庭用デバイス経由でルーティングします。ボット対策システムを回避し、国や都市を指定したジオターゲティングを行い、複数ステップのワークフローを通じてスティッキーセッションを維持できます。Novada を基盤としています。

選ばれる理由 · インストール · ツール · プロンプト · リソース · プロバイダー · エージェントファースト

Claude Code、Cursor、Windsurf、Cline、Continue、および MCP 対応のあらゆる AI エージェントで利用できます。

ヒント

無料プランをご利用いただけます — novada.com で登録できます。クレジットカードは不要です。Scraper API、Web Unblocker、住宅用プロキシを無料で利用して、すぐに開発を始められます。

はじめに

1. novada.com で無料アカウントを作成します。クレジットカードは不要です
2. Dashboard → Residential Proxies → Endpoint Generator で認証情報を取得します。ユーザー名とパスワードをコピーしてください
3. インストールして実行します：

# Claude Code
claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -- npx -y novada-proxy-mcp

# Or use the CLI directly
npx novada-proxy-mcp status
npx novada-proxy fetch https://example.com

エージェント向け

メモ

エージェント： 人間に、上記の手順 1～2 を完了するよう伝えてください。認証情報を環境変数に設定すると、10 個すべてのツールをすぐに利用できます。API キーのローテーションもトークンの更新も不要です。プロキシの認証情報は永続的です。

Required env vars:
  NOVADA_PROXY_USER   — from novada.com dashboard
  NOVADA_PROXY_PASS   — from novada.com dashboard

Optional (for extra features):
  NOVADA_API_KEY      — enables novada_proxy_search (Google search)
  NOVADA_BROWSER_WS   — enables novada_proxy_render (JS rendering)
  NOVADA_PROXY_ZONE   — "res" (default), "isp", or "dcp"

サポートが必要ですか？ [email protected] までお問い合わせください

Novada Proxy を選ぶ理由

AI エージェントは、商用ウェブサイトの 60～70％でブロックされます。標準的な HTTP リクエストは、Cloudflare、Akamai、DataDome、PerimeterX に検出され、拒否されます。Novada Proxy は、実際の家庭用 IP アドレスを経由してエージェントの通信をルーティングするため、人間のブラウザーと見分けがつきません。

10 個のツール一覧

ツール選択のクイックガイド

ツールの使い分け

Goal: "Scrape a single URL"
  └─ Static HTML page?          → novada_proxy_fetch
  └─ Need specific fields?      → novada_proxy_extract (fields or schema mode)
  └─ React/Vue SPA / blank page? → novada_proxy_render

Goal: "Scrape multiple URLs"
  └─ You have the URLs already  → novada_proxy_batch_fetch
  └─ You need links from one page → novada_proxy_map → novada_proxy_batch_fetch
  └─ You need to crawl a whole site → novada_proxy_crawl → novada_proxy_batch_fetch

Goal: "Research a topic"        → novada_proxy_research (search + fetch + findings in one call)

Goal: "Search the web"          → novada_proxy_search → novada_proxy_batch_fetch

Goal: "Login + multi-page flow" → novada_proxy_session (same session_id)

Goal: "Check if proxy works"    → novada_proxy_status

5 プロンプト

複数のツールを連携させる、事前構築済みのエージェントワークフローです。任意の MCP クライアントから呼び出して、よくあるパターンを 1 ステップで実行できます。

メモ

プロンプトは複数ツールのワークフローを自動的にオーケストレーションします。たとえば、research_topic は novada_proxy_search を実行し、続いて novada_proxy_batch_fetch を実行します。エージェントがパイプラインを判断する必要はありません。

5 リソース

プロキシ呼び出しを行わずに、エージェントがいつでも読み取れる、常にアクセス可能な参照データです。

クイックインストール

コア — レジデンシャルプロキシ経由で任意の URL を取得：

claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -- npx -y novada-proxy-mcp

検索のみ：

claude mcp add novada-proxy-mcp \
  -e NOVADA_API_KEY=your_key \
  -- npx -y novada-proxy-mcp

すべてのツール（プロキシ + 検索 + ブラウザーによるレンダリング）：

claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -e NOVADA_API_KEY=your_key \
  -e NOVADA_BROWSER_WS=your_browser_ws_url \
  -- npx -y novada-proxy-mcp

Cursor / Windsurf / Cline — MCP 設定に追加：

{
  "mcpServers": {
    "novada-proxy-mcp": {
      "command": "npx",
      "args": ["-y", "novada-proxy-mcp"],
      "env": {
        "NOVADA_PROXY_USER": "your_username",
        "NOVADA_PROXY_PASS": "your_password"
      }
    }
  }
}

認証情報の取得先：novada.com -> ダッシュボード -> レジデンシャルプロキシ -> エンドポイントジェネレーター

プロバイダー

Novada Proxy はあらゆる HTTP プロキシプロバイダーに対応しています。Novada は標準で組み込まれており、最も幅広く統合されています。

優先順位： Novada -> BrightData -> Smartproxy -> Oxylabs -> Generic。最初に設定されたプロバイダーが使用されます。

claude mcp add novada-proxy-mcp \
  -e BRIGHTDATA_USER="brd-customer-abc123-zone-residential" \
  -e BRIGHTDATA_PASS=your_password \
  -- npx -y novada-proxy-mcp

claude mcp add novada-proxy-mcp \
  -e SMARTPROXY_USER=your_username \
  -e SMARTPROXY_PASS=your_password \
  -- npx -y novada-proxy-mcp

claude mcp add novada-proxy-mcp \
  -e OXYLABS_USER=your_username \
  -e OXYLABS_PASS=your_password \
  -- npx -y novada-proxy-mcp

claude mcp add novada-proxy-mcp \
  -e PROXY_URL="http://username:[email protected]:12321" \
  -- npx -y novada-proxy-mcp

エージェントファースト設計

メモ

Novada Proxy は、自律型 AI エージェント専用に設計された唯一のプロキシ MCP です。すべてのレスポンス、エラー、説明は、機械による処理に最適化されています。

ツール

novada_proxy_fetch

レジデンシャルプロキシ経由で任意の URL を取得します。コンテンツ、ステータスコード、メタデータを含む構造化 JSON を返します。ネットワークエラー時は自動で再試行します。繰り返しの呼び出しはキャッシュされます（デフォルトの TTL は 300 秒です。meta.cache_hit: true はプロキシクレジットが使用されなかったことを示します）。

レスポンス：

{
  "ok": true,
  "tool": "novada_proxy_fetch",
  "data": { "url": "...", "status_code": 200, "content": "...", "size_bytes": 34000 },
  "meta": { "latency_ms": 1800, "cache_hit": false, "quota": { "credits_estimated": 1 } }
}

novada_proxy_batch_fetch

レジデンシャルプロキシ経由で 2～20 個の URL を並行して取得します。逐次取得より最大 5 倍高速です。URL ごとのエラーは個別に記録されるため、一部の URL の取得に失敗してもバッチ処理自体は成功します。すでに取得済みの URL にはレスポンスキャッシュを再利用します。

レスポンス：

{
  "ok": true,
  "tool": "novada_proxy_batch_fetch",
  "data": {
    "requested": 3,
    "succeeded": 3,
    "failed": 0,
    "results": [
      { "url": "https://...", "ok": true, "content": "...", "cache_hit": false, "latency_ms": 1200 },
      { "url": "https://...", "ok": true, "content": "...", "cache_hit": true,  "latency_ms": 0 },
      { "url": "https://...", "ok": false, "error": { "code": "TLS_ERROR", "message": "..." } }
    ]
  },
  "meta": { "latency_ms": 4100, "quota": { "credits_estimated": 3 } }
}

novada_proxy_extract

ヒューリスティックなパターンマッチング（メタタグ、Open Graph、JSON-LD、Schema.org）を使用して、任意の URL から構造化フィールドを抽出します。軽量で、LLM は不要です。render_fallback: true を設定すると、プロキシ取得に失敗した場合に実際の Chromium 経由で自動的に再試行します。

レスポンス：

{
  "ok": true,
  "tool": "novada_proxy_extract",
  "data": {
    "url": "https://books.toscrape.com/...",
    "fields": { "title": "A Light in the Attic", "price": "£51.77", "description": null },
    "extracted_via": "proxy_fetch"
  },
  "meta": { "latency_ms": 2100, "quota": { "credits_estimated": 1 } }
}

novada_proxy_map

URL をクロールし、すべての内部リンクを構造化 JSON 配列として返します。URL を推測することなくサイト全体をクロールするため、novada_proxy_batch_fetch の前に行うリンク発見のステップとして使用します。

レスポンス：

{
  "ok": true,
  "tool": "novada_proxy_map",
  "data": {
    "domain": "books.toscrape.com",
    "internal_url_count": 20,
    "internal_urls": ["https://books.toscrape.com/catalogue/...", "..."],
    "sitemap_hint": "https://books.toscrape.com/sitemap.xml (check manually)"
  },
  "meta": { "latency_ms": 3800, "quota": { "credits_estimated": 1 } }
}

novada_proxy_session

スティッキーセッションで取得します。同じsession_idを指定したすべての呼び出しで、同じ住宅用IPを使用します。ログインフロー、ページネーションを使ったスクレイピング、価格監視に不可欠です。verify_sticky: trueを指定すると、利用前にIPの一貫性を確認できます。

novada_proxy_search

Novada Scraper APIを介した、構造化されたGoogle検索です。タイトル、URL、スニペットを整ったJSON形式で返すため、HTMLの解析は不要です。

novada_proxy_render [BETA]

NovadaのBrowser API（実際のChromium、完全なJS実行）を使って、JavaScriptを多用するページをレンダリングします。SPA、React／Vueアプリ、通常のHTTP取得では空白で返されるページに使用します。

必要なもの： NOVADA_BROWSER_WS — Dashboard -> Browser API -> PlaygroundからPuppeteer URLをコピーしてください。

1回の呼び出しで約5プロキシクレジットを消費します（novada_proxy_fetchは1クレジット）。必要に応じて自動的に段階を引き上げるには、render_fallback: trueを指定してnovada_proxy_extractを使用してください。

novada_proxy_crawl

BFS走査でウェブサイトを再帰的にクロールします。URLを起点に、各深度レベルでリンクを検出し、メタデータ付きのURLツリー全体を返します。

使用する場面： サイト全体のスクレイピング、サイトマップの生成、コンテンツのインデックス作成など、1ページ以上が必要な場合に使用します。

代わりにnovada_proxy_mapを使用する場面： 必要なのが1ページのリンクのみ（深度1）である場合です。単一ページのリンク検出では、Mapのほうが高速で低コストです。

組み合わせ： novada_proxy_batch_fetchと組み合わせて、URLツリーから特定のページをスクレイピングします。

例：

{
  "url": "https://example.com",
  "depth": 2,
  "limit": 50,
  "include_content": false
}

レスポンス： data.pages[]（url、depth、status_code、total_links）、data.urls[]（novada_proxy_batch_fetchに渡すためのフラット配列）

novada_proxy_research

ワンショットのリサーチツールです。ウェブを検索し、上位の検索結果を取得して、ソースのプレビュー付きで構造化された調査結果を返します。エージェントは調査結果を分析して、より深く統合できます。

必要なもの： NOVADA_API_KEY（Google 検索用）とプロキシ認証情報（ソース取得用）

使用する場面： 複数のソースのコンテンツを1回の呼び出しで取得する必要がある、調査の質問、トピックの調査、競合分析、事実確認など。

検索結果の URL のみが必要で、ページ全体のコンテンツは不要な場合は、代わりに novada_proxy_search を使用してください。

組み合わせて使用： 個々のソースをさらに詳しく読むには、特定の urls[] に対して novada_proxy_fetch を使用します。

注： findings_summary はソースのプレビューを連結したものです。実際の統合分析には、エージェントが findings[] を分析する必要があります。

例：

{
  "query": "best residential proxy providers 2026",
  "depth": "standard"
}

レスポンス： data.findings[]（title、url、snippet、content_preview）、data.urls[]（後続処理用）、data.findings_summary

novada_proxy_extract — スキーマモード

fields（ヒューリスティック抽出）に加えて、novada_proxy_extract は schema パラメーターに対応しており、エージェントの LLM を使って任意のフィールドを追加の API コストなしで抽出できます。

スキーマモード（LLM 抽出）

任意のフィールドを抽出するには、fields の代わりに schema を渡します。このツールは、クリーニング済みのページコンテンツと抽出プロンプトを返し、エージェントが追加の API コストなしで抽出を実行します。

例：

{
  "url": "https://example.com/product",
  "schema": {
    "product_name": "The full product name",
    "price": "Current price with currency",
    "warranty": "Warranty terms and duration",
    "return_policy": "Return policy summary"
  }
}

レスポンス： data.mode = "llm_extract"、data.content（クリーニング済みの Markdown）、data.extraction_prompt（エージェントが従ってフィールドを抽出するための指示）

セキュリティ： スキーマのキーには英数字とアンダースコア（a-z、0-9、_）のみを使用できます。最大50文字です。値は最大200文字です。

novada_proxy_status

プロキシネットワークの接続状況とバージョンを確認します。プロキシへのライブ呼び出しを行い、接続が機能していることを検証します。認証情報は不要です。

エージェントのワークフロー

サイトのクロールパイプライン（マップ -> バッチ）

# Agent task: "Read all products on this catalogue"
1. novada_proxy_map(url="https://books.toscrape.com", limit=50)
   → returns 20–50 internal URLs in 4s, 1 credit

2. novada_proxy_batch_fetch(urls=[...20 URLs], concurrency=5)
   → fetches all 20 pages in parallel, ~4s wall time, 20 credits
   (vs ~60s sequential = 15x speedup)

調査パイプライン（検索 -> バッチ）

# Agent task: "Find and read top 5 pages about X"
1. novada_proxy_search(query="residential proxy MCP", num=5)
   → structured JSON: titles, URLs, snippets

2. novada_proxy_batch_fetch(urls=[...5 URLs], format="markdown")
   → full content of all 5 pages in parallel

スティッキーセッション — ログイン + 複数ページのスクレイピング

# Same IP across all calls
novada_proxy_session(session_id="job_001", url="https://example.com/login")
novada_proxy_session(session_id="job_001", url="https://example.com/dashboard")
novada_proxy_session(session_id="job_001", url="https://example.com/data/page/1")
novada_proxy_session(session_id="job_001", url="https://example.com/data/page/2")

価格モニタリング — 同一製品、3つの市場

novada_proxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="US")
novada_proxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="DE")
novada_proxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="JP")
# Second call per URL is a cache hit (0ms, 0 credits) if within 300s TTL

構造化データの抽出

# Agent task: "Get product details without parsing HTML"
novada_proxy_extract(
  url="https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
  fields=["title", "price", "description", "rating"],
  render_fallback=true  # auto-retry via Chromium if proxy gets blocked
)

レスポンスキャッシュ

すべての novada_proxy_fetch と novada_proxy_batch_fetch の呼び出しは、プロセス内でキャッシュされます。TTL の期間内に同じ URL を再取得しても、プロキシクレジットは消費されません。

レスポンスからキャッシュ状況を確認する方法：

"meta": {
  "cache_hit": true,          // served from cache — no proxy credit used
  "cache_age_seconds": 12,    // seconds since the entry was stored
  "latency_ms": 0             // ~0ms for cache hits
}

型付きエラーコード

すべてのエラーレスポンスには、型付きの error.code、recoverable フラグ、正しい次のステップを示す agent_instruction が含まれます。エージェントがエラーメッセージを解析する必要はありません。

エラーレスポンス形式：

{
  "ok": false,
  "error": {
    "code": "BOT_DETECTION_SUSPECTED",
    "message": "HTTP 403 — request blocked by target",
    "recoverable": true,
    "agent_instruction": "Try novada_proxy_render (real browser). Or retry with a different country/session_id."
  }
}

地域カバレッジ

195以上の国に対応しています。以下を含みます。

US GB DE FR JP CA AU BR IN KR SG NL IT ES MX RU PL SE NO DK FI CH AT BE PT CZ HU RO UA TR IL ZA NG EG AR CL CO PE VN TH ID MY PH TW HK NZ + ほか148か国

市区町村レベルのターゲティング： newyork · losangeles · chicago · london · paris · berlin · tokyo · seoul · sydney · toronto · singapore · dubai · mumbai · saopaulo

対応クライアント

ネットワーク

動作確認済み

Eコマース： Amazon、eBay、Walmart、Etsy、Shopify ストア
ビジネス向け： LinkedIn
ボット対策で保護されたサービス： Cloudflare、Akamai、DataDome
ニュースとコンテンツ： HackerNews、Reddit、BBC、CNN、NYTimes
テクノロジー： GitHub、Wikipedia、Stack Overflow、IMDB

実環境でのテスト結果

Novada の3種類のプロキシを使い、実環境を想定した33件のテストを実施しました（2026-04-28）。

成功率：94%（31/33件成功）。失敗はプロキシの種類による制限（ボット対策サイトでのデータセンタープロキシの使用）であり、コードのバグではありません。

プロキシの種類ガイド

既知の制限事項

フィードバックとサポート

• メール： [email protected]
• GitHub の Issues： github.com/NovadaLabs/Novada-proxy/issues
• ウェブサイト： novada.com

ライセンス

MIT © Novada — LICENSE を参照してください

Novada Proxy（中国語ドキュメント）

AI エージェント専用のレジデンシャルプロキシ MCP — あらゆるプロバイダーに対応。

200 万台以上の実際の家庭用デバイス（Android 携帯電話、Windows PC、Mac）を経由して HTTP リクエストをルーティングし、アンチボットシステムを回避します。国や都市を指定して正確に位置を特定でき、リクエスト間で同じ IP を維持できます。

ツール · プロンプト · リソース · インストール · エージェント優先 · プロバイダー

Claude Code、Cursor、Windsurf、Cline、Continue、およびすべての MCP 互換エージェントに対応しています。Novada が提供しています。

ヒント

無料プラン — novada.com で登録できます。クレジットカードは不要です。Scraper API、Web Unblocker、レジデンシャルプロキシを無料で利用できます。

10 個のツール

novada_proxy_fetch       → 通过住宅代理抓取任意 URL
novada_proxy_batch_fetch → 并发抓取 2-20 个 URL（最高 5 倍加速）
novada_proxy_extract     → 从页面提取结构化字段（标题、价格、评分…）
novada_proxy_map         → 爬取页面，返回所有内部链接 JSON 数组
novada_proxy_crawl       → 递归爬取站点（BFS，深度 1-5），自动发现 URL
novada_proxy_session     → 粘性会话 — 同一 session_id 始终同一 IP
novada_proxy_search      → Google 搜索，返回结构化 JSON（无需解析 HTML）
novada_proxy_render      → 真实 Chromium 渲染 JS 页面 [BETA]
novada_proxy_research    → 一键深度研究 — 搜索 + 抓取 + 综合分析
novada_proxy_status      → 检查代理网络健康状态

5 個のプロンプト

複数のツールを連鎖させて組み合わせる、事前構築済みのエージェントワークフローです。

5 個のリソース

プロキシの利用枠を消費せず、エージェントがいつでも読み取れる参照データです。

すばやく判断するためのガイド

ツール選択の判断ツリー

目标：抓取单个 URL
  ├─ 静态 HTML 页面？                    → novada_proxy_fetch
  ├─ 需要特定字段（价格/标题）？          → novada_proxy_extract（fields 或 schema 模式）
  └─ React/Vue SPA / 内容为空？          → novada_proxy_render

目标：批量抓取多个 URL
  ├─ 已有 URL 列表？                     → novada_proxy_batch_fetch
  ├─ 需要获取单页链接？                  → novada_proxy_map → novada_proxy_batch_fetch
  └─ 需要爬取整个站点？                  → novada_proxy_crawl → novada_proxy_batch_fetch

目标：研究某个主题                       → novada_proxy_research（一次调用搜索 + 抓取 + 分析）

目标：网页搜索                          → novada_proxy_search → novada_proxy_batch_fetch

目标：登录 + 多步骤流程                  → novada_proxy_session（相同 session_id）

目标：验证代理是否正常工作               → novada_proxy_status

3 つの主要なパイプラインパターン

サイト全体のクロールパイプライン（推奨）

novada_proxy_map(url, limit=50)
        │
        ▼
  返回 20-50 个内部链接（1 credit，4 秒）
        │
        ▼
novada_proxy_batch_fetch(urls, concurrency=5)
        │
        ▼
  并发抓取所有页面（N credits，~4 秒，比串行快 15x）

検索・調査パイプライン

novada_proxy_search(query, num=10)
        │
        ▼
  结构化 JSON：标题 + URL + 摘要
        │
        ▼
novada_proxy_batch_fetch(urls, format="markdown")
        │
        ▼
  全部页面内容并行返回

スティッキーセッション — ログイン + 複数ページの取得

session_id = "job_001"

novada_proxy_session(session_id, url="/login")    → 同一 IP
novada_proxy_session(session_id, url="/dashboard") → 同一 IP
novada_proxy_session(session_id, url="/data/1")    → 同一 IP
novada_proxy_session(session_id, url="/data/2")    → 同一 IP

エージェント優先の設計

メモ

Novada Proxy は、自律型 AI エージェント専用に設計された唯一のプロキシ MCP です。すべての応答、エラー、説明は、機械による利用に最適化されています。

主な特長

1. 住宅用 IP ネットワーク

• 200 万台以上の実デバイス：Android 携帯電話、Windows PC、Mac
• 7,000 以上のアクティブノード、稼働率 99.9%
• 実際の家庭用 IP フィンガープリントにより、Cloudflare、Akamai、DataDome の検出を回避

2. 地理ターゲティング

• 195 以上の国、2 文字の ISO コード（US、DE、JP、BR...）
• 都市レベルの位置指定：newyork、london、tokyo、singapore...
• 同じ URL でも国が異なれば、独立したキャッシュキーが割り当てられ、互いに影響しません

3. 応答キャッシュ

同じ URL を繰り返し取得しても、プロキシのクレジットを消費しません：

// 第一次调用（live fetch）
"meta": { "cache_hit": false, "latency_ms": 1800, "quota": { "credits_estimated": 1 } }

// 第二次调用（cache hit）
"meta": { "cache_hit": true, "cache_age_seconds": 5, "latency_ms": 0 }

4. エージェント優先の JSON 出力

すべてのツールは統一された構造を返します：

{
  "ok": true / false,
  "tool": "工具名称",
  "data": { ... },
  "meta": {
    "latency_ms": 1800,
    "cache_hit": false,
    "quota": { "credits_estimated": 1 }
  }
}

5. 型付きエラーコード + 復旧指示

すべてのエラーには、code（列挙型）、recoverable（ブール値）、agent_instruction（次の操作）が含まれます：

{
  "ok": false,
  "error": {
    "code": "BOT_DETECTION_SUSPECTED",
    "recoverable": true,
    "agent_instruction": "Try novada_proxy_render (real browser). Or retry with a different country/session_id."
  }
}

6. バッチ並列取得

novada_proxy_batch_fetch には、セマフォによる並行処理制御が組み込まれています：

// 10 个 URL，concurrency=5，wall time = ~8.8s（串行估计 ~50s）
{
  "data": {
    "results": [
      { "url": "...", "ok": true, "cache_hit": false, "latency_ms": 1200 },
      { "url": "...", "ok": true, "cache_hit": true,  "latency_ms": 0 },
      { "url": "...", "ok": false, "error": { "code": "TLS_ERROR" } }
    ]
  },
  "meta": { "latency_ms": 8800, "quota": { "credits_estimated": 10 } }
}

7. 複数プロバイダーのサポート

8. 段階的なフォールバック（render_fallback）

novada_proxy_extract はブラウザーレンダリングへの自動切り替えをサポートします：

代理抓取失败（TLS / Bot检测）
        │
        ▼ render_fallback=true
novada_proxy_render（真实 Chromium）
        │
        ▼
data.extracted_via = "render"  （agent 知道走了哪条路径）
data.fetch_warning = "Proxy fetch failed... escalated to render"

クイックインストール

# 核心（住宅代理抓取）
claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=你的用户名 \
  -e NOVADA_PROXY_PASS=你的密码 \
  -- npx -y novada-proxy-mcp

# 仅搜索
claude mcp add novada-proxy-mcp \
  -e NOVADA_API_KEY=你的_API_Key \
  -- npx -y novada-proxy-mcp

# 全功能（代理 + 搜索 + 浏览器渲染）
claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=你的用户名 \
  -e NOVADA_PROXY_PASS=你的密码 \
  -e NOVADA_API_KEY=你的_API_Key \
  -e NOVADA_BROWSER_WS=你的_Browser_WS_URL \
  -- npx -y novada-proxy-mcp

認証情報の取得：novada.com -> ダッシュボード -> 住宅用プロキシ -> エンドポイントジェネレーター

Cursor / Windsurf / Cline の設定：

{
  "mcpServers": {
    "novada-proxy-mcp": {
      "command": "npx",
      "args": ["-y", "novada-proxy-mcp"],
      "env": {
        "NOVADA_PROXY_USER": "你的用户名",
        "NOVADA_PROXY_PASS": "你的密码"
      }
    }
  }
}

ツールパラメーター早見表

novada_proxy_fetch

novada_proxy_batch_fetch

novada_proxy_extract

novada_proxy_map

novada_proxy_session

novada_proxy_search

novada_proxy_render [BETA]

novada_proxy_crawl

递归 BFS 爬取站点，从起始 URL 出发，按深度逐层发现链接，返回完整 URL 树及元数据。

适用场景： 全站抓取、站点地图生成、内容索引 — 需要抓取多个页面时使用。

改用 novada_proxy_map 的情况： 只需要单页链接（一层深度）。Map 更快、更省额度。

组合使用： 将 data.urls[] 传入 novada_proxy_batch_fetch 并发抓取。

请求示例：

{
  "url": "https://example.com",
  "depth": 2,
  "limit": 50,
  "include_content": false
}

响应： data.pages[]（url、depth、status_code、total_links），data.urls[]（扁平数组，可直接传给 novada_proxy_batch_fetch）

novada_proxy_research

一键深度研究工具 — 搜索网络、抓取排名靠前的结果，返回含来源预览的结构化分析。智能体可对 findings 进行进一步综合分析。

需要： NOVADA_API_KEY（Google 搜索）+ 代理凭证（抓取来源页面）

适用场景： 研究问题、主题调研、竞品分析、事实核查 — 需要一次调用获取多个来源内容时。

改用 novada_proxy_search 的情况： 只需要搜索结果 URL，不需要完整页面内容。

组合使用： 对 data.urls[] 中的特定 URL 调用 novada_proxy_fetch 进行深度阅读。

注意： findings_summary 是各来源内容的拼接预览 — 智能体应分析 findings[] 进行实质性综合。

请求示例：

{
  "query": "2026年最佳住宅代理服务商",
  "depth": "standard"
}

响应： data.findings[]（title、url、snippet、content_preview），data.urls[]（可链式传给其他工具），data.findings_summary

novada_proxy_extract — Schema 模式（LLM 提取）

除 fields（启发式提取）外，novada_proxy_extract 还支持 schema 参数，通过智能体自身的 LLM 提取任意字段 — 零额外 API 费用。

传入 schema 替代 fields，工具返回清洗后的页面内容 + 提取提示词 — 由你的智能体完成提取。

请求示例：

{
  "url": "https://example.com/product",
  "schema": {
    "product_name": "完整的产品名称",
    "price": "当前价格（含货币符号）",
    "warranty": "保修条款和期限",
    "return_policy": "退货政策摘要"
  }
}

响应： data.mode = "llm_extract"，data.content（清洗后的 Markdown 内容），data.extraction_prompt（供智能体遵循并提取字段的指令）

安全限制： Schema 键名只能包含字母、数字、下划线（a-z、0-9、_），最多 50 字符；值最多 200 字符。

使用场景

AI 智能体需要：

• 抓取电商网站（Amazon、eBay、Walmart）不被封锁
• 跨国家监控价格变动
• 访问 195+ 国家的地区限制内容
• 对 Cloudflare/Akamai 保护站点进行竞争情报收集
• 执行多步登录流程并保持同一 IP
• 渲染无真实浏览器就返回空白的 JS 页面
• Google 搜索返回结构化 JSON 结果

开发者构建：

• AI 驱动的网页研究工具
• 价格比较智能体
• 全站内容爬取管道
• SEO 监控仪表盘
• 市场调研自动化

已验证可用

电商： Amazon、eBay、Walmart、Etsy、Shopify
职业网络： LinkedIn
反机器人保护： Cloudflare 站点、Akamai、DataDome
新闻内容： HackerNews、Reddit、BBC、CNN、NYTimes
科技： GitHub、Wikipedia、Stack Overflow、IMDB

反馈与支持

• 邮箱： [email protected]
• GitHub Issues： github.com/NovadaLabs/Novada-proxy/issues
• 官网： novada.com

许可证

MIT © Novada