Browserbeam MCP

Browserbam MCP服务器

MCP（模型上下文协议） 服务器 Browserceam --在Cursor、Claude Desktop、Windsurf和任何兼容MCP的客户端中使用真正的浏览器自动化作为工具。

设置

光标

添加 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "browserbeam": {
      "command": "npx",
      "args": ["-y", "@browserbeam/mcp-server"],
      "env": {
        "BROWSERBEAM_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "browserbeam": {
      "command": "npx",
      "args": ["-y", "@browserbeam/mcp-server"],
      "env": {
        "BROWSERBEAM_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "browserbeam": {
      "command": "npx",
      "args": ["-y", "@browserbeam/mcp-server"],
      "env": {
        "BROWSERBEAM_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

可用工具

页面地图和完整模式

第一 observe 在每个会话中，auto都包含一个 页面地图 --带有CSS选择器和内容提示的页面部分（导航、页眉、main、aside、页脚）的轻量级大纲。这让代理可以在不花费令牌的情况下发现页面上主内容区域之外的内容。

从以下位置获取内容 全部 页面部分，而不仅仅是主区域，使用 mode: "full":

{
  "tool": "browserbeam_observe",
  "params": {
    "session_id": "ses_abc123",
    "mode": "full",
    "max_text_length": 20000
  }
}

响应按部分组织内容：

## [nav]
Home | Products | About | Contact

## [main]
# Welcome to Our Site
...main content...

## [aside]
Related links, sidebar widgets...

## [footer]
© 2026 Company | Privacy | Terms

使用 include_page_map: true 重新请求后续观察的页面地图。

代理

默认情况下，所有会话都使用数据中心代理（从URL的TLD自动检测国家）。要自定义，请通过 proxy_kind 和 proxy_country 到 browserbeam_create_session:

{
  "tool": "browserbeam_create_session",
  "params": {
    "url": "https://example.com",
    "proxy_kind": "residential",
    "proxy_country": "us"
  }
}

AI驱动的选择器

使用 ai >> 提取模式中的前缀，用简单的英语描述字段。引擎通过AI将它们解析为CSS选择器并缓存结果：

{
  "tool": "browserbeam_extract",
  "params": {
    "session_id": "ses_abc123",
    "schema": {
      "_parent": "article.product_pod",
      "name": "ai >> the product title",
      "price": "ai >> the price including currency symbol"
    }
  }
}

代理指南（适用于AI客户端）

• 结束会话： 代理商应致电 browserbeam_close 当会话结束时，释放资源并停止信用消费。仅当用户明确需要在同一浏览器上继续工作时，才保持会话打开。
• 页面发现： 第一台观察车包括 map.使用前请检查 mode: "full" --如果你需要的信息在主内容中，默认模式更具令牌效率。
• 全模式： 使用 mode: "full" 当您需要不在主区域中的侧边栏内容、页脚链接或导航项时。默认 max_text_length 完整模式为20000个字符。
• 截断： 默认情况下，页面标记上限为 12,000 人物(browserbeam_observe 以及来自的页面有效载荷 browserbeam_create_session / browserbeam_navigate).如果输出被截断，请使用 browserbeam_observe 随着更高 max_text_length 或 browserbeam_scroll_collect （默认值 100,000 字符）用于长或延迟加载的页面。

运作原理

MCP服务器将工具调用转换为Browserbeam API请求。您的AI代理看到的是结构化页面数据（markdown内容、交互式元素引用、更改差异），而不是原始HTML。

AI Agent → MCP Tool Call → Browserbeam API → Real Browser → Structured Response → AI Agent

环境变量

获取API密钥

注册地址： 浏览 --5000个免费信用点，无需信用卡。

许可证

麻省理工学院