reverse-api-engineer

Name: reverse-api-engineer
Author: kalil0321

by kalil0321

Verified

The agent that turns websites into APIs!

775stars

72forks

Python

Added 12/27/2025

Installation

# Add to your Claude Code skills
git clone https://github.com/kalil0321/reverse-api-engineer

Getting Started

Guides for using ai agents skills like reverse-api-engineer.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/9/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-09T06:18:21.083Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is reverse-api-engineer?

reverse-api-engineer is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by kalil0321. The agent that turns websites into APIs!. It has 775 GitHub stars.

Is reverse-api-engineer safe to use?

Yes. reverse-api-engineer passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install reverse-api-engineer?

Clone the repository with "git clone https://github.com/kalil0321/reverse-api-engineer" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is reverse-api-engineer written in?

reverse-api-engineer is primarily written in Python. It is open-source under kalil0321 on GitHub, so you can review or fork the full source.

Are there alternatives to reverse-api-engineer?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh reverse-api-engineer against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

claude-forge Wax

Reverse API Engineer

Turn websites into APIs. Browse (or let an agent browse), and get a clean, typed client for the endpoints the site actually uses.

How it works

You give it a website and a goal ("fetch all Apple jobs").
A browser visits the site, either driven by you or by an AI agent.
Network traffic is captured to a HAR file.
Claude reads the traffic and writes you a working API client (Python, JS, or TS).

No more manually opening DevTools, copying cURL commands, and gluing together a client.

Install

uv tool install reverse-api-engineer   # or: pip install reverse-api-engineer
playwright install chromium

Quick start

reverse-api-engineer
> fetch all apple jobs from their careers page

# Browser opens. Navigate, interact, close when done.
# → ./scripts/apple_jobs_api/  (api_client.py, README.md, example_usage.py)

Cycle modes with Shift+Tab:

Mode	What it does
`manual`	You drive the browser; AI generates the client from captured traffic.
`agent`	An AI agent drives capture autonomously (Playwright or Chrome MCP, or Vercel agent-browser CLI).
`engineer`	Re-run generation on a previous capture (`engineer <run_id>`).
`collector`	Agent collects structured data (JSON/CSV) using web search + fetch.

Agent mode providers:

auto (default): Playwright MCP, single workflow for browsing + reverse engineering.
chrome-mcp: drives your real Chrome so you keep existing sessions/cookies. Requires Chrome 146+ and Node.js 20.19+.
agent-browser: Vercel agent-browser CLI (not a Reverse API Engineer browser MCP server). At session start RAE uses whatever agent-browser is already on PATH, otherwise runs npm install -g <pin> (same pin as config / RAE_AGENT_BROWSER_PACKAGE), prints a yellow notice, validates with --help, and only then falls back to npx -y <pin> if npm cannot install. Prompts embed the resolved shell prefix alongside skills get core --full, skills list, HAR phases, cloud notes from agent_browser_notes. Tune with agent_browser_npx_package (optional), env RAE_AGENT_BROWSER_*. First Chromium fetch: agent-browser install (add --with-deps on trimmed Linux).

Optional sanity checks:

agent-browser doctor --offline --quick || true
agent-browser skills list >/dev/null

Configuration

Settings live in ~/.reverse-api/config.json and can be edited via /settings in the CLI:

{
  "agent_provider": "auto",
  "agent_browser_npx_package": "agent-browser@0",
  "agent_browser_notes": "",
  "claude_code_model": "claude-sonnet-4-6",
  "collector_model": "claude-sonnet-4-6",
  "opencode_model": "claude-sonnet-4-6",
  "opencode_provider": "anthropic",
  "copilot_model": "gpt-5",
  "cursor_model": "composer-2.5",
  "output_dir": null,
  "output_language": "python",
  "real_time_sync": true,
  "sdk": "claude"
}

Models: Sonnet 4.6 (default), Opus 4.6 (most capable), Haiku 4.5 (fastest). For OpenCode see models.dev.
SDK: claude (default), opencode, cursor, or copilot (GitHub Copilot).
Output language: python, javascript, or typescript.

CLI

Slash commands inside the CLI:

/settings: configure model, SDK, agent provider, and sync settings.
/history: list past runs with timestamps, costs, and status.
/messages <run_id>: view detailed message logs for a run.
/help (alias: /commands): show the command list.
/exit (alias: /quit): leave the CLI.

Scriptable subcommands (pipe to jq):

reverse-api-engineer agent --prompt "capture the public jobs api" \
  --url https://example.com/jobs --json | jq

reverse-api-engineer list --json
reverse-api-engineer show <run_id> --json
reverse-api-engineer run <run_id> --file api_client.py \
  --no-interactive --auto-install -- --org acme

Pass --no-interactive (and/or --json) to skip prompts. With --json, stdout is one JSON document and logs go to stderr.

`agent --json` schema

Field	Type	Notes
`schema_version`	`int`	Currently `1`.
`status`	`"ok"` \| `"error"`	Top-level result.
`run_id`	`string` \| `null`	Use with `show` / `engineer` / `run`.
`prompt`	`string`
`url`	`string` \| `null`
`mode`	`string` \| `null`	`"auto"`, `"chrome-mcp"`, or `"agent-browser"`.
`har_path`	`string` \| `null`	Captured HAR.
`script_path`	`string` \| `null`	Generated client.
`usage`	`object`	`{input_tokens, output_tokens, total_cost}`.
`error`	`string` \| `null`	When `status == "error"`.

Exit codes

Code	Meaning
`0`	Success.
`1`	Runtime error.
`2`	Missing required arg under `--no-interactive` / `--json`.

For run, the exit code is the underlying script's return code on success, 1 if no script was found, or non-zero if --no-interactive would have had to prompt.

Output locations

~/.reverse-api/runs/scripts/{run_id}/: permanent storage
./scripts/{descriptive_name}/: local copy with a readable name
Collector: ./collected/{folder_name}/ (items.json, items.csv, README.md)

Caveats

Generated code runs locally via Claude Code, so review before executing.
Sites with aggressive bot detection may block capture or require manual interaction.

Development

git clone https://github.com/kalil0321/reverse-api-engineer.git
cd reverse-api-engineer
uv sync
uv run reverse-api-engineer

Build: ./scripts/clean_build.sh. Requires Python 3.11+, Playwright browsers, and an API key for agent mode.

License

MIT. See LICENSE.