前言¶

让 Agent 操作国内内容平台时，常见卡点不是「不会写脚本」，而是登录：扫码、验证码、风控会把自动化拦在门外。每次任务都重新登录，成本高，也很难稳定复现。

下面介绍 SkillHub 社区 Skill「浏览器免登录神器」（坐标 @user_7850d9d3/chrome-debug-login）。它的思路不是替你在代码里过验证码，而是单独起一个带调试端口的 Chrome，由你手动登录一次，把 Cookie 落在独立用户数据目录里，再由 Agent 通过 Chrome DevTools Protocol（CDP）操控同一浏览器实例，从而复用已登录状态。

这是什么¶

一句话定位： 面向 Agent 的 Chrome 远程调试与登录态持久化操作指南（通用 SKILL.md 格式）。

出品与来源： 由社区用户 user_7850d9d3 发布，来源标注为 community；SkillHub 分类为 life-service，当前版本 1.0.0。官方简介为：「一次登录终身免登录。」页面标签显示 requires_api_key=false，无需额外 API Key。

SkillHub 页面数据（以抓取为准）： 评分 100000，下载 3044 次，安装计数 0。

解决什么问题： 在真实 Chrome（非无头）里完成人工登录后，将登录态写入磁盘；Agent 通过 localhost 上的调试端口列出标签页、执行 JavaScript、读写 Cookie 等，减少反复扫码与自动化登录适配。

核心功能¶

以下能力均来自该 Skill 的 SKILL.md 正文，可按步骤复现。

1. 独立用户数据目录
   与日常主力 Chrome 隔离，避免调试配置与主配置冲突，并降低调试端口暴露下的账号混用风险。

2. 以调试模式启动 Chrome
   使用 --remote-debugging-port=9222、--remote-allow-origins=*（Chrome 128+ 连接 CDP 时常需要）、--user-data-dir 指向独立目录。支持 Windows 快捷方式、命令行或批处理自启。

3. 端口与健康检查
   通过 curl http://localhost:9222/json/version 确认调试端口可用；通过 /json 查看标签页列表。

4. 人工登录与持久化验证
   在调试浏览器中打开目标站点并手动登录；关闭后再次启动，检查是否仍保持登录态。Skill 文档说明 Cookie 存放在独立目录下的 SQLite（如 Default/Cookies），并提醒部分平台 Cookie 仍可能过期，需重新登录。

5. CDP 常用操作示例
   文档给出通过 HTTP/WebSocket 打开新标签、关闭标签、执行 Runtime.evaluate、模拟点击与填表、读取页面文本等示例（含 Python websocket 片段）。

6. 扩展新平台
   在调试浏览器中对新站点手动登录一次即可，文档称无需改代码或额外配置。

7. 安全与限制说明
   强调调试端口默认绑定 localhost、建议使用小号、以及「换机需重新搭建或迁移数据目录且不保证各平台接受」等 FAQ。

同目录下的 原理说明.md 进一步说明反爬、验证码与 CDP、独立 user-data-dir 的关系，可与主文档对照阅读。

安装与启用¶

通过 SkillHub 安装¶

SkillHub 技能页给出的安装提示为：先阅读安装说明，再安装该坐标下的 Skill。

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_7850d9d3/chrome-debug-login`。

若本机已有 skillhub CLI，可按官方安装文档将 Skill 装到当前 Agent 识别的 skills 目录（文档强调必须使用 --dir，否则默认 ./skills/ 可能不被识别）：

command -v skillhub && skillhub --version

skillhub install chrome-debug-login --namespace user_7850d9d3 --dir <你的 Agent skills 目录>

未安装 CLI 时，安装文档提供一键脚本（完整安装或仅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

各客户端 skills 目录（摘自 SkillHub 安装文档）¶

安装路径因客户端而异，常见示例如下：

• Cursor： ~/.cursor/skills/
• Claude Code： ~/.claude/skills/
• Codex： ~/.codex/skills/ 或项目下的 .agents/skills/

装好后按你所用客户端的要求重启或刷新 Agent，使 Skill 被加载。本文未单独核实 Codex CLI 与 Claude Code 的加载差异，以各自官方说明为准。

启用后的使用前提¶

Skill 本身不替代 Chrome：你需要在本机安装 Google Chrome，并按文档创建独立数据目录、用调试参数启动浏览器。Agent 是在 Skill 指导下连接已有调试实例，而不是自动替你安装浏览器。

典型用法¶

下面按 Skill 文档的四个阶段概括；具体命令以 SKILL.md 为准。

阶段一：环境搭建（一次）

1. 创建独立用户数据目录，例如 Linux：

mkdir -p ~/.config/google-chrome/调试浏览器

2. 启动 Chrome（Linux 示例）：

google-chrome --remote-debugging-port=9222 --remote-allow-origins=* --user-data-dir=~/.config/google-chrome/调试浏览器

3. 验证端口：

curl http://localhost:9222/json/version

阶段二：人工登录（每个平台至少一次）

在调试浏览器中打开目标平台，手动完成登录；可重复对多个站点操作。文档建议登录过程中尽量不随意清数据，关闭后重启 Chrome 检查登录态是否仍在。

阶段三：Agent 自动化

Agent 连接 http://localhost:9222，先 GET /json 获取标签页与 webSocketDebuggerUrl，再通过 CDP 执行页面操作。文档中的 Python 示例演示了 Network.getAllCookies 与 Runtime.evaluate 等调用方式。

阶段四：扩展平台

在新站点上重复「打开 → 手动登录 → 验证持久化」即可。

查看标签页的命令行示例：

curl http://localhost:9222/json

打开新标签页：

curl -X PUT "http://localhost:9222/json/new?https://www.baidu.com"

官方文档在文末附有「实例参考：双色映画工作室 @小蓝」的配置表（Chrome 路径、数据目录名、端口 9222、已登录平台列表等），仅作搭建参考，目录名与端口可按本机环境自定义。

适用场景与注意¶

更适合谁

• 需要 Agent 在已登录的真实浏览器里做发帖、读页、填表等操作，且能接受首次人工登录成本的开发者或工作室。
• 希望用 CDP 统一操控多标签、多平台，而不是为每个站点单独逆向接口的团队。

限制与风险

• 配置成本： 独立目录、快捷方式、端口与防火墙排查，首次搭建比 pip install 类方案更重。
• 登录态并非绝对永久： FAQ 写明部分平台 Cookie 会过期，失效后需在调试浏览器中重新登录。
• 安全： 本机任何能访问 localhost:9222 的进程都可能控制浏览器；文档建议用小号，并保持数据目录与主 Chrome 隔离。
• 合规与条款： 自动化操控第三方平台须遵守各站服务协议与当地法律；Skill 提供的是技术路径，不替代你对账号与内容合规的判断。
• Headless： 文档明确不推荐无头模式，以降低被识别为机器人的概率。

结尾¶

「浏览器免登录神器」把问题拆成两件事：人用真实 Chrome 完成一次登录并持久化 Cookie，Agent 通过 CDP 复用同一实例完成后续操作。若你正在 SkillHub 上找 life-service 类、且不需要 API Key 的浏览器登录方案，可以从官方页面与坐标 @user_7850d9d3/chrome-debug-login 入手安装 Skill，再按 SKILL.md 逐步搭调试环境。

• 官方 API 入口：https://api.skillhub.cn/user_7850d9d3/chrome-debug-login
• SkillHub 技能页：https://www.skillhub.cn/skills/user_7850d9d3/chrome-debug-login
• 安装说明：https://skillhub.cn/install/skillhub.md