Claude Code 如何读取动态网页？web-access 联网能力教程

你是不是遇到过这种情况：浏览器里明明有完整正文，可 Claude Code 抓回来的就只有导航栏和几个空容器？这通常不是“网页没内容”，而是读取的时机和路径不对。动态网页会在 JavaScript 运行后才去请求数据、渲染组件，有的甚至得滚动页面或者点击操作，才会把内容放进 DOM 里。web-access 的价值，就是在静态抓取失效后，把任务转到真实浏览器环境中执行。

先判断是不是动态页面

普通公开文章还是可以先用 WebFetch 或 curl 抓取。要是返回内容和屏幕上显示的明显不一样，碰到登录墙、前端空壳、加载占位符，或者目标字段得切换标签才能看到，这时候再换 CDP 就行。这么做比一上来就接管浏览器更稳，也不会给简单页面额外增加操作成本。

从页面外壳走到真实内容

1. 确认页面：先读取当前 URL、标题和登录状态，先把跳错域名、会话过期、重定向这些问题排除掉。
2. 查看 DOM：用 /eval 查询目标文本、链接、按钮和容器的状态。先摸清楚页面结构，再决定要不要执行点击操作。
3. 触发加载：要是列表只显示了首屏内容，就用 /scroll 分段滚动页面；内容藏在标签页或者展开项里的，就执行一次明确的点击操作。
4. 深入组件：普通选择器找不到元素，但画面上确实能看到的时候，就去检查 Shadow DOM 与 iframe。这俩会让元素看得见，却不在顶层文档里。
5. 视觉复核：只有关键信息由图片、画布或媒体承载的时候，再截图确认；能从 DOM 里直接读取的文字，没必要全都依赖图像识别。

四种“空页面”不要混在一起

数据还没到：页面还在加载，等目标容器的状态变化就行；数据没触发：需要滚动、切换标签或者展开才能加载；数据在别处：内容在 iframe、Shadow DOM 或者新的后台标签页里；数据被限制：比如登录失效、权限不足、验证码或者站点风控。前三种可以调整读取方法解决，最后一种别靠重复点击硬闯，没用的。

判断读取完成的标准也不只是“找到一段文字”就行。目标字段得和正确页面、当前账号范围、可见状态对应上；涉及删除、发布、付款或者提交表单这类操作时，读取和执行必须分开，得先把将要发生的变化说清楚。你就把顺序记成“确认页面—读取 DOM—触发加载—视觉复核”，碰到动态网页能少走很多弯路。