核心用法
Neo 2.0 基于 Chrome DevTools Protocol (CDP),无需安装浏览器扩展即可实现强大的 Web 自动化能力。其工作流程以 neo doctor 为强制起点,诊断 Chrome CDP 连接状态,必要时通过 neo start 启动配置正确的 Chrome 实例。
主要功能模块包括:
1. 网页内容读取:neo read <domain> 提取可读文本,neo open 打开新页面
2. API 发现与调用:通过 neo capture 记录网络流量,neo schema generate 自动生成 API 规范,neo api 智能调用并自动继承浏览器认证状态
3. UI 自动化:neo snapshot 获取可访问性树与紧凑引用 ID(如 [0] button),支持 neo click 0、neo fill 1 "text"、neo press Enter 等精确操作
4. 会话管理:neo cookies export/import 持久化登录状态,neo profile 切换 Chrome 用户配置
显著优点
- 零扩展架构:纯 CDP 实现,规避扩展商店审核与兼容性问题
- 智能 API 发现:自动分析网络流量生成可复用的 API Schema
- 自动认证继承:API 调用无缝复用浏览器登录态,无需手动处理 Token
- 紧凑引用系统:数字 ID 替代复杂 XPath/CSS 选择器,UI 自动化更稳定
- 完整工作流闭环:从诊断、发现、执行到清理(
neo eval "window.close()")的全生命周期管理
潜在缺点与局限性
- Chrome 依赖:必须安装 Chrome,且 CDP 版本需兼容
- 单浏览器限制:操作绑定特定 Chrome 实例,多用户场景需手动切换 profile
- 动态内容挑战:重度依赖 JavaScript 渲染的站点可能需要额外等待逻辑
- 平台限制:Node.js 运行时依赖,Windows 环境可能存在路径兼容问题
- 安全风险:Cookie 导出功能若保管不当可能导致会话泄露
适合人群
- 需要与无公开 API 网站交互的开发者
- Web 自动化测试工程师
- 数据抓取与分析研究人员(合规场景下)
- AI Agent 构建者,需将 Web 能力集成至工作流
常规风险
- 会话安全风险:导出的 Cookie 文件包含敏感认证信息,需加密存储
- 误操作风险:
neo cookies clear无确认机制,可能意外清除重要登录态 - Chrome 稳定性:长时间自动化运行可能导致内存占用过高
- 网站封禁:高频自动化操作可能触发反爬虫机制
- CDP 协议变更:Chrome 更新可能破坏兼容性,需及时跟进 Neo 版本