Skip to content

Latest commit

 

History

History
1021 lines (654 loc) · 27.3 KB

tool-reference.md

File metadata and controls

1021 lines (654 loc) · 27.3 KB

Chrome DevTools MCP Tool Reference

快速按逆向目标查工具,请先看:reverse-task-index.md

Navigation automation

click — 点击元素

Description: 点击页面元素,支持单击与双击。支持由 take_snapshot 产生的 uid(推荐)或传统定位器(CSS、role=、text=、xpath=)。

Parameters:

  • uid
  • selector
  • dblClick
  • timeoutMs

click_at — 坐标点击

Description: 使用 CDP Input.dispatchMouseEvent 在元素中心坐标处派发真实鼠标点击事件,适用于 Playwright 点击被拦截的场景。会选取元素在视口内的最大可见区域中心。

Parameters:

  • selector

drag — 拖拽元素

Description: 通过鼠标事件将元素从源定位器拖拽到目标定位器。定位器支持 CSS、role=、text=、xpath=。多匹配时用 >> nth=N 消歧。

Parameters:

  • fromSelector
  • toSelector

fill — 填充输入

Description: 向输入元素填入值, 会通过 selectOption 自动处理。支持由 take_snapshot 产生的 uid(推荐)或传统定位器(CSS、role=、text=、xpath=)。 Parameters: uid selector value timeoutMs fill_form — 批量填充表单 Description: 在一次调用中批量填充多个表单元素,每个条目指定定位器与值, 通过 selectOption 自动处理。定位器支持 CSS、role=、text=、xpath=。多匹配时用 >> nth=N 消歧。

Parameters:

  • elements
  • timeoutMs

find_clickable_elements — 查找可点击元素

Description: 查找当前页面中可点击的按钮与链接,可按文本内容过滤,返回选择器、文本、类型、可见性与包围盒。

Parameters:

  • filterText

get_dom_structure — 获取DOM结构

Description: 获取当前页面的 DOM 树结构,返回包含标签名、ID、类名及可选文本内容的层级树。

Parameters:

  • maxDepth
  • includeText

hover — 悬停元素

Description: 将鼠标悬停在指定元素上。支持由 take_snapshot 产生的 uid(推荐)或传统定位器(CSS、role=、text=、xpath=)。

Parameters:

  • uid
  • selector

list_pages — 列出页面

Description: 列出浏览器中所有已打开的页面及其索引、URL 与标题。在调用 select_page 前可先使用本工具查找页面索引。

navigate_page — 导航页面

Description: 导航当前页面,支持 URL 导航、后退、前进与刷新,等待 DOMContentLoaded 事件。

Parameters:

  • type
  • url
  • ignoreCache
  • timeout

new_page — 新建页面

Description: 创建新的浏览器页面并导航到指定 URL,新页面会自动被选中。

Parameters:

  • url
  • timeout
  • preloadHook
  • preloadPreset

press_key — 按键

Description: 按下键盘按键或组合键(如 "Enter"、"Control+A"、"Alt+Shift+F"),支持修饰键。

Parameters:

  • key

query_dom — 查询DOM元素

Description: 通过定位器查询一个或多个 DOM 元素,返回包含标签、属性、包围盒与可见性的结构化信息。定位器支持 CSS、role=、text=、xpath=。多匹配时用 >> nth=N 消歧。

Parameters:

  • selector
  • all
  • limit

select_page — 选择页面

Description: 按索引选择页面并将其带到前台、切换上下文。请先使用 list_pages 获取页面索引。

Parameters:

  • pageId
  • pageIdx

take_snapshot — 获取页面语义快照

Description: 获取当前页面的紧凑无障碍语义快照(TextSnapshot)。为每个交互控件分配数字 UID(如 1_4),可直接用于 click、fill、hover 等操作,Token 开销极低且免疫动态 Class 混淆。

Parameters:

  • mode
  • verbose
  • interestingOnly

upload_file — 上传文件

Description: 向 file input 元素上传文件,依次尝试 Playwright 原生 setInputFiles、filechooser 事件模式及 CDP DOM.setFileInputFiles 三级降级。

Parameters:

  • selector
  • filePath

Network

analyze_websocket_messages — analyze_websocket_messages

Description: 分析 WebSocket 消息并按模式/指纹分组。对于理解直播等场景中的二进制/protobuf 消息类型至关重要。返回每种消息类型的统计信息与样本索引。

Parameters:

  • wsid
  • direction

clear_network_requests — clear_network_requests

Description: 清空当前选中页面(或指定页面)的缓存网络请求。清空后,list_network_requests 返回的请求列表将为空,稳定的请求 ID 将从 1 重新编号。

Parameters:

  • targetPageIdx
  • targetPageId

export_request_as_curl — export_request_as_curl

Description: 将捕获的网络请求(按 reqid)导出为 curl 命令。支持与 replay_network_request 相同的覆盖项。适用于在浏览器外复现请求,或验证导出的命令能否复现捕获的响应。

Parameters:

  • reqid
  • method
  • url
  • headers
  • body
  • replaceHeaders
  • includeCookies

get_network_request — get_network_request

Description: 按可选的 reqid 获取网络请求;若省略则返回 DevTools Network 面板中当前选中的请求。

Parameters:

  • reqid
  • maxBodyLength
  • fullBody
  • saveTo

get_websocket_message — get_websocket_message

Description: 按帧索引获取单条 WebSocket 消息。请先使用 get_websocket_messages 或 analyze_websocket_messages 找到帧索引。

Parameters:

  • wsid
  • frameIndex
  • decode

get_websocket_messages — get_websocket_messages

Description: 获取 WebSocket 连接的消息。重要:对于二进制/protobuf 消息(如直播流),请先使用 analyze_websocket_messages 理解消息类型,再用 groupId 参数筛选特定类型。默认模式仅显示摘要。

Parameters:

  • wsid
  • direction
  • groupId
  • pageSize
  • pageIdx
  • show_content

list_network_requests — list_network_requests

Description: 列出当前选中页面自上次导航以来的请求。默认隐藏浏览器扩展请求;支持按资源类型、请求头关键字、分页过滤,以及等待匹配的请求。

Parameters:

  • pageSize
  • pageIdx
  • resourceTypes
  • includePreservedRequests
  • includeExtensionRequests
  • targetPageIdx
  • targetPageId
  • waitForRequest
  • waitTimeoutMs
  • headerFilter
  • urlFilter
  • includeSignatureEvidence

list_websocket_connections — list_websocket_connections

Description: 列出所有 WebSocket 连接。获取 wsid 后,请先使用 analyze_websocket_messages(wsid) 理解消息模式,再查看单条消息。

Parameters:

  • pageSize
  • pageIdx
  • urlFilter
  • includePreservedConnections

replay_network_request — replay_network_request

Description: 重放一个捕获的网络请求(按 reqid),使用浏览器上下文的 Cookie 和存储。支持覆盖 method、url、headers 和 body。适用于验证签名字段效果与参数有效性。

Parameters:

  • reqid
  • method
  • url
  • headers
  • body
  • replaceHeaders
  • maxBodyLength

replay_network_request_batch — replay_network_request_batch

Description: 以不同覆盖项(变体)多次重放一个捕获的网络请求。适用于模糊测试签名字段、测试参数边界、观察响应分布。默认串行执行,也支持有界并发。

Parameters:

  • reqid
  • variants
  • concurrency
  • maxBodyLength

Debugging

evaluate_on_callframe — 在调用帧上执行

Description: 在暂停时的指定调用帧上下文中执行 JavaScript 表达式。允许检查变量和执行代码。

Parameters:

  • expression
  • frameIndex

evaluate_script — evaluate_script

Description: 在页面上执行 JavaScript;支持 page / content-script 上下文。可选的,对于较大的结果可将输出保存到文件。

Parameters:

  • function
  • context
  • frameId
  • allowAnyFrame
  • verbose
  • filePath
  • timeoutMs

get_console_message — get_console_message

Description: 按 ID 获取单条 Console 消息,返回包含类型、文本与参数的结构化数据。

Parameters:

  • msgid

get_css_styles — 获取CSS层叠样式

Description: 获取指定元素匹配的 CSS 规则、内联样式、伪元素与继承样式及层叠(cascade)信息,标注每个声明是生效(active)还是被覆盖(overloaded)。常用于排查元素隐藏/反爬样式与样式覆盖冲突。支持分页。

Parameters:

  • selector
  • pageSize
  • pageIdx

get_paused_info — 获取暂停信息

Description: 获取当前暂停状态信息,包括调用栈、当前位置和作用域变量。在断点命中后使用此工具了解执行上下文。

Parameters:

  • includeScopes

inspect_locals — 检查局部变量

Description: 检查当前暂停栈所有帧的局部变量摘要。

list_breakpoints — 列出断点

Description: 列出当前调试会话中的所有活跃断点。

list_console_messages — list_console_messages

Description: 列出当前选中页面自上次导航以来的所有 Console 消息,支持按类型过滤与分页。

Parameters:

  • pageSize
  • pageIdx
  • types
  • includePreservedMessages

list_frames — 列出 Frame

Description: 以树形结构列出当前页面中的所有 Frame(含 iframe),显示索引、名称与 URL。使用 select_frame 可将执行上下文切换到指定 Frame。

pause — 暂停执行

Description: 暂停 JavaScript 执行。用于中断运行中的代码。

record_start — 开始轨迹录制

Description: 启动用户交互轨迹录制器。在当前活动页面注入监听,实时捕获点击、输入、改动等行为,准备与网络请求关联沉淀 Operation Evidence。

record_stop — 停止轨迹录制

Description: 停止用户交互轨迹录制器,提取记录的所有用户点击/输入步骤,并与捕获的网络因果请求关联输出 Operation Evidence。

remove_breakpoint — 移除断点

Description: 移除指定 ID 的断点。使用 list_breakpoints 查看活跃断点。

Parameters:

  • breakpointId

resume — 恢复执行

Description: 从暂停状态恢复执行,直到下一个断点或执行结束。

reveal_in_devtools — 高亮元素

Description: 在页面上高亮指定元素(相当于 DevTools Elements 面板的节点高亮),持续指定时间后自动消失。用于逆向分析时快速定位目标 DOM。

Parameters:

  • selector
  • durationMs

select_frame — 选择 Frame

Description: 选择一个 Frame(索引来自 list_frames)作为 evaluate_script、hook_function、inspect_object 等页面内 JavaScript 执行工具的运行上下文。

Parameters:

  • frameIdx

set_breakpoint — 设置断点

Description: 设置 JavaScript 断点。支持按脚本 URL 或 scriptId(来自 list_scripts / search_in_sources)加行号设置,可选条件表达式。注意:优先使用 hook_function 或 trace_function 进行监控,断点需要暂停/恢复协调,在自动化流程中容易出错。

Parameters:

  • url
  • scriptId
  • lineNumber
  • columnNumber
  • condition
  • isRegex

step_into — 单步进入

Description: 单步进入函数调用。用于进入函数体内部进行调试。需要先在断点暂停。返回结果默认包含暂停后的调用栈/作用域,省去再次调用 get_paused_info。

Parameters:

  • includePausedInfo
  • includeScopes

step_out — 单步跳出

Description: 单步跳出当前函数,继续执行直到函数返回。用于快速退出函数。需要先在断点暂停。返回结果默认包含暂停后的调用栈/作用域,省去再次调用 get_paused_info。

Parameters:

  • includePausedInfo
  • includeScopes

step_over — 单步跳过

Description: 单步跳过函数调用,将函数调用视为一个步骤。用于跳过函数体。需要先在断点暂停。返回结果默认包含暂停后的调用栈/作用域,省去再次调用 get_paused_info。

Parameters:

  • includePausedInfo
  • includeScopes

take_screenshot — 截图

Description: 对页面或元素进行截图。

Parameters:

  • format
  • quality
  • fullPage
  • filePath
  • timeoutMs

JS Reverse Engineering

anti_anti_debug — Anti Anti-Debug

Description: 反反调试工具集:固定窗口尺寸、冻结时间、阻止页面关闭、阻止历史导航、阻止控制台清除、隐藏 webdriver 标记。

Parameters:

  • features

break_on_xhr — 设置 XHR 断点

Description: 在 XHR/Fetch 请求 URL 包含指定字符串时触发断点。

Parameters:

  • url

bypass_debugger — Bypass Debugger

Description: 通过移除 eval/Function/constructor 中的 debugger 关键字来绕过无限 debugger 语句。

Parameters:

  • targets

collect_code — collect_code

Description: 从页面收集 JavaScript 代码,支持智能模式(summary/priority/incremental/full)。

Parameters:

  • url
  • smartMode
  • returnMode
  • includeInline
  • includeExternal
  • includeDynamic
  • maxTotalSize
  • maxFileSize
  • pattern
  • limit
  • topN

collect_wasm — collect_wasm

Description: 重新导航到目标 URL,并捕获网络加载与运行时创建的 WebAssembly 模块。

Parameters:

  • url
  • timeout
  • waitAfterLoadMs
  • includeRuntimeEvents
  • maxModules
  • captureBase64

collection_diff — collection_diff

Description: 对比上一次与当前收集到的文件摘要。

Parameters:

  • previous
  • current
  • includeUnchanged

create_hook — create_hook

Description: 推荐:为 function/fetch/xhr/property/cookie/websocket/eval/timer 创建 hook 脚本。Hook 运行时不会暂停页面执行,相比断点是更优的监控与拦截手段。返回 hookId 与 script,供 inject_hook 使用。

Parameters:

  • type
  • params
  • description
  • action
  • hookId
  • capture
  • condition
  • protocolFallback

dump_target_scripts — dump_target_scripts

Description: 一次性读取指定 Chromium Target 当前已解析的脚本源码。

Parameters:

  • targetId

find_in_script — 在脚本中查找

Description: 在指定脚本中查找字符串,返回精确的行号/列号及周围上下文。适用于在压缩文件中设置断点。

Parameters:

  • scriptId
  • query
  • contextChars
  • occurrence
  • caseSensitive

get_hook_data — Get Hook Data

Description: 获取 Hook 采集到的数据。会先从浏览器同步到 HookManager,再返回数据。支持 raw、summary、detail 三种视图并支持过滤。

Parameters:

  • hookId
  • view
  • maxRecords
  • type
  • event
  • phase

get_request_initiator — 获取请求发起者

Description: 获取网络请求的 JavaScript 调用栈(发起者)。帮助追踪哪个代码触发了 API 调用。

Parameters:

  • requestId

get_script_source — 获取脚本源码

Description: 根据脚本 ID 获取 JavaScript 脚本源码的本地缓存路径。触发 CDP 加载并写入临时文件,返回文件路径供后续直接读取。先使用 list_scripts 查找脚本 ID。可选 filePath 参数可将源码写入自定义路径并返回该绝对路径。

Parameters:

  • scriptId
  • locator
  • filePath
  • startLine
  • endLine

get_storage — 获取存储

Description: 获取浏览器存储数据,包括 HttpOnly cookies、可复制的 Cookie 请求头、localStorage 与 sessionStorage。

Parameters:

  • type
  • filter

hook_function — Hook Function

Description: 逆向工程推荐工具:Hook 一个 JavaScript 函数,记录其调用、参数与返回值,且不暂停执行。相比断点更适用于自动化工作流,建议作为监控函数的默认手段。

Parameters:

  • target
  • logArgs
  • logResult
  • logStack
  • hookId

inject_hook — Inject Hook

Description: 向页面注入 Hook。persistent=true 时注册到当前 BrowserContext,并尽力回填当前已有 Frame。

Parameters:

  • hookId
  • script
  • persistent
  • world

inspect_object — 检查对象

Description: 深度检查一个 JavaScript 对象,展示其属性、原型链与方法,便于理解对象结构。

Parameters:

  • expression
  • depth
  • showMethods
  • showPrototype

list_created_hooks — List Created Hooks

Description: 列出 HookManager 中所有已创建的 hook。可选地同步浏览器端数据以统计记录数。

Parameters:

  • hookId
  • verbose
  • syncFromBrowser
  • type
  • event
  • phase

list_hooks — 列出 Hook

Description: 列出当前所有已安装的函数 Hook。

list_persistent_hooks — List Persistent Hooks

Description: 列出当前 BrowserContext 中已注册的持久 Hook。

list_scripts — 列出脚本

Description: 列出当前页面加载的所有 JavaScript 脚本。返回脚本 ID、URL 和 Source Map 信息。在设置断点或搜索前使用此工具查找脚本。

Parameters:

  • filter

list_targets — list_targets

Description: 列出 Chromium 当前可见的 Target 及其脚本快照能力。

monitor_events — 监控事件

Description: 监控指定元素或 window 上的 DOM 事件,事件将输出到控制台。

Parameters:

  • selector
  • events
  • monitorId

remove_hook — remove_hook

Description: 按 ID 移除 hook。会从进程内 HookManager 删除,并可选地清理浏览器端数据。

Parameters:

  • hookId
  • cleanBrowser

remove_xhr_breakpoint — 移除 XHR 断点

Description: 移除 XHR/Fetch 断点。

Parameters:

  • url

search_in_scripts — search_in_scripts

Description: 使用正则表达式在已收集的脚本缓存中搜索。

Parameters:

  • pattern
  • limit
  • maxTotalSize

search_in_sources — 在源码中搜索

Description: 在所有已加载的 JavaScript 源码中搜索字符串或正则表达式。每条匹配仅返回脚本 ID、行号与源码缓存路径(sourcePath),避免上下文臃肿;需要查看代码内容时直接读取 sourcePath 或调用 get_script_source(scriptId, startLine, endLine)。可选 filePath 参数(目录)可将每个匹配脚本的源码写入该目录(/.js)并返回绝对路径。

Parameters:

  • query
  • caseSensitive
  • isRegex
  • maxResults
  • excludeMinified
  • urlFilter
  • source
  • filePath

set_breakpoint_on_text — 在文本上设置断点

Description: 在指定代码文本(函数名、语句等)上设置断点,通过搜索自动确定精确位置。适用于正常和压缩文件。注意:优先使用 hook_function 监控函数调用 — 它无需暂停执行即可捕获参数/返回值。仅在需要检查特定代码位置的局部变量时使用此工具。

Parameters:

  • text
  • urlFilter
  • occurrence
  • condition

stop_monitor — 停止监控

Description: 停止指定的事件监控。

Parameters:

  • monitorId

trace_function — 追踪函数

Description: 追踪源码中指定名称的函数调用。适用于任何函数(包括 webpack/rollup 打包的内部函数)。使用"日志点"(条件断点)记录参数而不暂停执行。

Parameters:

  • target
  • urlFilter
  • logArgs
  • logResult
  • logStack
  • hookId

unhook_function — Unhook Function

Description: 移除已安装的函数 Hook。

Parameters:

  • hookId

wasm_dump — wasm_dump

Description: 将捕获的 Wasm 模块导出为磁盘上的 .wasm 文件。

Parameters:

  • moduleIndex
  • outputPath

wasm_memory_inspect — wasm_memory_inspect

Description: 检查当前页面中导出的 WebAssembly.Memory —— 提供 hex/ascii 转储与模式搜索。

Parameters:

  • offset
  • length
  • format
  • searchPattern
  • timeoutMs

wasm_vmp_trace — wasm_vmp_trace

Description: 追踪由 JS-Wasm 边界 hook 捕获的 Wasm 运行时事件,可选按模块过滤。

Parameters:

  • maxEvents
  • filterModule

Input automation

scroll_by — scroll_by

Description: 按方向(up/down/top/bottom)滚动页面,并自动等待 800ms 以触发懒加载内容。

Parameters:

  • direction
  • pixels

wait_for_element — wait_for_element

Description: 等待定位器对应的元素出现在页面中。定位器支持 CSS、role=、text=、xpath=。多匹配时用 >> nth=N 消歧。

Parameters:

  • selector
  • timeout

Emulation

emulate_mobile — emulate_mobile

Description: 模拟移动设备视口、User-Agent 与触摸事件,或恢复桌面模式。

Parameters:

  • enable
  • device

emulate_network — emulate_network

Description: 通过 CDP Network.emulateNetworkConditions 模拟网络条件(节流/离线)。

Parameters:

  • throttlingOption

resize_page — resize_page

Description: 将页面视口调整为指定的宽度与高度。

Parameters:

  • width
  • height

Screenshot

video — 视频录制

Description: Record and manage browser session video via CDP screencast. Supports start, stop, status, save, read, list, discard, and capabilities.

Parameters:

  • action
  • recording_id
  • tab_id
  • session_id
  • quality
  • max_duration_ms
  • request_id
  • output
  • overwrite
  • offset

Pages

check_browser_health — check_browser_health

Description: 检查浏览器连接健康状态与页面可用性。

detect_captcha — detect_captcha

Description: 只读评估当前页面是否存在 CAPTCHA,并可等待挑战稳定清除;不会自动求解或操作页面。

Parameters:

  • action
  • timeout

handle_dialog — handle_dialog

Description: 处理浏览器弹窗(alert/confirm/prompt),可接收或取消。

Parameters:

  • action
  • promptText

Diagnostics

diagnose_environment — diagnose_environment

Description: 运行环境诊断,检查 Node 版本、构建产物与 artifacts 目录状态。

Parameters:

  • checks

Extensions

install_extension — install_extension

Description: Installs a Chrome extension from the given path.

Parameters:

  • path

list_extensions — list_extensions

Description: Lists all the Chrome extensions installed in the browser. This includes their name, ID, version, and enabled status.

reload_extension — reload_extension

Description: Reloads an unpacked Chrome extension by its ID.

Parameters:

  • id

trigger_extension_action — trigger_extension_action

Description: Triggers the default action of an extension by its ID.

Parameters:

  • id

uninstall_extension — uninstall_extension

Description: Uninstalls a Chrome extension by its ID.

Parameters:

  • id