第 1 课
安装 chrome-devtools,打开网页、读快照、点按和截图
用 npm 装好 chrome-devtools-mcp 1.13.0,起一个本地示例网页;弄清后台守护进程、页面编号和元素 uid,用 take_snapshot、fill、click 完成一次搜索,再用 take_screenshot 截图。
课程目录第 1 / 3 课
学习位置仅保存在当前浏览器,有效期 180 天。
安装 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 的来龙去脉。
