warterbili/perimeterx_reverse/cdp

Claude Code and agent skill by warterbili/perimeterx_reverse

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

通过 CDP（Chrome DevTools Protocol）控制真实 Chrome 浏览器进行网页操作、逆向分析和资料搜索。无 webdriver 特征，不触发反爬虫。适用场景：(1) 网站逆向分析（抓 API、分析 JS、拦截网络请求）；(2) 网页搜索和信息采集；(3) 需要绕过 bot 检测的网页自动化；(4) 分析 XHR/Fetch/WebSocket 流量；(5) 任何需要真实浏览器访问网站的任务。优先于 web_search、web_fetch 和 browser 工具使用。

Install

npx vskill@latest install warterbili/perimeterx_reverse/cdp

SKILL.md

The same SKILL.md was published earlier as warterbili/perimeterx_re/cdp.

CDP Browser Skill

用真实 Chrome + CDP 协议控制浏览器，无 webdriver 注入，无 bot 特征。

核心脚本

scripts/cdp.py — 所有操作的入口。先读取该脚本了解 API，再按需调用。

快速使用

1. 启动 Chrome + 连接
bash
# 启动 Chrome（如未运行）
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py start
 
# 检查状态
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py status
2. 常用操作（exec 直接运行）
bash
# 导航到网页
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py navigate "https://example.com"
 
# 截图（保存到 workspace）
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py screenshot "/path/to/save.png"
 
# 获取页面 HTML
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py html
 
# 执行 JS
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py eval "document.title"
 
# 抓取网络请求（监听 N 秒）
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py network 10
 
# 点击元素（CSS selector）
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py click "#submit-btn"
 
# 输入文字
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py type "#search-input" "关键词"
 
# 滚动页面
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py scroll 0 500
 
# 等待元素出现
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py wait ".result-list" 10
 
# 获取 Cookies
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py cookies
 
# 停止 Chrome
python3 ~/.claude/skills/cdp-browser/scripts/cdp.py stop
3. Python 脚本内嵌使用

对于复杂流程，直接写 Python 脚本调用 CDPClient：

python
import asyncio, sys
sys.path.insert(0, '/Users/linusgao/.openclaw/skills/cdp-browser/scripts')
from cdp import CDPClient, launch_chrome, get_tabs
async def main():
    launch_chrome()  # 如果没启动则启动
    tabs = get_tabs()
    async with CDPClient(tabs[0]['webSocketDebuggerUrl']) as cdp:
        await cdp.navigate('https://example.com')
        await cdp.wait_for_selector('.content')
        html = await cdp.get_html()
        requests = await cdp.capture_network(5)
        print(requests)
asyncio.run(main())

逆向分析工作流

  1. navigate 到目标网站
  2. network 监听请求，找 API 端点
  3. eval 执行 JS 分析页面变量、全局对象
  4. html 获取完整 DOM
  5. 用 screenshot 记录页面状态

详细逆向技巧见 references/reverse-tips.md。

⚡ 推荐替代：agent-browser native 模式

agent-browser 的 --native 模式是更轻量的纯 Rust CDP 方案，适合逆向分析场景：

bash
# 必须用 env var 启动（--native flag 有 bug，daemon 已运行时会被忽略）
export AGENT_BROWSER_NATIVE=1
 
# 打开页面
agent-browser open https://example.com
 
# 捕获网络请求（推荐两步走）
agent-browser network requests --clear
agent-browser open https://target.com
sleep 2
agent-browser network requests
 
# 截图
agent-browser screenshot --output /path/to/save.png
 
# 执行 JS
agent-browser eval "document.title"
 
# 获取 HTML
agent-browser html
 
# 停止 daemon
pkill -f agent-browser

对比 cdp.py 脚本的优势：

  • 无需 Node.js/Playwright，纯 Rust，更快启动
  • 网络请求捕获更干净（直接 CDP）
  • 支持 Chromium + Safari（不支持 Firefox/WebKit）

两步网络捕获原因： native daemon 只记录打开后的请求，需先 --clear 再 open。

技术说明

  • Chrome 进程：使用用户独立 profile（默认 tempfile.gettempdir() / chrome-cdp-profile，

即 macOS/Linux 走 /tmp/...，Windows 走 %TEMP%\...），与正常浏览器隔离。 可通过 CHROME_PROFILE env 覆盖。

  • Chrome 二进制：按 sys.platform 自动检测
  • macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
  • Windows: C:\Program Files\Google\Chrome\Application\chrome.exe
  • Linux: /usr/bin/google-chrome / /usr/bin/chromium 等

可通过 CHROME_BIN env 覆盖。

  • CDP 端口：localhost:9222
  • 依赖：Python 3 标准库 + websockets（已安装）
  • 无 Playwright/Selenium，无 webdriver 特征

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/warterbili/perimeterx_reverse/cdp/badge)](https://verified-skill.com/skills/warterbili/perimeterx_reverse/cdp)

Something wrong with this skill or its page? Tell us.