mcpField
S
setup-browser-cookies

setup-browser-cookies

github.com/topshark-jim测试与质量048 次安装33 周前更新
代码仓库

关于 setup-browser-cookies

将 Chromium 浏览器中选定的登录 Cookie 导入无头 Playwright 浏览会话的技能。它通过交互式选择器指定域名，也支持直接导入指定域名。

主要功能

  1. 01检测已安装的 Chromium 浏览器
  2. 02在选择器中选择 Cookie 域名
  3. 03将 Cookie 导入 Playwright
  4. 04直接导入指定域名
  5. 05核对已导入的 Cookie 数量

适用场景

  1. 01在无头会话中复用浏览器登录状态
  2. 02选择要导入 Cookie 的域名
  3. 03导入指定域名的 Cookie
  4. 04查看已导入域名及 Cookie 数量

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/topshark-jim/gstack --skill setup-browser-cookies

安装后在 Claude Code 中输入/setup-browser-cookies确认已加载。

详细介绍

运行时注意事项

  • 如果工作流要求暂停并等待输入，请直接询问用户。
  • 将 AGENTS.md、TODO.md 和 TODOS.md 视为仓库本地说明的可能来源。
  • 保持工作流意图不变，但将任何特定于环境的措辞调整为当前工具集。

设置浏览器 Cookie

将真实 Chromium 浏览器中的已登录会话导入无头浏览会话。

工作原理

  1. 查找浏览二进制文件
  2. 运行 cookie-import-browser，检测已安装的浏览器并打开选择器界面
  3. 用户在浏览器中选择要导入 Cookie 的域名
  4. 解密 Cookie 并将其加载到 Playwright 会话中

步骤

1. 查找浏览二进制文件
B=$(browse/bin/find-browse 2>/dev/null || ~/.codex/skills/gstack/browse/bin/find-browse 2>/dev/null)
if [ -n "$B" ]; then
  echo "READY: $B"
else
  echo "NEEDS_SETUP"
fi

如果为 NEEDS_SETUP：

  1. 告诉用户：“gstack browse 需要进行一次性构建（约 10 秒）。可以继续吗？”然后停止并等待。
  2. 运行：cd <SKILL_DIR> && ./setup
  3. 如果未安装 bun：curl -fsSL https://bun.sh/install | bash
2. 打开 Cookie 选择器
$B cookie-import-browser

此操作会自动检测已安装的 Chromium 浏览器（Comet、Chrome、Arc、Brave、Edge），并在默认浏览器中打开交互式选择器界面，你可以在其中：

  • 在已安装的浏览器之间切换
  • 搜索域名
  • 点击“+”导入某个域名的 Cookie
  • 点击垃圾桶图标移除已导入的 Cookie

告诉用户：“Cookie 选择器已打开——请在浏览器中选择要导入的域名，然后告诉我你何时完成。”

3. 直接导入（替代方式）

如果用户直接指定域名（例如，setup-browser-cookies github.com），则跳过界面：

$B cookie-import-browser comet --domain github.com

如果用户指定了浏览器，请将 comet 替换为相应的浏览器。

4. 验证

用户确认完成后：

$B cookies

向用户显示已导入 Cookie 的摘要（域名数量）。

注意事项

  • 每个浏览器首次导入时可能会触发 macOS Keychain 对话框——点击“允许”/“始终允许”
  • Cookie 选择器与浏览服务使用相同的端口（无需额外进程）
  • 界面仅显示域名和 Cookie 数量，不会暴露 Cookie 值
  • 浏览会话会在命令之间保留 Cookie，因此导入的 Cookie 可立即使用

评论

支持 Markdown