Proxy Veil

Proxy4Agent

AI エージェント向けのレジデンシャルプロキシ MCP サーバーです。 Android スマートフォン、Windows PC、Mac など、200 万台以上の実在する家庭用デバイスを経由してあらゆる HTTP リクエストをルーティングし、ボット対策システムを回避できます。国や都市を指定したジオターゲティングや、複数ステップのワークフローにわたるスティッキーセッションにも対応します。

Claude Code、Cursor、Windsurf、Cline、Continue、およびあらゆる MCP 互換 AI エージェントで利用できます。Novada を基盤としています。

---

Proxy4Agent が選ばれる理由

AI エージェントは、商用ウェブサイトの 60～70％でブロックされます。一般的な HTTP リクエストは、Cloudflare、Akamai、DataDome、PerimeterX などのシステムに検出され、拒否されます。Proxy4Agent は、エージェントの通信を実在するレジデンシャル IP 経由でルーティングするため、人間のブラウザーと見分けがつかないようにできます。

問題	Proxy4Agent
Amazon、LinkedIn がエージェントをブロックする	実在する家庭用デバイスのレジデンシャル IP
Cloudflare／Akamai のボット対策チャレンジ	実際のデバイスフィンガープリントで回避
JavaScript で描画されるページが空白で返る	ブラウザー API が実際の Chromium を実行
地域制限のあるコンテンツやローカライズされたコンテンツ	195 か国以上に対応し、都市レベルでターゲティング可能
複数ステップのワークフローでセッションが失われる	スティッキーセッションにより、呼び出し間で同じ IP を維持
構造化された検索結果が必要	Google 検索を内蔵し、クリーンな JSON 形式で出力

---

プロバイダー

Proxy4Agent はあらゆる HTTP プロキシで動作します。Novada は、最も深く統合された組み込みのデフォルトプロバイダーです。BrightData、Smartproxy、Oxylabs には、完全な自動ターゲティングに対応した専用アダプターがあります。その他のプロバイダーは、汎用アダプター経由で利用できます。

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

Novada（デフォルト — 推奨）

完全統合：ジオターゲティング、都市レベルのターゲティング、スティッキーセッション、195 か国以上への対応を自動化します。

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

認証情報の取得先：novada.com → ダッシュボード → Residential Proxies → Endpoint Generator

BrightData

完全統合：BrightData のユーザー名サフィックス形式を使用した、国・都市・セッションのターゲティングを自動化します。

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

認証情報の取得先：brightdata.com → Proxies & Scraping → Residential → Access Parameters

BRIGHTDATA_USER はゾーンを含む完全なユーザー名です（例：brd-customer-abc123-zone-residential）。任意の設定項目：BRIGHTDATA_HOST（デフォルト：zproxy.lum-superproxy.io）、BRIGHTDATA_PORT（デフォルト：22225）。

Smartproxy

完全統合：国・都市・セッションのターゲティングを自動化します。

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

認証情報の取得先：smartproxy.com → ダッシュボード → Residential → Endpoint Generator

任意の設定項目：SMARTPROXY_HOST（デフォルト：gate.smartproxy.com）、SMARTPROXY_PORT（デフォルト：10001）。

Oxylabs

完全統合：国・都市・セッションのターゲティングを自動化します。

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

認証情報の取得先：oxylabs.io → ダッシュボード → Residential Proxies → Access Details

任意の設定項目：OXYLABS_HOST（デフォルト：pr.oxylabs.io）、OXYLABS_PORT（デフォルト：7777）。

汎用HTTPプロキシ — その他のプロバイダー

PROXY_URLを設定すると、IPRoyal、自前のインフラ、または標準的なHTTPプロキシを使用できます。

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

# Any HTTP proxy
claude mcp add bestproxy4agents \
  -e PROXY_URL="http://user:pass@your-proxy-host:port" \
  -- npx -y bestproxy4agents

注： 汎用アダプターでは、プロバイダーの形式に従って、国・都市・セッションの指定をプロキシURLに直接エンコードしてください。ツールのcountry、city、session_idパラメーターは警告としてログに記録され、転送されません。

機能	Novada	BrightData	Smartproxy	Oxylabs	汎用HTTP
国の自動指定	✓	✓	✓	✓	手動
都市の自動指定	✓	✓	✓	✓	手動
スティッキーセッション	✓	✓	✓	✓	手動
組み込み検索API	✓	—	—	—	—
ブラウザーAPI（JSレンダリング）	✓	—	—	—	—

---

認証情報を取得する

**novada.com**で登録してください。30秒で完了し、クレジットカードは不要です。

ツール	必要な環境変数	取得場所
agentproxy_fetch	NOVADA_PROXY_USER + NOVADA_PROXY_PASS	Dashboard → Residential Proxies → Endpoint Generator
agentproxy_session	NOVADA_PROXY_USER + NOVADA_PROXY_PASS	Dashboard → Residential Proxies → Endpoint Generator
agentproxy_search	NOVADA_API_KEY	Dashboard → API Keys
agentproxy_render [BETA]	NOVADA_BROWSER_WS	Dashboard → Browser API → Playground → Puppeteer URLをコピー
agentproxy_status	(none)	—

使用するツールの認証情報だけが必要です。

---

インストール

Fetch + Session（コア — まずはこちらを推奨）：

claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -e NOVADA_PROXY_HOST=your_account_host \
  -- npx -y bestproxy4agents

Searchのみ：

claude mcp add bestproxy4agents \
  -e NOVADA_API_KEY=your_key \
  -- npx -y bestproxy4agents

すべてのツール：

claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -e NOVADA_PROXY_HOST=your_account_host \
  -e NOVADA_API_KEY=your_key \
  -- npx -y bestproxy4agents

NOVADA_PROXY_HOST — Endpoint Generatorで確認できる、アカウント固有のプロキシホストです（例：abc123.vtv.na.novada.pro）。スティッキーセッションを確実に利用するには必須です。省略した場合は、共有ロードバランサーが使用されます。

---

互換性

Proxy4Agentは、MCP互換のあらゆるAIクライアントで動作します。

クライアント	インストール方法
Claude Code	claude mcp add bestproxy4agents -e ... -- npx -y bestproxy4agents
Cursor	Settings → MCP → Add server → npx -y bestproxy4agents
Windsurf	MCP config → npx -y bestproxy4agents
Cline	MCP settings → command: npx, args: ["-y", "bestproxy4agents"]
Continue	.continue/config.json → mcpServers
Smithery	smithery.ai/server/proxy4agent
任意のMCPクライアント	stdioトランスポート、npx -y bestproxy4agents

Claude Codeの例（コピーしてすぐに使用できます）：

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

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

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

---

ツール

agentproxy_fetch

レジデンシャルプロキシ経由で任意のURLを取得します。Amazon、LinkedIn、Cloudflareで保護されたページ、および大半のボット対策が施されたサイトで動作します。

必要なもの： 任意のプロキシプロバイダー — Novada（NOVADA_PROXY_USER + NOVADA_PROXY_PASS）、BrightData、Smartproxy、Oxylabs、またはPROXY_URL

パラメーター	型	デフォルト	説明
url	string	必須	対象URL（http://またはhttps://）
country	string	—	2文字のISOコード：US、DE、JP、GB、BR、IN、FR、CA、AUなど（195か国以上）
city	string	—	都市レベルの指定：newyork、london、tokyo、paris、berlinなど
session_id	string	—	同じIDを再利用すると、同じIPを維持します（英字・数字・アンダースコアのみ、最大64文字）
format	string	markdown	markdownはHTMLタグを除去し、rawはHTML全体を返します
timeout	number	60	タイムアウト（秒）（1～120）

---

agentproxy_session

スティッキーセッションでの取得。同じ session_id を指定した呼び出しでは、毎回同じ住宅用 IP が使用されます。ログインフロー、ページネーションを利用したスクレイピング、複数ページにわたる価格のモニタリングに不可欠です。

必要なもの： 任意のプロキシプロバイダー。Novada（NOVADA_PROXY_USER + NOVADA_PROXY_PASS）、BrightData、Smartproxy、Oxylabs、または PROXY_URL

パラメーター	型	デフォルト	説明
session_id	string	必須	一意の ID。同じ IP を維持するには再利用します（ハイフンなし、最大 64 文字）
url	string	必須	対象 URL
country	string	—	2 文字の国コード
city	string	—	都市単位のターゲティング：newyork、london、tokyo...
format	string	markdown	markdown または raw
timeout	number	60	タイムアウト時間（秒）（1～120）

---

agentproxy_search

Novada 経由の構造化された Google 検索です。タイトル、URL、説明を返すため、HTML の解析は不要です。情報の発見や調査タスクに最適です。

必要なもの： NOVADA_API_KEY

パラメーター	型	デフォルト	説明
query	string	必須	検索クエリ
num	number	10	結果の件数（1～20）
country	string	—	結果の地域を指定：us、uk、de、jp、fr...
language	string	—	言語：en、zh、de、ja、fr...

---

agentproxy_render [BETA]

Novada の Browser API（実際の Chromium、完全な JS 実行）を使用して、JavaScript を多用するページをレンダリングします。SPA、React／Vue アプリ、実際のブラウザーを使わないと空白を返すページに使用します。

必要なもの： NOVADA_BROWSER_WS（Dashboard → Browser API → Playground から Puppeteer URL をコピーしてください）

パラメーター	型	デフォルト	説明
url	string	必須	対象 URL
format	string	markdown	markdown · html · text
wait_for	string	—	抽出前に待機する CSS セレクター（例：.product-title）
timeout	number	60	タイムアウト時間（秒）（5～120）

---

agentproxy_status

Novada のプロキシネットワークの健全性を確認します。稼働中のノード数、デバイスタイプ、サービスステータスを確認できます。認証情報は不要です。

---

実際の使用結果

実際の API 呼び出しによる出力です。捏造したものではありません。

ジオターゲティング：同じ URL、異なる出口国

agentproxy_fetch(url="https://httpbin.org/ip", country="US", format="raw")
→ { "origin": "200.50.235.236" }   ← US residential IP

agentproxy_fetch(url="https://httpbin.org/ip", country="JP", format="raw")
→ { "origin": "60.85.57.175" }     ← Japan residential IP

スティッキーセッション：2 回のリクエストで同じ IP を確認

agentproxy_session(session_id="job001", url="https://httpbin.org/ip", format="raw")
→ { "origin": "103.135.135.168" }

agentproxy_session(session_id="job001", url="https://httpbin.org/ip", format="raw")
→ { "origin": "103.135.135.168" }  ← same IP, confirmed ✓

Amazon — 1.6 MB の商品ページをブロックされずに取得

agentproxy_fetch(url="https://www.amazon.com/dp/B0BSHF7WHW", country="US")
→ [URL: https://www.amazon.com/dp/B0BSHF7WHW | Status: 200 | Size: 1637 KB | Country: US]

  Apple 2023 MacBook Pro — M2 Pro chip, 16-inch, 16GB, 1TB
  Full product page: price, reviews, specs, related items

HackerNews — 30 件の記事を整った Markdown 形式で取得

agentproxy_fetch(url="https://news.ycombinator.com")
→ [URL: https://news.ycombinator.com | Status: 200 | Size: 34 KB]

  1. LittleSnitch for Linux — 752 points, 243 comments
  2. I ported Mac OS X to the Nintendo Wii — 1590 points, 281 comments
  3. Git commands I run before reading any code — 2054 points, 445 comments
  ...

Google 検索 — HTML を解析せずに構造化された出力を取得

agentproxy_search(query="residential proxy for AI agents", num=3)
→ Search: "residential proxy for AI agents" via GOOGLE — 3 results

  1. Residential Proxies Trusted by Fortune 500 Companies
     https://brightdata.com/proxy-types/residential-proxies
     Access 400M+ residential proxies from 195 countries...

  2. Proxies for AI Web Agents: The Complete Guide
     https://netnut.io/proxies-for-ai-web-agents/
     Real-user IPs that bypass even the toughest anti-bot systems...

ブラウザーレンダリング — React SPA、完全な JS 実行

agentproxy_render(url="https://react.dev", format="markdown")
→ [URL: https://react.dev | Title: React | Size: 266 KB | Rendered: yes (Browser API)]

  React v19.2

  The library for web and native user interfaces

  ## Create user interfaces from components
  React lets you build user interfaces out of individual pieces called components.
  Create your own React components like Thumbnail, LikeButton, and Video.
  Then combine them into entire screens, pages, and apps.
  ...

ブラウザーレンダリング — HackerNews で wait_for セレクターを使用

agentproxy_render(url="https://news.ycombinator.com", wait_for=".athing")
→ [URL: https://news.ycombinator.com | Title: Hacker News | Size: 34 KB | Rendered: yes (Browser API)]

  1. LittleSnitch for Linux — 834 points, 285 comments
  2. Help Keep Thunderbird Alive — 138 points, 77 comments
  3. I ported Mac OS X to the Nintendo Wii — 1638 points
  ...

---

ワークフローの例

価格モニター — 同じ商品、3 つの市場

agentproxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="US")
agentproxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="DE")
agentproxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="JP")

ログイン＋同じ IP で複数ページをスクレイピング

agentproxy_session(session_id="workflow01", url="https://example.com/login")
agentproxy_session(session_id="workflow01", url="https://example.com/dashboard")
agentproxy_session(session_id="workflow01", url="https://example.com/data/page/1")
agentproxy_session(session_id="workflow01", url="https://example.com/data/page/2")

調査パイプライン

# 1. Find relevant pages
agentproxy_search(query="Claude MCP proxy tools", num=10)

# 2. Fetch each result through residential proxy
agentproxy_fetch(url="https://found-result.com/article", country="US")

# 3. Render JS-heavy dashboard (requires Browser API)
agentproxy_render(url="https://app.example.com/dashboard", wait_for=".data-table")

---

ジオカバレッジ

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 PK BD TW HK NZ ＋ その他 188 か国

都市単位のターゲティング（一部）：newyork · losangeles · chicago · london · paris · berlin · tokyo · seoul · sydney · toronto · singapore · dubai · mumbai · saopaulo

---

ネットワーク

指標	値
住宅用 IP	2,000,000+
稼働中のノード	7,000+
国数	195+
デバイスタイプ	Android、Windows、Mac
稼働率	99.9%

---

動作確認済み

E コマース： Amazon、eBay、Walmart、Etsy、Shopify ストア
プロフェッショナルネットワーク： LinkedIn
ボット対策で保護されたサイト： Cloudflare サイト、Akamai で保護されたページ、DataDome で保護されたサイト
ニュースとコンテンツ： HackerNews、Reddit、BBC、CNN、NYTimes
テクノロジー： GitHub、Wikipedia、Stack Overflow
エンターテインメント： IMDB、Rotten Tomatoes

---

依存関係

パッケージ	バージョン	用途
@modelcontextprotocol/sdk	^1.26	MCP プロトコル — stdio トランスポート、ツール定義、リクエスト処理
axios	^1.7	HTTP クライアント — リダイレクト、圧縮、ストリーミングを処理
https-proxy-agent	^9.0	HTTPS プロキシルーティング — セキュアな接続先向けの CONNECT トンネルと TLS
http-proxy-agent	^7.0	HTTP プロキシルーティング — プロキシ経由の通常の HTTP 接続先
puppeteer-core	^22.15	ブラウザー API — Novada の実際の Chromium クラウドへの WebSocket 接続

軽量なコアです。パッケージサイズ：約 52 KB（node_modules を除く）。最大の依存関係は puppeteer-core ですが、ブラウザーはバンドルされておらず、Novada のリモート Chromium に接続します。

---

ユースケース

次のような用途を必要とする AI エージェント向けです：

• ブロックされずに E コマースサイト（Amazon、eBay、Walmart、Shopify）をスクレイピングする
• 国や市場をまたいで価格を監視する
• 195 か国以上から地域制限のあるコンテンツにアクセスする
• Cloudflare／Akamai で保護されたサイトの競合情報を収集する
• 一貫した IP（スティッキーセッション）で複数ステップのログインフローを実行する
• 実際のブラウザーがないと空白を返す、JavaScript を多用した SPA をレンダリングする
• Google をプログラムから検索し、整った構造化結果を取得する
• さまざまな地域のローカライズされた検索結果を収集する
• ボット対策システムの背後にあるビジネスネットワーク（LinkedIn）にアクセスする

次のものを開発する開発者向けです：

• AI を活用したウェブ調査ツール
• 価格比較エージェント
• コンテンツ集約パイプライン
• SEO 監視ダッシュボード
• 市場調査の自動化
• リード獲得ワークフロー

---

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

機能のリクエスト、バグ報告、proxy4agent の利用方法など、ぜひお聞かせください：

• メール： [email protected]
• GitHub の課題： github.com/Goldentrii/proxy4agent/issues
• ウェブサイト： novada.com

皆さまからのフィードバックが、今後の開発方針につながります。バグ報告や機能リクエストの一つひとつが、すべてのエージェントと開発者にとって proxy4agent をより良くするために役立ちます。

---

既知の制限事項

• 完全な JS 実行が必要なサイト → agentproxy_render を使用してください
• agentproxy_render には、別途 Novada Browser API のサブスクリプションと NOVADA_BROWSER_WS が必要です
• セッション ID にハイフンを含めることはできません（Novada は - を認証区切り文字として使用します）
• スティッキーセッションを安定して利用するには、NOVADA_PROXY_HOST にアカウント固有のホストを設定してください

---

ライセンス

MIT © Novada

本ソフトウェアのコピーを取得するすべての人に対し、無料で、本ソフトウェアの使用、複製、変更、結合、公開、配布、サブライセンス、および／または販売を許可します。ただし、以下の条件に従うものとします：上記の著作権表示および本許諾表示を、本ソフトウェアのすべてのコピーまたは実質的な部分に含めること。

本ソフトウェアは「現状のまま」提供され、いかなる種類の保証もありません。

全文については LICENSE を参照してください。

---

---

Proxy4Agent（中国語ドキュメント）

AI エージェント向けの住宅プロキシ MCP サーバーです。 200 万台以上の実際の家庭用デバイスを経由して HTTP リクエストをルーティングし、ボット対策システムを回避します。国や都市を指定でき、リクエストをまたいで同じ IP を維持できます。

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

---

Proxy4Agent を選ぶ理由

AI エージェントは商用ウェブサイトの 60～70％でブロックされています。標準的な HTTP リクエストは、Cloudflare、Akamai、DataDome などのシステムによって検知され、拒否されます。Proxy4Agent は実際の住宅 IP を経由してリクエストをルーティングするため、人間のブラウザーと見分けがつきません。

問題	Proxy4Agent
Amazon、LinkedIn がエージェントをブロックする	実際の家庭用デバイスからの住宅 IP
Cloudflare／Akamai のボット検知	実際のデバイスフィンガープリントを通じて回避
JS レンダリングページが空白を返す	ブラウザー API が実際の Chromium を実行
地域制限またはローカライズされたコンテンツ	195 か国以上、都市レベルで指定可能
複数ステップのワークフローでセッションが失われる	スティッキーセッション — リクエストをまたいで同じ IP
構造化された検索結果が必要	JSON を出力する Google 検索機能を内蔵

---

支持的代理提供商

优先级：Novada → BrightData → Smartproxy → Oxylabs → 通用 HTTP。首个配置的提供商生效。

功能	Novada	BrightData	Smartproxy	Oxylabs	通用 HTTP
自动国家定位	✓	✓	✓	✓	手动
自动城市定位	✓	✓	✓	✓	手动
粘性会话	✓	✓	✓	✓	手动
搜索 API	✓	—	—	—	—
浏览器 API (JS 渲染)	✓	—	—	—	—

---

快速开始

# Novada（推荐）
claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=你的用户名 \
  -e NOVADA_PROXY_PASS=你的密码 \
  -- npx -y bestproxy4agents

# BrightData
claude mcp add bestproxy4agents \
  -e BRIGHTDATA_USER="brd-customer-abc123-zone-residential" \
  -e BRIGHTDATA_PASS=你的密码 \
  -- npx -y bestproxy4agents

# 任意 HTTP 代理
claude mcp add bestproxy4agents \
  -e PROXY_URL="http://user:pass@host:port" \
  -- npx -y bestproxy4agents

获取 Novada 凭证：novada.com → 仪表盘 → 住宅代理 → 端点生成器

---

5 个 MCP 工具

工具	功能
agentproxy_fetch	通过住宅代理获取任何 URL。支持国家/城市/会话定位。
agentproxy_session	粘性会话 — 同一 session_id 使用同一 IP。用于登录流程、分页抓取。
agentproxy_search	Google 搜索，返回标题、URL、描述。无需 HTML 解析。
agentproxy_render	用真实 Chromium 渲染 JS 页面（SPA、React/Vue 应用）。
agentproxy_status	检查代理网络健康状态。无需凭证。

---

使用场景

AI 智能体需要：

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

开发者构建：

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

---

反馈与支持

• 邮箱： [email protected]
• GitHub Issues： github.com/Goldentrii/proxy4agent/issues
• 网站： novada.com

---

许可证

MIT © Novada