Ghi lại API từ trình duyệt để AI thao tác web tự động

TL;DR

Nếu bạn muốn AI làm việc trên web app nhưng app đó không có API chính thức, Neo sẽ tự động ghi lại mọi API call trình duyệt bạn thực hiện, rồi cho phép AI replay lại — không cần automation browser chậm chạp.

→ Dành cho ai muốn AI thay mình thao tác trên web app không có API.

Bài này dành cho ai?

1. Người muốn AI làm việc thay mình trên web app

Vấn đề: Web app không có API, hoặc API chính thức chỉ cho 10% tính năng. Browser automation thì chậm, dễ break mỗi lần UI thay đổi.

Khi nào cần: Muốn AI đăng bài, lấy dữ liệu, thao tác trên các tool như X, GitHub, Slack… mà không có API đàng hoàng.

Được gì: AI có thể gọi trực tiếp internal API của web app — nhanh gấp 10-20 lần so với browser automation.

2. Người build AI automation product

Vấn đề: Cần integrate với hàng trăm web app nhưng không ai có public API. Reverse engineering từng cái thủ công tốn thời gian.

Khi nào cần: Build agent có thể thao tác trên mọi web app, không cần dev làm API riêng cho từng tool.

Được gì: Schema tự động generate từ traffic thực, có auth tự động, có thể export thành OpenAPI hay skill markdown cho agent.

3. Dev muốn hiểu API của web app nào đó

Vấn đề: Cần biết một button trên web gọi API gì, parameters ra sao, response结构 thế nào — mà không có docs.

Khi nào cần: Debug, reverse engineer, hoặc tạo integration cho tool nội bộ.

Được gì: Xem được mọi API call kèm DOM trigger — biết chính xác click button nào gọi endpoint nào.

Các điểm chính

1. Mọi web app đã có API sẵn — bạn chỉ cần bắt nó Frontend gọi API mỗi lần bạn click, scroll, load dữ liệu. Neo intercept mọi fetch/XHR request, lưu lại URL, headers, body, response. Không cần official API. → Làm gì: Cài extension, browse bình thường — Neo tự ghi mọi thứ.

2. Auth tự động — không cần quản lý token Khi replay API, Neo lấy live auth headers từ browser (cookies, CSRF, Bearer token) thay vì lưu trữ. Schema chỉ lưu tên header, không lưu giá trị — an toàn hơn. → Làm gì: Dùng neo exec hoặc neo replay — auth tự động theo tab đang mở.

3. Schema tự generate — hiểu API không cần docs Chạy neo schema generate x.com để tạo API map từ captures: endpoints, parameters, response structure. Export được OpenAPI 3.0 hoặc Markdown cho agent đọc. → Làm gì: Muốn AI hiểu web app nào, chạy schema generate trước.

4. Tìm được workflow từ API dependencies neo flows phát hiện chuỗi API call theo thứ tự. neo deps tìm dependencies giữa response và request — biết API nào cần kết quả từ API khác. → Làm gì: Dùng neo workflow discover để tìm multi-step operations như “đăng tweet” gồm những API nào.

5. Mock server từ schema — test không cần real API neo mock x.com khởi động local server từ schema đã generate, có thể thêm latency mô phỏng network chậm. → Làm gì: Test agent behavior mà không cần chạy real API.

6. Security trade-off — chạy local, nhưng thấy mọi traffic Neo yêu cầu <all_urls> permission, thấy mọi request trên mọi website. Auth header values được redact tự động từ v1.1.0, nhưng response bodies vẫn lưu (truncated 100KB). → Làm gì: Không cài trên shared machine, periodically prune captures của sensitive domains.

Quick Start

1. Cài đặt:

git clone https://github.com/4ier/neo.git
cd neo && npm install && npm run build

Sau đó load extension vào Chrome: chrome://extensions → Developer mode → Load unpacked → chọn extension/dist/

2. Thử capture + replay:

# Mở Chrome với --remote-debugging-port=9222
# Browse website bất kỳ — Neo bắt đầu ghi

# Xem captured
node tools/neo.cjs capture list

# Generate schema
node tools/neo.cjs schema generate example.com
node tools/neo.cjs schema show example.com

# Replay API đã capture
node tools/neo.cjs replay \<capture-id> --tab example.com