打开浏览器
给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 emailsmacOS+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时，它会连接到该浏览器并像你一样浏览。
- 设置 将Chrome安装为自动启动的后台进程
- 登录 打开Chrome浏览器，以便您可以正常登录您的帐户
- 会话持续 跨重启--无需再次登录
- 食谱 连接到正在运行的浏览器，打开页面并提取结构化数据
- 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许可证
麻省理工学院