Aethyn Browser

Aethyn Browser MCP — AI エージェント向けのレジデンシャルプロキシ経由のブラウザー制御（国を選択し、タスクごとに 1 つのアイデンティティを使用）

AI エージェントがレジデンシャルプロキシ経由で実際のブラウザーを操作し、呼び出し時に出口の国／都市、ティア、タスクごとの固定セッションを選択できる MCP サーバーです。ブラウザー（Playwright Chromium）はお使いのマシン上でローカルに実行されます。プロキシの認証情報はご自身で用意してください。デフォルトでは Aethyn のレジデンシャルプロキシを使用しますが、設定した任意の HTTP プロキシで動作します。

エージェントが国を選び、タスクごとに 1 つのアイデンティティを保持できる唯一のブラウザー MCP です。

このプロジェクトを作った理由

• Playwright MCP はブラウザーをうまく操作できますが、プロキシはサーバー起動時に一度だけ設定されるため、セッション全体で出口は固定されます。エージェントは、あるタスクでは日本の出口を、次のタスクではドイツの出口を指定できません。
• ホスト型の「ウェブスクレイピング」MCP はプロキシを隠して JSON を返すだけです。実行時に地域やセッションのアイデンティティを制御できず、利用するのはそのサービスのプロキシプールで、その料金もかかります。

このサーバーでは、実行時にタスクごとに調整できる地域設定と固定アイデンティティをツールとしてエージェントに提供します。これは、国別データ（価格、SERP、カタログ、在庫状況）を取得し、チャートやパイプラインに取り込むブラウザーエージェントに必要な機能です。

クイックスタート

MCP クライアント（Claude Desktop の claude_desktop_config.json または Cursor の ~/.cursor/mcp.json）にサーバーを追加します。

{
  "mcpServers": {
    "aethyn-browser": {
      "command": "npx",
      "args": ["-y", "aethyn-browser-mcp"],
      "env": {
        "AETHYN_USERNAME": "aethyn-XXXXX",
        "AETHYN_PASSWORD": "your-proxy-password",
        "AETHYN_DEFAULT_TIER": "premium"
      }
    }
  }
}

Chromium は初回インストール時に自動的にダウンロードされます（約 170 MB、一度のみ）。お使いの環境でインストール後のスクリプトがブロックされる場合は、次のコマンドを実行してください：npx playwright install chromium。

⚠️ ご利用プランに合わせてティアを設定してください。 AETHYN_DEFAULT_TIER のデフォルトは premium（ポート 2099）です。アカウントが Elite の場合は elite（ポート 5499）に設定してください。そうしないと、ブラウザーは問題なく起動しても、トラフィックが Premium ポートに送られ、プロキシから 407（認証拒否） が返されます。エージェントは tier: "elite" を指定して、タスクごとに上書きすることもできます。

これで完了です。エージェントに、たとえば 「日本でブラウザーを起動し、example.co.jp を開いて、出口 IP が日本のものか確認し、ページをマークダウンで提示してください。」 と依頼してください。

ツール

ツール	内容
aethyn_launch_browser	選択した country（Elite では city／state も指定可能）、tier、固定の session を使い、レジデンシャル出口経由でローカルの Chromium を起動します。session_id を返します。
aethyn_navigate	URL に移動し、読み込みを待って HTTP ステータス、最終 URL、タイトルを返します。
aethyn_get_content	読みやすく整形したページを返します（markdown／text／html）。
aethyn_snapshot	アクセシビリティスナップショット（ロール、名前、[ref=..] ハンドル）を返します。エージェントはこれを使ってクリックする対象を判断します。
aethyn_click	スナップショットの ref、または CSS／ロール／テキストの selector を使ってクリックします。
aethyn_type	入力欄に文字を入力します（任意で Enter キーによる送信も可能）。
aethyn_check_exit_ip	セッションのプロキシ経由で IP 情報を取得し、地域設定が実際に反映されたことを確認します。
aethyn_new_identity	新しい出口 IP に切り替え（国は同じ）、Cookie をクリアします。
aethyn_close	セッションのコンテキストを閉じ、メモリを解放します。
aethyn_list_countries	利用可能な国（および Elite の都市）を実行時に確認します。

異なる点

	Aethyn Browser MCP	Playwright MCP	ホステッド型のスクレイピング MCP
ブラウザーの実行場所	ローカル（お使いの環境）	ローカル	クラウド
エージェントがタスクごとにプロキシの地域を選択	✅ 呼び出し時に指定	❌ 起動時に固定	❌ 指定できない
タスクごとに固定される ID（固定された出口 IP）	✅	❌	❌
出口の地域が反映されたか確認	✅ check_exit_ip	❌	❌
独自のプロキシを使用	✅ 任意の HTTP プロキシ	固定プロキシ 1 つ	❌

他をけなす意図はありません。機能の違いを示しているだけです。（Playwright MCP は優れています。ただ、タスクごとの地域指定を目的に作られていないだけです。）

独自のプロキシを使用する

デフォルトは Aethyn ですが、任意の HTTP プロキシを使用できます。PROXY_HOST をそのプロキシに設定し、テンプレートでユーザー名の形式を指定します。空の場合は [ ... ] の部分が削除され、{country} {city} {state} {session} {lifetime} はエージェントからの呼び出しの値で置き換えられます。

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "aethyn-browser-mcp"],
      "env": {
        "PROXY_HOST": "gate.your-provider.com",
        "PROXY_PORT": "7000",
        "PROXY_USERNAME": "your-user",
        "PROXY_PASSWORD": "your-pass",
        "PROXY_USERNAME_TEMPLATE": "{username}-country-{country}[-city-{city}]-session-{session}-lifetime-{lifetime}"
      }
    }
  }
}

ユーザー名に地域情報を含まない固定プロキシを使用する場合は、"PROXY_USERNAME_TEMPLATE": "{username}" を指定します。

設定

環境変数	デフォルト	説明
AETHYN_USERNAME / AETHYN_PASSWORD	—	Aethyn プロキシの認証情報（デフォルトのプロバイダー）。
AETHYN_DEFAULT_TIER	premium	premium（HTTP 2099）または elite（HTTP 5499、市区町村／州の指定が可能）。
AETHYN_HEADLESS	true	ブラウザーを表示するには false に設定します。
AETHYN_MAX_SESSIONS	8	この上限を超えると、最も古いセッションが削除されます。
AETHYN_IDLE_TIMEOUT_MIN	10	アイドル状態のセッションは、この分数が経過すると自動的に閉じられます。
AETHYN_IPINFO_URL	https://ipinfo.io/json	check_exit_ip が（プロキシ経由で）アクセスするエンドポイントです。
PROXY_HOST / PROXY_PORT / PROXY_USERNAME / PROXY_PASSWORD / PROXY_USERNAME_TEMPLATE	—	独自のプロキシを使用します（Aethyn のデフォルト設定を上書きします）。

HTTP プロキシのみ対応 — Chromium は SOCKS5 の認証に対応していないため、このサーバーは設計上 HTTP 専用です。

利用上のガイドライン

このツールは公開データの収集を目的としています。以下をお守りください。

• robots.txt、レート制限、各サイトの利用規約および法律を遵守してください。アクセスできることと、アクセスすべきことは別です。
• ログインや認証情報によるアクセス制限を自動化しないでください。また、CAPTCHA を解こうとしないでください。そのような機能はありません。サイトにチャレンジが表示された場合は、回避を試みず、ページを読んで停止してください。
• 適切な頻度で利用してください。住宅用 IP から毎秒何十件ものリクエストが送信されれば、明らかにボットだと分かります。
• 認証情報はお使いのマシン上の MCP 設定に保存されます。プロキシのパスワードがログに記録されることはありません。

認証情報の取得

住宅用プロキシの認証情報が必要ですか？ 無料トライアルにカード登録は不要です。

→ Aethyn アカウントを作成 · クイックスタートドキュメント · 料金

コントリビューション

プルリクエストを歓迎します。特に、国、市区町村、州（小文字の英数字のみのトークン）を追加してdata/locations.jsonを拡張する変更や、新しいクライアントの使用例を歓迎します。実用的で実行可能な内容にしてください。認証情報にはプレースホルダーのみを使用してください。

ライセンス

MIT — 自由に使用、コピー、改変できます。