Neo 2.0 是一款网页应用 API 发现与浏览器自动化工具,基于纯 CDP(Chrome DevTools Protocol)实现,无需安装任何浏览器扩展。它的目标是把任意网站变成 AI 可调用的 API,并支持浏览网页、读取页面、与 Web 应用交互、调用网站 API 以及自动化网页任务。
【用途】 Neo 适用于需要让 AI 与网站交互的场景:检查网站、读取网页内容、调用网站接口、在缺少 API 时通过 UI 自动化完成点击与填写,以及管理登录会话。
【强制第一步】 使用前必须运行 neo doctor 进行健康检查。若全部通过(✓)则继续;若 Chrome CDP 显示 ✗,运行 neo start 以正确配置文件和 CDP 启动 Chrome;若仍为 ✗,则询问用户并停止,不要循环重试。
【关键规则】
- 绝不要手动启动 Chrome,始终使用 neo start。
- 绝不要复制 Chrome 配置文件,登录会话存在于真实配置文件中。
- 绝不要使用 pkill chrome,用户可能打开了重要标签页。
- 如果卡住,告知用户并停止,不要循环重试。
【主要能力与工作流】
- 读取网页:neo doctor 后,用 neo read example.com 从任意已打开标签页提取可读文本;若页面未打开,先 neo open https://example.com 再读取。
- 调用网站 API(快速路径):neo doctor 后,用 neo schema show x.com 检查已有 API 知识,再用 neo api x.com HomeTimeline 调用(自动从浏览器获取认证),或带 --body 参数调用如 CreateTweet。
- 为新网站发现 API:neo doctor 后,neo open 打开网站,浏览以产生流量,然后 neo capture list example.com --limit 20、neo schema generate example.com、neo api example.com <keyword>。
- UI 自动化(无 API 时):neo doctor 后,用 neo snapshot 获取带紧凑引用 ID 的无障碍树,再用 neo click 14 点击、neo fill 7 "search query" 清空并填写、neo type 7 "text" 追加文本、neo press Enter、neo scroll down 500、neo screenshot。引用为紧凑整数,如 [0] button "Sign in"、[1] input "Search",使用 neo click 0、neo fill 1 "query";旧版 @e5 和 [5] 格式也兼容。
- Cookie 管理:neo cookies list 列出当前页面所有 Cookie,可加域名过滤;neo cookies export github.com cookies.json 导出;neo cookies import cookies.json 恢复;neo cookies clear github.com 按域名删除,或 neo cookies clear 删除全部。导出与导入可用于跨浏览器重启持久化登录会话。
- 配置文件管理:neo profile list 发现所有 Chrome 配置文件及邮箱,neo profile use "Default" 设置默认,neo start 以所选配置文件启动。
- 清理:完成后用 neo tabs 查看,再用 neo eval "window.close()" --tab example.com 关闭标签页。
【命令参考】 页面读取与交互:neo open <url>、neo read <tab-pattern>、neo eval "<js>" --tab <pattern>、neo tabs [filter]。 UI 自动化:neo snapshot [-i] [-C] [--json] [--diff]、neo click <ref> [--new-tab]、neo fill <ref> "text"、neo type <ref> "text"、neo press <key>、neo hover <ref>、neo scroll <dir> [px] [--selector css]、neo select <ref> "value"、neo screenshot [path] [--full]、neo get text <ref> | url | title、neo wait <ref> | --load | <ms>。 Cookie 管理:neo cookies list [domain]、neo cookies export [domain] [file]、neo cookies import <file>、neo cookies clear [domain]。 配置文件管理:neo profile list、neo profile use <name>。 捕获与流量(无需扩展,纯 CDP):neo status、neo capture start、neo capture stop、neo capture list [domain] [--limit N]、neo capture search <query>、neo capture domains、neo capture detail <id>。 Schema(API 知识):neo schema generate <domain>、neo schema show <domain>、neo schema list、neo schema search <query>。 API 执行:neo api <domain> <keyword> [--body '{}']、neo exec <url> [--method POST] [--body] [--tab pattern] [--auto-headers]、neo replay <id> [--tab pattern]。 安装与诊断:neo setup、neo start [--profile <name>]、neo doctor [--fix]。
【决策树】 想与网站交互时:首先 neo doctor;全部 ✓ 则继续,Chrome ✗ 则 neo start 后重试,仍 ✗ 则询问用户并停止。仅需读取内容用 neo read <domain>。需要调用 API 时,先 neo schema show <domain>,存在则用 neo api;无 schema 则 neo open 后浏览,再 neo schema generate,最后 neo api。需要点击/填写/输入时,用 neo snapshot 后 neo click 5 或 neo fill 3 "text"。需要管理 Cookie/会话时,用 neo cookies list/export/import/clear。完成后用 neo eval "window.close()" --tab <domain> 关闭。
【关键原则】 始终先运行 neo doctor。API 优先于 UI 自动化:若 schema 中存在接口,使用 neo api,不要快照加点击。认证是自动的:API 调用继承浏览器 Cookie、会话和 CSRF。使用后关闭标签页:每次 neo open 都会创建新标签页。如果卡住就停止,不要在 Chrome 启动上循环,询问用户。
【限制】 资料未提供关于收费、价格、支持平台、性能效果等方面的信息。