Huashu Chrome

huashu-chrome

**让任何 AI agent 操控你自己的 Chrome——带着你全部的登录态。**

Claude Code、Codex CLI、Cursor、Gemini CLI、Cline、Windsurf 通用。一个 MCP server + 一个 Chrome 扩展。

你：帮我把这份 CSV 里的 30 条客户信息录进 CRM
agent：（打开你已登录的 CRM，逐条填表提交）

不用 API key，不用重新登录，不用处理验证码——用的就是你此刻这个浏览器里的身份。

为什么需要它

浏览器控制这件事，现在的格局是：

	能拿到你的真实登录态吗	终端 agent 能用吗
Claude in Chrome	✅	仅限 Anthropic 直订用户，API key / Bedrock 用户被禁用
Codex for Chrome	✅	❌ 只有 app UI 能用，CLI 至今拿不到扩展后端
chrome-devtools-mcp	❌ Chrome 136 起封了默认 profile 的远程调试	✅
huashu-chrome	✅	✅ 任何支持 MCP 的 agent

安装

npx huashu-chrome install

一条命令：自动检测这台机器上装了哪些 agent、写好各自的 MCP 配置（动手前先备份， 已配过的自动跳过），然后弹出引导页带你装扩展——**装扩展这一下必须你自己点， 浏览器不允许脚本代劳**。

**它认得出哪些 agent**，分三层：

1. 已知表 —— src/agents.json 列了 20 个：Claude Code、Codex CLI、Cursor、 Gemini CLI、Windsurf、Cline、Roo Code、Claude Desktop，以及 WorkBuddy、CodeBuddy、 Kimi Code、通义灵码、MiniMax Mavis、Trae、豆包、千问 / Qwen Code、Qoder、 DeepSeek、iFlow、OpenClaw。加一个只要往数组里加一行，不用改代码 —— 欢迎 PR。
2. 自动发现 —— 没列出来的也能认出来。install 会扫 home 下的点目录， 凡是内容里有 mcpServers 的配置文件都算数。实测所有主流产品都守这个惯例 （Codex 的 TOML 是唯一异类），所以下个月新冒出来的 agent 不用等更新也能配上。
3. 都不匹配 —— 打印该填的 JSON，你自己贴。

Windows / macOS / Linux 的配置路径都已适配。

装完验证：

npx huashu-chrome doctor

看到「握手正常 · Chrome 扩展在线」就成了。桥进程由 agent 首次调用时自动拉起， 你不用手动开任何东西。

手动配置（不想让 install 碰你的配置文件）

**Claude Code**

claude mcp add huashu-chrome -- npx -y huashu-chrome mcp --client claude-code

**Codex CLI** — `~/.codex/config.toml`

[mcp_servers.huashu-chrome]
command = "npx"
args = ["-y", "huashu-chrome", "mcp", "--client", "codex"]

**Cursor / Gemini CLI / Windsurf / Claude Desktop** — 各自的 JSON 配置里加：

{ "mcpServers": { "huashu-chrome": { "command": "npx", "args": ["-y", "huashu-chrome", "mcp"] } } }

扩展：`npx huashu-chrome extension` 打印目录，然后 `chrome://extensions` → 开发者模式 → 加载已解压的扩展程序。

工具：按「网页只有三种信息载体」来分

不是一堆平铺的功能，是三层。这个分层决定了 agent 面对陌生网站时按什么顺序出牌， 完