Neo

将任何 Web 应用转化为 API。 无需官方 API，无需浏览器自动化。

Neo 是一款 Chrome 扩展程序，它能被动捕获浏览器发出的每一个 API 调用，学习其模式，并允许 AI（或您本人）直接回放这些调用。

面临的问题

如今 AI Agent 在操作 Web 应用时，只有两种选择，但效果都不理想：

方法	痛点
官方 API	大多数 SaaS 没有 API，或者只开放了 10% 的功能
浏览器自动化	截图 → OCR → 点击。速度慢、脆弱，UI 一变就失效

Neo 是第三种选择。 每个 Web 应用内部都已经具备了完整的 API——每当你点击页面时，前端都在调用它们。Neo 会捕获这些调用并使它们可回放。

v2 版本：新增 UI 自动化。 Neo v2 引入了基于无障碍树（accessibility-tree）的 UI 层——支持 snapshot（快照）、click（点击）、fill（填充）、type（输入）、press（按键）、hover（悬停）、scroll（滚动）、select（选择）、screenshot（截图）、get（获取）、wait（等待）。当 API 存在时，直接使用 API；当 API 不存在时，Neo 可以通过相同的 CLI 驱动 UI。一套工具，两层支持。

工作原理

正常浏览 → Neo 记录所有 API 流量 → 自动生成 Schema → AI 直接回放 API
                                                                      → 或通过 a11y 树驱动 UI

1. 捕获 (始终在线)

该 Chrome 扩展程序会拦截每一个 fetch() 和 XMLHttpRequest 请求——包括 URL、Header、请求/响应体、耗时，甚至是触发调用的 DOM 元素。

2. 学习

在域名上运行 neo-schema，即可自动生成该域名的 API 映射：包含端点（endpoint）、必要的鉴权 Header、查询参数、响应结构及错误码。

3. 执行

通过 Chrome DevTools Protocol 在浏览器标签页的上下文中运行 API 调用。Cookies、CSRF token、会话认证信息——全部自动继承。无需手动管理 Token。

支持的浏览器

浏览器	类型	适用场景
Chrome / Chromium	完整浏览器	API 捕获 + UI 自动化 (默认)
Lightpanda	无头浏览器 (Zig)	AI Agent、数据抓取 — 速度快 11 倍，内存占用少 9 倍

快速上手

git clone https://github.com/4ier/neo.git
cd neo && npm install && npm run build
npm link  # 使 `neo` 全局可用

加载扩展程序：

1. 打开 chrome://extensions
2. 开启“开发者模式”
3. 点击“加载已解压的扩展程序” → 选择 extension/dist/
4. 浏览任何网站 — Neo 将立即开始捕获

Lightpanda (无头模式，无需扩展程序)

# 安装 Lightpanda
curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux
chmod +x lightpanda && sudo mv lightpanda /usr/local/bin/

# 在 ~/.neo/config.json 中配置 Neo 使用 Lightpanda:
# { "chromePath": "/usr/local/bin/lightpanda", "browserType": "lightpanda", "cdpPort": 9222 }

neo start    # 启动 Lightpanda CDP 服务器
neo connect  # 连接到它
neo open https://example.com
neo snapshot # 获取完整 a11y 树

CLI 工具

所有命令均通过统一的 CLI 执行：neo <command>。

需要一个启用了 CDP (Chrome DevTools Protocol) 的浏览器。

# --- 连接与会话 ---
neo connect [port]                          # 连接到 CDP，保存会话
neo connect --electron            # 自动发现 Electron 应用的 CDP 端口
neo launch  [--port N]                 # 启动启用了 CDP 的 Electron 应用
neo discover                                # 发现本地可连接的 CDP 端点
neo sessions                                # 列出已保存的会话
neo tab                                     # 列出当前活动会话中的 CDP 目标
neo tab <id> | neo tab --url <pattern>    # 切换当前活动标签页目标
neo inject [--persist] [--tab pattern]      # 将 Neo 捕获脚本注入到目标中

# --- 捕获与流量 ---
neo status                                  # 捕获数据的概览
neo capture summary                         # 快速概览
neo capture list github.com --limit 10      # 显示回放/详细信息的 ID
neo capture list --since 1h                 # 按时间过滤
neo capture domains
neo capture search "CreateTweet" --method POST
neo capture watch x.com                     # 实时追踪 (类似 tail -f)
neo capture stats x.com                     # 方法/状态/耗时分析
neo capture export x.com --since 2h > x.json
neo capture export x.com --format har > x.har  # 导出 HAR 1.2 格式供 Postman/devtools 使用
neo capture import x-captures.json
neo capture prune --older-than 7d
neo capture gc x.com [--dry-run]            # 智能去重

# --- API 回放与执行 ---
neo replay <id> --tab x.com         # 回放捕获的调用
neo exec <url> --method POST --body '{...}' --tab example.com --auto-headers
neo api x.com HomeTimeline                  # 智能调用 (Schema 查找 + 自动鉴权)

# --- Schema 与分析 ---
neo schema generate x.com                   # 从捕获数据生成
neo schema generate --all                   # 批量处理所有域名
neo schema show x.com [--json]
neo schema openapi x.com                    # 导出为 OpenAPI 格式