Aethyn Browser

Aethyn Browser MCP — 为 AI Agent 提供住宅代理浏览器控制（选择国家，每项任务使用一个身份）

一个 MCP 服务，可让 AI Agent 通过住宅代理操控真实浏览器，并在调用时选择出口国家／城市、等级，以及每项任务专属的粘性会话。浏览器（Playwright Chromium）在你的本机运行；代理凭据由你自行提供。默认使用 Aethyn 住宅代理，也支持你配置的任何 HTTP 代理。

唯一一款可让 Agent 选择国家，并在每项任务中保持同一身份的浏览器 MCP。

为什么要做这个项目

• Playwright MCP 能很好地操控浏览器，但其代理只能在服务启动时设置一次——整个会话共用一个固定出口。Agent 无法为一项任务选择日本出口，接着为下一项任务选择德国出口。
• 托管式“网页抓取” MCP 会隐藏代理并返回 JSON——无法在运行时控制地理位置或会话身份，而且代理池和价格都由服务商决定。

这个服务将可在运行时按任务调整的地理位置和粘性身份作为工具交给 Agent——这正是浏览器 Agent 获取特定国家的数据（价格、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（认证被拒绝），即使浏览器已正常启动。Agent 也可以按任务通过 tier: "elite" 覆盖此设置。

就这么简单。可以这样向 Agent 提出请求：“在日本启动浏览器，打开 example.co.jp，确认出口 IP 来自日本，并以 Markdown 格式提供页面内容。”

工具

工具	功能
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=..] 句柄）——Agent 据此决定要点击什么。
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
浏览器运行位置	本地（你的设备）	本地	他们的云端
Agent 按任务选择代理地理位置	✅ 调用时选择	❌ 启动时固定	❌ 不支持
每项任务使用固定身份（固定出口 IP）	✅	❌	❌
验证出口地理位置是否正确	✅ check_exit_ip	❌	❌
使用自己的代理	✅ 任意 HTTP 代理	一个静态代理	❌

不说别人坏话，只说功能差异。（Playwright MCP 很不错，只是它并非为按任务选择地理位置而构建。）

使用自己的代理

Aethyn 是默认选项，但任何 HTTP 代理都能使用——将 PROXY_HOST 指向该代理，并用模板描述其用户名格式。为空时会删除 [ ... ] 片段，并根据 Agent 的调用填入 {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 账户 · 快速入门文档 · 定价

贡献

欢迎提交 PR——尤其欢迎扩展 data/locations.json，添加更多国家、城市和州（使用小写字母数字组成的单个词元），以及新的客户端示例。请确保内容真实可运行；仅使用占位凭据。

许可证

MIT——可免费使用、复制和修改。