SuperAPI AI 工具集

nodriver-browser

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:当页面需要 JavaScript 渲染(SPA、无限滚动、懒加载),或 WebFetch 被反爬系统拦截,或任务需要点击、填表、多步流程、跨操作保持会话、截图取证时使用。静态 HTML、一次性搜索、纯 JSON API、单次无交互抓取不适合本技能,因它常驻 Chromium 进程占用约 150–200MB 内存。

主要能力:脚本位于 scripts/ 目录,均以 uv run --script 加 PEP 723 元数据运行,输出 JSON。核心脚本包括 nav.py 导航、snapshot.py 生成页面文本与带编号的交互元素引用(refs 写入 /tmp/nodriver-skill/refs.json)、click.py/type.py/hover.py/press.py/select.py/upload.py 交互、scroll.py、wait.py、eval.py、screenshot.py,以及 tabs.py、close_tab.py、cleanup.py 管理标签页。守护进程控制由 start_daemon.py、stop_daemon.py、status.py 负责。

使用方式:首次调用交互脚本会自动启动守护进程,默认无头模式,端口 9222,使用隔离配置 ~/.cache/nodriver-skill/profile/。可用 --headed 显示窗口,--user-profile 使用用户 Chrome 配置,--no-sandbox 仅限 PRoot/容器/root 环境。每个脚本输出含 tabs_open,若大于 1 需用 cleanup.py 或 close_tab.py 处理。导航或 SPA 重渲染后 refs 会失效,需重新运行 snapshot.py。会话结束应运行 stop_daemon.py 释放内存。

限制:不支持并发导航同一标签页;wait.py 每 250ms 轮询;type.py 会先清空字段;eval.py 仅接受单个表达式,多语句需包成 IIFE。资料未提供价格、平台或效果信息。