TL;DR

Reverse API Engineer (kalil0321/reverse-api-engineer, MIT, 623★) là CLI Python biến mọi phiên trình duyệt thành một production-ready API client. Bạn mở browser do tool điều khiển, click quanh site, đóng tab — Claude Sonnet 4.6 sẽ đọc HAR vừa thu, phân tích endpoint, auth, pagination, rồi xuất ra api_client.py kèm type hints, error handling, session management và README. Có 4 mode (Manual, Engineer, Agent, Collector) và đã được đóng gói thành Claude Code plugin.

What's new

Tool vừa cán mốc v0.7.1 với 264 commits, 20 releases và một plugin Claude Code marketplace chính thức. Điểm khác biệt so với mớ "AI agent + browser" đang nở rộ: nó được thiết kế xoay quanh HAR. Tác giả Kalil fork lại Playwright MCP và nhồi thêm HAR recording bản địa, để toàn bộ pipeline record → analyze → generate gói gọn trong một CLI duy nhất, thay vì phải ghép 3–4 tool rời.

Why it matters

Reverse-engineer một undocumented API kiểu cũ tốn nhiều giờ DevTools: mở Network tab, lọc XHR, copy as cURL, tách header, đoán pagination, viết Python tay, chỉnh retry, viết test. Lặp lại vài chục lần cho mỗi job board / ATS / dashboard nội bộ là một bài toán quen thuộc với devs làm scraper, recon hoặc tích hợp SaaS không có SDK. Reverse API Engineer rút ngắn vòng lặp đó còn đúng "click qua website + đóng browser". Tác giả viết tool này khi xây Stapply Map — một job aggregator hiển thị vị trí địa lý các listing — và phải hứng dữ liệu từ hàng loạt ATS không công bố API.

Technical facts

  • Stack: Python 3.11+ (85% codebase), TypeScript (14.2%), chạy trên Playwright với stealth mode.
  • Model mặc định: Claude Sonnet 4.6 cho generation và agent. Có thể switch sang Opus 4.6 hoặc Haiku 4.5; LiteLLM extras mở ra 100+ model khác.
  • HAR lưu tại ~/.reverse-api/runs/har/{run_id}/recording.har, code sinh ra tại ./scripts/{task_name}/.
  • Output mặc định: api_client.py + README + ví dụ usage. Optional: OpenAPI spec qua tag @docs, hoặc client JS/TS.
  • Cost tracking built-in: token usage, cache hit, ước tính chi phí từng run.
  • Tag system fine-grained: @record-only, @codegen, @docs để bật tắt từng giai đoạn.

Comparison

Tác giả thử browser-use và Stagehand trước, nhưng cả hai đều thiếu HAR recording bản địa — phải ghép pipeline thủ công và mất tính atomic. Bảng dưới tóm tắt khác biệt:

Cách tiếp cậnCapture HARAI codegenSetup
DevTools + viết tayManual exportKhôngVài giờ/site
browser-use / StagehandKhông nativeCó (agent)Phải tự ghép HAR
Reverse API EngineerNative (Playwright fork)Claude 4.61 lệnh CLI

Use cases

  • Job board / ATS scraper: motivation gốc của tác giả — quét endpoint của Workday, Greenhouse, Lever-likes.
  • Checkout / pricing recon trên e-commerce để dựng monitor giá hoặc test automation.
  • SaaS dashboard automation: dựng SDK draft cho các dashboard không có public API (BI tools, internal admin).
  • Security recon: nhanh chóng map endpoints, auth headers, request dependencies trong scope pentest đã được phép.
  • Bootstrap SDK nội bộ: ghi lại flow QA tay, sinh client làm starter cho team backend.

Limitations & pricing

Bản thân tool free (MIT), nhưng phần "engineer" cần Claude Code hoặc OpenCode chạy nền — nghĩa là bạn vẫn trả phí token cho Anthropic (Sonnet 4.6 mặc định). Vài cảnh báo đáng lưu ý:

  • Tool thực thi code do AI sinh ra ngay trên máy local qua Claude Code — tác giả khuyến cáo monitor cẩn thận, đừng chạy vào HAR của site nhạy cảm rồi để tự động execute.
  • Site có bot-detection nâng cao (Cloudflare turnstile, PerimeterX) có thể block phiên Playwright.
  • Chrome extension (side panel) còn WIP — flow chính hiện vẫn là terminal.
  • Agent mode cần API key riêng cho Browser-Use hoặc Stagehand.

What's next

Roadmap public của repo có 3 hướng đáng chờ: (1) hoàn thiện Collector mode để vừa export data vừa giữ code generated, biến tool thành scraper-as-a-service mini; (2) một community registry để dev share lại các API đã reverse-engineer được, kiểu "awesome-undocumented-apis" có code; (3) hoàn thiện Chrome extension cho người không quen CLI. Plugin Claude Code đã có sẵn trên marketplace, cài bằng /plugin marketplace add kalil0321/reverse-api-engineer rồi /plugin install reverse-api-engineer@reverse-api-engineer.

Nguồn: github.com/kalil0321/reverse-api-engineer, dev.to/kalil0321, plugin README.