用途:在 Claude Code 会话中驱动正在运行的 Rever Browser 应用,帮用户从网页获取所需内容。默认以 DOM 优先方式直接操作浏览器(导航、输入、点击),从渲染后的 DOM 读取结果;当任务确实需要时,可切换到 API 逆向模式(读取捕获流量、解码令牌、hook 脚本、生成可复现的客户端代码)。全部能力通过约 140 个 MCP 工具暴露。
前提:Rever Browser 应用必须正在运行,启动时会把 MCP 端点发布到 ~/Library/Application Support/rever-browser/mcp-endpoint.json。端口由系统分配、每次启动都会变化,必须从该文件解析;文件缺失时应提示用户先启动 Rever Browser。
连接方式:首选注册为原生 MCP 工具(工具名形如 mcp__rever__*): claude mcp add --transport http rever "$(python3 -c "import json,os;print(json.load(open(os.path.expanduser('~/Library/Application Support/rever-browser/mcp-endpoint.json')))['url'])")" Rever Browser 每次重启后需重新执行(端口会变)。MCP 服务器在会话启动时加载,若工具尚不可见,请新开一个 claude 会话。也可不注册直接调用:技能自带 rever.py 辅助脚本,每次调用都会重新解析端点,当前会话即可使用,例如 python3 <this-skill-dir>/rever.py --list、python3 <this-skill-dir>/rever.py browser_navigate '{"url":"https://example.com"}'、python3 <this-skill-dir>/rever.py list_requests。
主要能力(工具分组):浏览器控制(browser_navigate、browser_snapshot、browser_click/browser_type/browser_scroll、browser_click_selector/browser_type_selector、browser_wait_for、browser_screenshot、browser_evaluate、vision_judge、set_viewport、browser_tabs);DOM 读取(dom_extract、browser_evaluate 只读);流量(list_requests、get_request、get_request_initiator、request_diff、find_api_base、fetch_body、har_export、replay_request);打包分析(list_scripts、grep_script/grep_scripts、extract_context、detect_bundler、deobfuscate_script/deob_auto、get_original_source、list_sources、resolve_source);认证与加密(auth_dump、decode_token、protobuf_decode、crypto_trace_start/list/stop、crypto_chain、hmac_compute、hash_iter、scan_secrets);复现与模糊测试(repeater_send、replay_request、graphql_introspect、burst_send、intruder_run、crlf_test、lfi_probe、path_probe、payload_probe、create_macro/export_python_client);拦截与覆盖(intercept_add/pending/continue/fulfill/fail/remove、override_add/list/remove、inject_run_now/add/toggle/remove、header_preset_save/apply/disable);调试器(bp_add、bp_eval_in_frame、bp_step_、bp_resume、bp_status);控制台/存储/Cookie(console_logs/eval/exceptions、cookie_list/set/delete、local_storage_、session_storage_*、sw_list/unregister/caches);WebSocket(list_websockets、get_ws_frames、ws_send);发现(finding_add、finding_list、finding_export、security_inspect)。运行 --list 可查看完整当前工具集。
使用策略:默认 DOM 优先,先驱动页面到所需状态,再从渲染 DOM 读取结果;只有用户明确要求分析 API、或 DOM 方式确实无法达成目标(跨分页批量采集、程序化复现认证调用、数据仅存在于 XHR/Fetch JSON 中)时才切换到 API 逆向模式。交互必须用 browser_click/browser_type 或 _selector 版本,禁止用 browser_evaluate 里的 el.click()、el.value=…、dispatchEvent 等原始 JS 点击或赋值。遇到 SSR 站点不要因没有 JSON API 而停下,直接 dom_extract 渲染结果。请求含糊时先查看(browser_snapshot、list_requests({since})、console_exceptions())再决定是否提问。list_requests 要加 host/since/methodOrType/limit 过滤,避免无过滤转储。
限制与注意:驱动的是用户真实已登录会话,任何有副作用的操作(重放非 GET 请求、交付非幂等客户端、主动探测如 intruder_run/burst_send/payload_probe/crlf_test/path_probe/lfi_probe)前须说明将发生什么、作用于哪个目标并等待用户确认;只读侦察无需此门槛。不要自动化登录 Instagram、X 等有机器人检测的站点。任务结束后应移除或关闭注入、拦截、断点、覆盖等 hook,恢复暂停的请求。输出中必须遮蔽完整令牌、Cookie、密码、卡号、身份证号。复现签名/加密请求时遵循“首个分歧点”原则,不得报告“几乎可用”。交付物默认放在临时工作目录,不要擅自散落到用户项目。
故障排查:提示“No MCP endpoint found”说明 Rever Browser 未运行,需启动应用;claude mcp add 后工具缺失需新开会话或改用 rever.py;连接被拒或过期说明 Rever 重启后端口已变,需重新执行连接命令。