用途:当静态抓取无法取得内容时,用该技能驱动真实无头浏览器,按有序动作列表操作页面后再捕获结果。适用于内容藏在“Load more”按钮、无限滚动、表单提交或仅交互后才运行的 JS 之后的情况。
主要能力:crawlberg interact <url> --actions '[...]' 按顺序执行动作,结果包裹在 interaction 键下。支持动作类型:click(selector)、type(selector、text)、press(key,如 Enter、Tab、Escape)、scroll(direction 为 up/down,可选 selector、amount)、wait(milliseconds 或 selector)、screenshot(fullPage 可选)、executeJs(script)、scrape(无字段)。未知字段会被拒绝。无 select 动作,等待元素需用带 selector 的 wait。
参数:--actions 必填;--format 默认 json,可选 markdown(仅输出最终 HTML,非转换后 Markdown);--timeout 默认 30000 毫秒;--browser-mode 为 auto/always/never;--browser-endpoint 为外部 CDP ws:// 或 wss:// URL;--config 为内联 JSON 或 @file.json。interact 无 --respect-robots-txt 标志。
限制:单次最多 100 个动作;单次 wait 最多 300000 毫秒,所有 wait 总计最多 300 秒;selector 最多 4096 字节;text 与 executeJs 脚本各最多 1 MB;scroll amount 绝对值最多 100000 px。超出会报错。executeJs 仅运行可信脚本,凭据应从环境或密钥库传入,不要硬编码。
输出:JSON 模式下 interaction.final_html 为最终页面 HTML,interaction.action_results[...] 记录每个动作结果,含截图数据与 executeJs 返回值。若页面无需交互即可抓取,应改用 crawlberg scrape。