【教程】使用PlayWright官方浏览器插件替代灵犀浏览器助手

一、前言

目前，在灵犀专业版中，我们可以通过开启浏览器连接器，安装灵犀浏览器助手、调用官方内置的Browser技能，来执行浏览器自动化任务。它能让灵犀能操控你正在用的 Edge/Chrome，保留登录态、看得见操作过程。但它有几个先天限制：

1. 闭源：代码不公开，无法审计，无法定制。

2. 绑定灵犀：整套浏览器能力深度绑定灵犀运行时，换一个 Agent 平台就用不了。在灵犀中使用，未来还有可能会消耗灵点。

3. 权限单一：只有「操作 / 不操作」二元选择，缺少精细授权。

4. 多 Agent 不友好：直接操作用户标签页，多个 Agent 或人机同时用容易互相干扰。

而 PlayWright 官方浏览器插件（Playwright Extension）能实现几乎一样的能力——复用登录态、操作用户已有标签页、可见透明——而且是开源、通用、可审计的。一次装好，不管用灵犀、Cursor、Claude Code 还是自己写的脚本，都能通过标准接口调用。

✅ 复用登录态、操作用户浏览器、可见透明 —— 核心体验和灵犀浏览器助手一致

✅ 开源可审计、不绑定任何 Agent、一次安装到处用

✅ playwright-cli 一条命令连上 Edge，非常省事

官方教程：Chrome 扩展 | Playwright

官方仓库：playwright/packages/extension，主分支 · microsoft/playwright

下面教你如何用 PlayWright 官方浏览器插件，替代灵犀浏览器助手，实现「操控本地已登录的 Edge」。不想看详细解析的，请拉到底部，阅读“七、最简便的操作方式“即可。

二、技术原理

PlayWright 官方扩展模式和灵犀浏览器助手的思路完全一致：

Agent（灵犀/CLI/MCP）→ 本地通道 → Playwright 浏览器插件 → 你的 Edge 标签页

• 插件装在 Edge/Chrome 里，通过 chrome.debugger 在你已有的标签页上执行操作。

• 因为连的是你正在用的浏览器，所以登录态、Cookie、已装扩展全部保留。

• 操作在你可见的浏览器窗口进行，透明可控。

对比「不用扩展（CDP 直连）」：

在使用CDP模式连接本地带登录态的Edge浏览器，会频繁弹出提示框，让用户对远程调试模式进行授权，而在使用extension时将不会弹出此类提示框，体验更好、更流畅，而且可以实现AI全程自动化、无需人工授权和监守。

一句话总结：要复用登录态、操作用户的浏览器，就用扩展模式；要独立、可复现的自动化，才用 CDP 直连。

三、准备工作（装插件 + 拿 Token）

安装 Playwright 官方扩展

在Chrome Webstore搜索安装Playwright Extension：https://chromewebstore.google.com/detail/mmlmfjhmonkocbjadbfplnigmagldckm

安装后，浏览器右上角会出现 Playwright 图标。

获取并配置 Token

扩展和 Agent 之间需要一对 Token 来握手。

# Windows（PowerShell / cmd）永久设置环境变量
setx PLAYWRIGHT_MCP_EXTENSION_TOKEN 你的Token

确认扩展已装好

# 检查 Edge 用户数据目录下是否出现该扩展
dir "$env:LOCALAPPDATA\Microsoft\Edge\User Data\Default\Extensions\mmlmfjhmonkocbjadbfplnigmagldckm"

四、具体操作

方式一：用 playwright-cli（命令行，最省事）

playwright-cli 的扩展模式自动识别 Edge，一行命令就能连上，无需指定任何路径。

# 通过扩展模式连接运行中的 Edge
playwright-cli attach --extension=msedge

# 连接成功后，后续操作指定会话 msedge
playwright-cli --s=msedge goto https://bbs.wps.cn
playwright-cli --s=msedge eval "() => document.title"

实测演示：打开 bbs.wps.cn 抓首页标题

playwright-cli attach --extension=msedge
playwright-cli --s=msedge goto https://bbs.wps.cn

# 抓取首页帖子标题（筛选 href 含 /topic/ 的链接）
playwright-cli --s=msedge eval "() => {
  const t = [];
  document.querySelectorAll('a').forEach(a => {
    const tx = (a.innerText||'').trim();
    if (tx && tx.length>4 && a.href.includes('/topic/')) t.push(tx);
  });
  return JSON.stringify(t.slice(0,30), null, 2);
}"

方式二：用 playwright-mcp（MCP 协议，供 Agent 调用）

playwright-mcp 是 MCP 服务，适合灵犀、Cursor 等 Agent 通过标准 MCP 接口调用。注意：playwright-mcp 的扩展模式默认找 Chrome，连 Edge 必须显式指定路径，这是最容易踩的坑。

在项目 config/mcporter.json 注册（连 Edge）

{
  "mcpServers": {
    "playwright-mcp": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--extension",
        "--executable-path=C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
        "--user-data-dir=C:\\Users\\你的用户名\\AppData\\Local\\Microsoft\\Edge\\User Data"
      ]
    }
  }
}

关键点：

• --extension：启用扩展模式

• --executable-path：指向 Edge 可执行文件（不指定会默认找 Chrome，报 Playwright Extension not found in ...Chrome\User Data）

• --user-data-dir：指向 Edge 用户数据目录（内含已装的 Playwright 扩展）

调用（mcporter 示例）

# 列出标签页，验证已连上你的 Edge
mcporter call playwright-mcp.browser_tabs --args '{"action":"list"}' --timeout 60000

# 打开 bbs.wps.cn
mcporter call playwright-mcp.browser_navigate --args '{"url":"https://bbs.wps.cn"}' --timeout 60000

# 抓首页标题
mcporter call playwright-mcp.browser_evaluate --args '{"function":"() => { const t = []; document.querySelectorAll(\"a\").forEach(a => { const tx = (a.innerText||\"\").trim(); if (tx && tx.length>4 && a.href.includes(\"/topic/\")) t.push(tx); }); return JSON.stringify(t.slice(0,30), null, 2); }"}' --timeout 60000

无论是方式一还是方式二，在整个操作过程中，Edge 窗口可见，登录态保留，和用灵犀浏览器助手几乎无差别。

五、常见问题

六、什么时候不建议用它替代？

• 需要独立、可复现的自动化（测试、CI/CD、批量无头抓取）：用 Playwright 独立浏览器或 CDP 直连更合适。

• 需要 Agent 隔离窗口：PlayWright 官方插件没有独立的 Agent Window（会和你共用标签页）。若需要强隔离 + 精细授权，可关注腾讯开源的 BrowserSkill（有 Agent Window + Borrow 授权机制），推荐使用 BrowserSkill。

七、最简便的操作方式

更简单的操作方式是在灵犀中安装微软官方的playwright-cli技能：https://github.com/microsoft/playwright-cli/tree/main/skills/playwright-cli，并让灵犀在记忆中添加规则：在使用playwright-cli或playwright-mcp连接本地带登录态的Edge浏览器时，优先使用扩展模式，在检测到浏览器扩展未安装或者扩展模式失败时再使用--cdp=msedge。