前言¶

讓 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