Repolode
hydro13

hydro13/tandem-browser

基于 Electron 的本地优先浏览器,AI 代理可通过 MCP 或 HTTP API 在你已登录的真实会话中操作网页。

Star
623
Fork
91
未关闭 Issue
21
最近提交
前天

这是什么?

Tandem Browser 是基于 Electron 构建的桌面浏览器,把 AI 代理放进浏览器本身,而不是侧边栏聊天面板。代理与用户共享同一组标签页、Cookie 和登录会话,可以读取无障碍树与 DOM、查看实时网络日志,并向页面注入脚本。遇到验证码或风险操作等需要人工介入的步骤时,控制权会交还给用户。

代理可通过 MCP(支持 Claude Code、Claude Desktop、Cursor、Windsurf 等客户端)或 300 多个端点的 HTTP API 接入,既可以在本机运行,也可以通过 Tailscale 远程连接。多个代理可以同时在一个浏览器中工作,并通过标签锁和明确的交接机制协调。项目还设计了位于网页内容与代理之间的八层安全防护,包括域名拦截、提示注入防御和出站凭据扫描。

它同时可作为日常使用的浏览器,提供工作区、书签、历史记录、本地密码库、Chrome 扩展支持和设备模拟。目前处于开发者预览阶段,macOS Apple Silicon 为主要平台,支持 Windows 11 x64,Linux 为尽力支持。

核心功能

  • 01用户与 AI 代理共享标签页、Cookie 和登录会话。
  • 02通过 MCP 提供 257 个工具,并提供 300 多个端点的 HTTP API。
  • 03支持多个代理同时在一个浏览器中工作,配有标签锁和交接机制。
  • 04可通过 Tailscale 远程连接,浏览器不暴露于公网。
  • 05基于无障碍树生成带引用 ID 的页面快照,便于结构化操作页面。
  • 06内置八层安全模型,包括提示注入防御。

适用场景

  • 在没有公开 API 的 SaaS 工具中,借助自己已登录的会话自动完成网页任务。
  • 浏览时向网站注入自定义界面修改或用户脚本。
  • 在本地查看页面发起了哪些 API 请求及返回内容。
  • 让代理与自己同时浏览网页,并在高风险步骤上由人工确认。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/hydro13/tandem-browser.git
  2. 2

    进入项目文件夹

    cd tandem-browser
  3. 3

    安装依赖

    npm install
  4. 4

    启动 Tandem Browser

    npm start

使用前须知

  • Linux 仅为尽力支持;macOS 和 Windows 是官方支持的平台。
  • 预编译的 macOS 版本需要 Apple Silicon(M1 或更新)芯片。
  • Windows 版本尚未签名,安装时可能出现未知发布者或 SmartScreen 警告。
  • 远程代理访问要求两台机器处于同一个 Tailscale 网络中。

标签

常见问题

tandem-browser 是什么?
基于 Electron 的本地优先浏览器,AI 代理可通过 MCP 或 HTTP API 在你已登录的真实会话中操作网页。 Tandem Browser 是基于 Electron 构建的桌面浏览器,把 AI 代理放进浏览器本身,而不是侧边栏聊天面板。代理与用户共享同一组标签页、Cookie 和登录会话,可以读取无障碍树与 DOM、查看实时网络日志,并向页面注入脚本。遇到验证码或风险操作等需要人工介入的步骤时,控制权会交还给用户。
tandem-browser 可以免费使用吗?用的什么许可证?
tandem-browser 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
tandem-browser 还在维护吗?
活跃维护中。tandem-browser 最近一次提交是在 2026年10月18日。
tandem-browser 适合用来做什么?
在没有公开 API 的 SaaS 工具中,借助自己已登录的会话自动完成网页任务。 浏览时向网站注入自定义界面修改或用户脚本。 在本地查看页面发起了哪些 API 请求及返回内容。 让代理与自己同时浏览网页,并在高风险步骤上由人工确认。
tandem-browser 怎么安装和运行?
克隆仓库: git clone https://github.com/hydro13/tandem-browser.git 进入项目文件夹: cd tandem-browser 安装依赖: npm install 启动 Tandem Browser: npm start
在哪里获取 tandem-browser?
源代码和安装说明在 GitHub 上:https://github.com/hydro13/tandem-browser

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目