第 1 课

安装 chrome-devtools,打开网页、读快照、点按和截图

用 npm 装好 chrome-devtools-mcp 1.13.0,起一个本地示例网页;弄清后台守护进程、页面编号和元素 uid,用 take_snapshot、fill、click 完成一次搜索,再用 take_screenshot 截图。

图文20 分钟Chrome DevTools MCP 官方文档 ↗

课程目录第 1 / 3 课

学习位置仅保存在当前浏览器,有效期 180 天。

01 / 图文教材

安装 chrome-devtools,打开网页、读快照、点按和截图

本课对照 chrome-devtools-mcp 官方 README 与 CLI guide 编写;命令与输出在 Debian 13 x86_64 测试机上实跑,版本 chrome-devtools-mcp 1.13.0、Google Chrome 156(2026-11-16)。

本课目标

  • 装好 chrome-devtools 命令,确认版本和守护进程状态
  • 在本机起一个示例网页,用命令行打开它
  • 用快照拿到元素 uid,再填表、点按钮、截图

前置条件

  • Node.js LTS 和 npm(本机是 Node.js 24)
  • 正式版 Google Chrome 或 Chrome for Testing,官方只保证这两种
  • Python 3,用来在本机提供示例网页

第 1 步:安装 chrome-devtools-mcp

官方 CLI guide 的安装方式是全局安装 npm 包:

npm i chrome-devtools-mcp@latest -g
chrome-devtools --version
1.13.0

包里同时带两个东西:给智能体用的 MCP 服务器 chrome-devtools-mcp,和给人在终端里用的 chrome-devtools 命令。本课前两课只用后者。

第 2 步:先决定是否关闭使用统计

官方 README 写明,Google 默认会收集这个工具的使用统计,例如工具调用成功率和耗时。不想上报可以设置环境变量,本课全程都这样做:

export CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS=1

另外,性能工具默认会把 trace 里的网址发给 Google 的 CrUX 接口取真实用户数据,第 2 课会讲怎么关掉。

第 3 步:准备示例网页

建一个目录,写一个只有搜索框的小页面。点「Search」时它会请求一个不存在的接口,故意制造一个 404 和一条控制台报错,第 2 课要用它来练排错:

mkdir -p ~/cdm-demo && cd ~/cdm-demo
cat > index.html <<'HTML'
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>Demo Shop</title></head>
<body>
<h1>Demo Shop</h1>
<label for="q">Search</label>
<input id="q" placeholder="Search products">
<button id="go">Search</button>
<p id="out"></p>
<script>
document.getElementById('go').onclick = async () => {
  const q = document.getElementById('q').value;
  const r = await fetch('/api/search?q=' + encodeURIComponent(q));
  document.getElementById('out').textContent =
    r.ok ? 'OK' : 'Error ' + r.status;
  if (!r.ok) console.error('search failed', r.status);
};
console.log('page ready');
</script>
</body>
</html>
HTML
touch favicon.ico

touch favicon.ico 放一个空图标,免得浏览器自动请求图标时多出一条无关的 404。然后在后台起本地网页服务:

python3 -m http.server 8811 --bind 127.0.0.1 &

第 4 步:第一次调用,守护进程自动启动

先看状态,再列出当前页面:

chrome-devtools status
chrome-devtools list_pages

对照结果(启动提示的长行已折行):

chrome-devtools-mcp daemon is not running.
turning off usage statistics. process.env['CI'] ||
  process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS'] is set.
chrome-devtools-mcp exposes content of the browser instance to the
  MCP clients allowing them to inspect, debug, and modify any data
  in the browser or DevTools.
...
## Pages
1: about:blank [selected]

官方 CLI guide 说明了这里发生的事:chrome-devtools 本身只是客户端,第一次调用工具时,它会在后台启动 chrome-devtools-mcp 守护进程和一个 Chrome。之后的命令都复用同一个实例,打开的页面和 Cookie 都会保留。CLI 模式默认无头运行,并且用临时的独立用户目录,不会碰你日常用的 Chrome 配置。

页面编号从 1 开始。CLI 里凡是针对页面的工具,第一个参数都是页面编号。

第 5 步:打开示例网页

chrome-devtools navigate_page 1 --url "http://127.0.0.1:8811/"
Successfully navigated to http://127.0.0.1:8811/.
## Pages
1: Demo Shop (http://127.0.0.1:8811/) [selected]

第 6 步:用快照拿到元素 uid

take_snapshot 读取页面的无障碍树,给每个可操作的元素一个 uid。智能体就是靠这份文字快照「看」页面的,比截图省很多 token:

chrome-devtools take_snapshot 1
## Latest page snapshot
uid=1_0 RootWebArea "Demo Shop" url="http://127.0.0.1:8811/"
  uid=1_1 heading "Demo Shop" level="1"
  uid=1_2 "Search"
  uid=1_3 textbox "Search"
  uid=1_4 button "Search"

搜索框是 1_3,按钮是 1_4。uid 只在当前快照里有效,页面变了要重新取。

第 7 步:填表并点击

chrome-devtools fill 1 1_3 "headphones"
chrome-devtools click 1 1_4
chrome-devtools take_snapshot 1
Successfully filled out the element
Successfully clicked on the element
## Latest page snapshot
uid=1_0 RootWebArea "Demo Shop" url="http://127.0.0.1:8811/"
  uid=1_1 heading "Demo Shop" level="1"
  uid=1_2 "Search"
  uid=1_3 textbox "Search" value="headphones"
  uid=1_4 button "Search" focusable focused
  uid=2_0 "Error 404"

新快照里输入框有了值,页面多出一行「Error 404」,新元素的 uid 以 2_ 开头,表示来自第二次快照。这个 404 正是我们故意留下的问题。

第 8 步:截图

chrome-devtools take_screenshot 1 --filePath shop.png
Took a screenshot of the current page's viewport.
Saved screenshot to /home/you/cdm-demo/shop.png.

默认截当前视口,加 --fullPage 可截整页。CLI 默认不限制文件读写路径。官方建议用 chrome-devtools start --workspace=<目录> 把截图、trace 等文件工具限制在指定目录里。

第 9 步:查看和停止守护进程

chrome-devtools status
chrome-devtools-mcp daemon is running.
pid=764033 socket=/tmp/xdg-runtime-box-10/chrome-devtools-mcp/
  server.sock start-date=2026-11-15T15:54:31.080Z version=1.13.0
args=["--viaCli"]

下一课还要用这个页面,先不要停。全部做完后用 chrome-devtools stop 关掉守护进程和浏览器。命令卡住或连不上时,官方排错建议也是先执行一次 stop。

常见坑

  • 找不到 chrome-devtools 命令:确认 npm 全局目录在 PATH 里,可用 npm root -g 查看安装位置
  • 页面编号写错:先用 list_pages 看编号,再操作
  • 点了没反应:uid 过期了,重新 take_snapshot 取新 uid
  • 服务器没有图形界面:CLI 默认就是无头模式,不需要额外参数

小结

chrome-devtools 命令背后是一个常驻的 MCP 守护进程和一个真实 Chrome。操作网页的基本循环是先 take_snapshot 拿 uid,再 fill、click,然后再取快照确认结果。下一课用同一个页面查出那个 404 的来龙去脉。