openbrowser (Buildingopen)

打开浏览器

openbrowser.buildingopen.org

给AI你的浏览器。 查看电子邮件、查看PR、阅读LinkedIn消息、搜索谷歌、查看日历——所有这些都可以在一个设置中完成。没有API密钥。没有OAuth。没有每个服务配置。

登录Chrome一次，Claude、Cursor等人工智能工具就可以像你一样浏览网页。

npx openbrowser setup     # One-time setup (~2 min)
npx openbrowser login     # Log into Google, GitHub, LinkedIn
npx openbrowser inbox     # AI reads your unread emails

macOS+Linux。 独立工作或作为Claude、Cursor和其他AI工具的MCP服务器。

______________________________________________________________________

安装

npm install -g openbrowser-ai

或直接使用：

npx openbrowser-ai 

两者 openbrowser 和 openbrowser-ai 作为CLI名称工作。

快速开始

# 1. Set up OpenBrowser (~2 min, one time)
openbrowser setup

# 2. Log into your accounts
openbrowser login

# 3. See which accounts are connected
openbrowser status

# 4. Try it out
openbrowser inbox                   # Read your unread emails
openbrowser prs                     # Check your open pull requests
openbrowser calendar                # See today's meetings and events
openbrowser search "AI agent frameworks 2026"

你的AI能做什么

openbrowser inbox                    # Read your unread emails
openbrowser prs                      # Check your open pull requests
openbrowser calendar                 # See today's meetings and events
openbrowser search "your query"      # Search Google as you
openbrowser issues                   # Check issues assigned to you
openbrowser notifications            # Read your GitHub notifications
openbrowser linkedin                 # See your LinkedIn notifications
openbrowser profile                  # Get your LinkedIn profile
openbrowser messages                 # Read your LinkedIn messages
openbrowser recipe list              # See all 9 recipes

默认情况下，所有食谱都通过浏览器工作。9中的6个也有更快的API路径，无需浏览器即可工作（GitHub通过令牌，Gmail通过IMAP，日历通过API）。看 API首次设置 了解详情。

命令

openbrowser setup      # One-time setup (~2 min)
openbrowser login      # Log into your accounts
openbrowser status     # See which accounts are connected
openbrowser start      # Start the browser
openbrowser stop       # Stop the browser
openbrowser restart    # Restart the browser
openbrowser doctor     # Diagnose connection issues

连接到AI工具

OpenBrowser内置了MCP服务器，因此AI工具可以直接使用您的浏览器。

将此添加到您的Claude Desktop设置中：

{
  "mcpServers": {
    "openbrowser": {
      "command": "npx",
      "args": ["openbrowser-ai", "mcp"]
    }
  }
}

MCP服务器提供31个工具：会话管理、完全浏览器控制和所有9个配方。

运作原理

OpenBrowser让Chrome在后台与您的真实登录会话一起运行。当你的AI需要检查电子邮件或查看PR时，它会连接到该浏览器并像你一样浏览。

1. 设置 将Chrome安装为自动启动的后台进程
2. 登录 打开Chrome浏览器，以便您可以正常登录您的帐户
3. 会话持续 跨重启--无需再次登录
4. 食谱 连接到正在运行的浏览器，打开页面并提取结构化数据
5. MCP服务器 使AI工具可以直接访问会话、浏览器控制和食谱

需求

• Node.js>=22.6
• 谷歌Chrome或Chromium
• macOS或Linux（不支持Windows）

______________________________________________________________________

高级

API-首次设置（可选）

如果你设置了环境变量，9个食谱中有6个可以完全跳过浏览器。这更快，适用于没有显示器的机器。

GitHub （pr、问题、通知）：

gh auth login              # easiest
# or: export GITHUB_TOKEN="ghp_..."

Gmail （收件箱）：

export GMAIL_USER="you@gmail.com"
export GMAIL_APP_PASSWORD="xxxx xxxx xxxx xxxx"

Google 日历 （日历）：

export GOOGLE_ACCESS_TOKEN="ya29...."
# or: export GOOGLE_CALENDAR_API_KEY="AIza..."

自定义帐户

跟踪内置Google/GitHub/Linkin之外的会话：

openbrowser domain add slack.com d lc --label Slack
openbrowser domain list
openbrowser domain remove slack.com

输出格式

所有命令支持 --format json|text默认值：交互时为文本（TTY），管道时为JSON。

{
  "command": "recipe:prs",
  "version": "0.4.0",
  "timestamp": "2026-03-03T00:00:00.000Z",
  "success": true,
  "data": { "prs": [...], "total": 1 },
  "summary": "1 open PR"
}

程序化API（SDK）

import { OpenBrowser } from 'openbrowser-ai';

const ob = new OpenBrowser();
const status = await ob.getStatus();
const prs = await ob.runRecipe('prs');
const browser = await ob.connect(); // Direct Playwright CDP handle

配置

配置文件： ~/.openbrowser/config.json

{
  "cdpPort": 9222,
  "profileDir": "~/.openbrowser/chrome-profile",
  "timezone": "Europe/Berlin"
}

Linux无头

在无头Linux服务器上， openbrowser login 使用带有VNC的虚拟显示器，以便您可以远程登录。需要 xvfb 和 x11vnc:

apt install xvfb x11vnc

许可证

麻省理工学院