Skip to content
Back to search

reverse-api-engineer

Reverse engineer any website into a typed API client. Works with Claude Code, Codex, Cursor and OpenCode.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kalil0321/reverse-api-engineer with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kalil0321/reverse-api-engineer'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kalil0321--reverse-api-engineer/badge.svg)](/listings/kalil0321--reverse-api-engineer)

HTML

<a href="/listings/kalil0321--reverse-api-engineer"><img src="/api/listings/kalil0321--reverse-api-engineer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

The secured cryptography dependency no longer supports Intel macOS or 32-bit Windows. Use Linux (including on Intel hardware), Apple Silicon macOS, or 64-bit Windows. Installing on the retired platforms may attempt an unsupported source build requiring Rust and OpenSSL development tools; this is not a supported installation path. Do not downgrade cryptography to restore old wheels. See the [upstream platform changes](https://cryptography.io/en/latest/changelog/#v49-0-0).

Agent mode (the default) captures through `npx`-launched browser tooling — browser MCP servers (Playwright or Chrome DevTools) or the Vercel `agent-browser` CLI — and needs no extra Python packages. **Manual mode** drives a local Playwright browser, which ships in the optional `[manual]` extra:

uv tool install "reverse-api-engineer[manual]"   # or: pip install "reverse-api-engineer[manual]"
playwright install chromium

Use it from your coding agent

Install the skill so Claude Code, Codex, Cursor, OpenCode and other agents know how to drive the CLI:

npx skills add kalil0321/reverse-api-engineer

Then ask your agent for what you need, for example "get me a typed client for the job search on this careers page". The skill lives in [`skills/reverse-api-engineer`](skills/reverse-api-engineer/SKILL.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 216 lines
  1. <div align="center">
  2. <img src="https://raw.githubusercontent.com/kalil0321/reverse-api-engineer/main/assets/reverse-api-banner.png" alt="Reverse API Engineer Banner">
  3. <br><br>
  4. <a href="https://pypi.org/project/reverse-api-engineer/"><img src="https://img.shields.io/pypi/v/reverse-api-engineer?style=flat&color=e50d75&labelColor=1f1f1f" alt="PyPI"></a>
  5. <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11+-e50d75?style=flat&labelColor=1f1f1f" alt="Python"></a>
  6. <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-e50d75?style=flat&labelColor=1f1f1f" alt="License"></a>
  7. <a href="https://github.com/kalil0321/reverse-api-engineer/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/kalil0321/reverse-api-engineer/ci.yml?branch=main&style=flat&labelColor=1f1f1f&label=CI" alt="CI"></a>
  8. <br>
  9. [![Greptile: The War on Bugs](https://www.greptile.com/badge.svg)](https://www.greptile.com/?utm_source=oss_badge&utm_medium=readme&utm_campaign=greptile_for_open_source)
  10. </div>
  11. # Reverse API Engineer
  12. > **Turn websites into APIs.** Browse (or let an agent browse), and get a clean, typed client for the endpoints the site actually uses.
  13. <p align="center">
  14. <img src="https://raw.githubusercontent.com/kalil0321/reverse-api-engineer/main/assets/rae-autoscout.gif" alt="Agent Mode Demo">
  15. <br>
  16. <em>Agent mode</em>
  17. </p>
  18. <p align="center">
  19. <img src="https://raw.githubusercontent.com/kalil0321/reverse-api-engineer/main/assets/reverse-api-engineer.gif" alt="Manual Mode Demo">
  20. <br>
  21. <em>Manual mode</em>
  22. </p>
  23. ---
  24. ## How it works
  25. 1. You give it a website and a goal ("fetch all Apple jobs").
  26. 2. A browser visits the site, either driven by you or by an AI agent.
  27. 3. Network traffic is captured to a HAR file.
  28. 4. Your configured model reads the traffic and writes a working API client in Python, JavaScript, TypeScript, Go, Java, C#, PHP, Ruby, C, or PowerShell.
  29. No more manually opening DevTools, copying cURL commands, and gluing together a client.
  30. ## Install
  31. ```bash
  32. uv tool install reverse-api-engineer # or: pip install reverse-api-engineer
  33. ```
  34. The secured cryptography dependency no longer supports Intel macOS or 32-bit Windows. Use Linux (including on Intel hardware), Apple Silicon macOS, or 64-bit Windows. Installing on the retired platforms may attempt an unsupported source build requiring Rust and OpenSSL development tools; this is not a supported installation path. Do not downgrade cryptography to restore old wheels. See the [upstream platform changes](https://cryptography.io/en/latest/changelog/#v49-0-0).
  35. Agent mode (the default) captures through `npx`-launched browser tooling —
  36. browser MCP servers (Playwright or Chrome DevTools) or the Vercel `agent-browser`
  37. CLI — and needs no extra Python packages. **Manual mode** drives a local
  38. Playwright browser, which ships in the optional `[manual]` extra:
  39. ```bash
  40. uv tool install "reverse-api-engineer[manual]" # or: pip install "reverse-api-engineer[manual]"
  41. playwright install chromium
  42. ```
  43. ### Use it from your coding agent
  44. Install the skill so Claude Code, Codex, Cursor, OpenCode and other agents know how to drive the CLI:
  45. ```bash
  46. npx skills add kalil0321/reverse-api-engineer
  47. ```
  48. Then ask your agent for what you need, for example "get me a typed client for the job search on this careers page". The skill lives in [`skills/reverse-api-engineer`](skills/reverse-api-engineer/SKILL.md).
  49. ## Quick start
  50. ```bash
  51. reverse-api-engineer
  52. > fetch all apple jobs from their careers page
  53. # Browser opens. Navigate, interact, close when done.
  54. # → ./scripts/apple_jobs_api/ (api_client.py, README.md, example_usage.py)
  55. ```
  56. Cycle modes with **Shift+Tab**:
  57. | Mode | What it does |
  58. |------|--------------|
  59. | `manual` | You drive the browser; AI generates the client from captured traffic. |
  60. | `agent` | An AI agent drives capture autonomously (Playwright or Chrome MCP, or Vercel agent-browser CLI). |
  61. | `engineer` | Re-run generation on a previous capture (`engineer <run_id>`). Needs a HAR, so it works on `auto`, `agent-browser` and manual runs, not chrome-mcp runs. |
  62. | `collector` | Agent collects structured data (JSON/CSV) using web search + fetch. |
  63. Agent mode providers:
  64. - **chrome-mcp** (default for new configs; an existing `config.json` keeps its provider): drives your real Chrome so you keep existing sessions/cookies. Needs Node.js 20.19+; headed runs also need Chrome 146+ open with auto-connect enabled at `chrome://inspect/#remote-debugging`, and someone at the machine to accept Chrome's connection prompt when the run starts. For headed runs, rae checks before launching that Chrome's remote debugging port is reachable (not the Chrome or Node version) and stops with setup steps if it isn't; `agent --dry-run` shows the same check. Headless runs skip it. `--headless` starts a separate headless Chrome without your sessions. No HAR file is saved, so `engineer <run_id>` cannot regenerate these runs; run `agent` again instead.
  65. - **auto**: Playwright MCP, records a HAR and needs no Chrome setup.
  66. - **agent-browser**: [Vercel agent-browser](https://github.com/vercel-labs/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).
  67. Optional sanity checks:
  68. ```bash
  69. agent-browser doctor --offline --quick || true
  70. agent-browser skills list >/dev/null
  71. ```
  72. ## Configuration
  73. Settings live in `~/.reverse-api/config.json` and can be edited via `/settings` in the CLI:
  74. ```json
  75. {
  76. "agent_provider": "chrome-mcp",
  77. "agent_browser_npx_package": "agent-browser@0",
  78. "agent_browser_notes": "",
  79. "claude_code_model": "claude-sonnet-4-6",
  80. "claude_setting_sources": [],
  81. "collector_model": "claude-sonnet-4-6",
  82. "ollama_auto_start": true,
  83. "ollama_base_url": "http://127.0.0.1:11434",
  84. "opencode_auto_start": true,
  85. "opencode_base_url": "http://127.0.0.1:4096",
  86. "opencode_model": "big-pickle",
  87. "opencode_npx_package": "opencode-ai@latest",
  88. "opencode_provider": "opencode",
  89. "copilot_model": "gpt-5",
  90. "cursor_model": "composer-2.5",
  91. "output_dir": null,
  92. "output_language": "python",
  93. "real_time_sync": true,
  94. "sdk": "claude"
  95. }
  96. ```
  97. - **Models**: Sonnet 5.5, Opus 5.5 (most capable), Opus 4.6 and Haiku 5.5 (fastest). Sonnet 4.6 stays the default until you choose another; it and Haiku 4.5 are still accepted in config and by `--model`. For OpenCode see [models.dev](https://models.dev).
  98. - **SDK**: `claude` (default), `opencode`, `cursor`, or `copilot` (GitHub Copilot).
  99. - **Claude settings isolation**: Claude sessions don't load your Claude Code settings files, `CLAUDE.md`, hooks, plugins, permission rules or MCP servers, so your personal setup doesn't steer the agent. Organization-managed policy still applies, and Claude Code still reads its own state such as `~/.claude.json` and auto memory. If `~/.claude/settings.json` provides your authentication (`apiKeyHelper`, or Bedrock, Vertex or proxy variables under `env`), set `claude_setting_sources` to the layers to load, e.g. `["user"]` or `["user", "project", "local"]`. Each layer you list is loaded in full, including its hooks, plugins, permission rules and MCP servers.
  100. - **OpenCode setup**: with `sdk: "opencode"`, RAE reuses an existing server or downloads/starts `opencode-ai@latest` through `npx`; a global OpenCode installation is not required. Fresh configurations default to the free `opencode/big-pickle` model. `/settings` shows a loading list, then offers a searchable **opencode provider / model** list populated from the server's connected, tool-capable catalog and marks free OpenCode options. Before creating a session, RAE validates the saved pair again and suggests currently available free models when configuration is invalid. Compatible older servers are reused with a version warning. Node.js 20+ is required for automatic startup. Password-protected servers use `OPENCODE_SERVER_PASSWORD` and optional `OPENCODE_SERVER_USERNAME`. Override startup with `OPENCODE_BASE_URL`, `RAE_OPENCODE_PACKAGE`, or `RAE_OPENCODE_AUTO_START=0`.
  101. - **Ollama through OpenCode**: choose provider `ollama` in `/settings`; RAE starts an installed Ollama daemon if needed, lists only installed models with tool calling and 64k+ context, and supplies OpenCode's provider config inline. Models are never downloaded silently. Override with `RAE_OLLAMA_BASE_URL` or `RAE_OLLAMA_AUTO_START=0`.
  102. - **Output language**: `python`, `javascript`, `typescript`, `go`, `java`, `csharp`, `php`, `ruby`, `c`, or `powershell`. C needs a POSIX toolchain (`cc`, libcurl headers) — macOS/Linux, or WSL/MSYS2 on Windows. PowerShell needs `pwsh` 7+ (PowerShell Core, not Windows PowerShell 5.1). Its runner executes the generated `Example.ps1` beside `api_client.psm1`; argument overrides are not supported. Edit the example or import the module to call its exported functions with your own arguments.
  103. ## CLI
  104. `reverse-api-engineer` opens a full-screen session; `agent`, `engineer` and `collector` open it too when run in a terminal (`agent` and `engineer` stay plain with `--json` or `--no-interactive`). Type `/` for the commands:
  105. - `/model`, `/effort`, `/mode`: switch the model, how hard it thinks, and the mode (also Shift+Tab, ctrl+e).
  106. - `/settings`: SDK, agent provider, models, output and sync, changed in place in the session.
  107. - `/history`: past runs with their details, to resume or re-engineer.
  108. - `/resume [run_id]`: show a past run's conversation as it was and continue it where it stopped, on any SDK. Works for agent and engineer runs from this version on, which save their SDK session. Collector runs cannot be resumed.
  109. - `/output` (ctrl+o): everything from the session, unfolded. `/open`: the latest client.
  110. - `/help` (or `/commands`): what rae does, its modes, commands and keys.
  111. - `/new`, `/clear`, `/exit` (or `/quit`).
  112. Scriptable subcommands (pipe to `jq`):
  113. ```bash
  114. reverse-api-engineer agent --prompt "capture the public jobs api" \
  115. --url https://example.com/jobs --json | jq
  116. reverse-api-engineer list --json
  117. reverse-api-engineer show <run_id> --json
  118. reverse-api-engineer run <run_id> --file api_client.py \
  119. --no-interactive --auto-install -- --org acme
  120. ```
  121. Pass `--no-interactive` (and/or `--json`) to skip prompts. With `--json`, stdout is one JSON document and logs go to stderr.
  122. ### `agent --json` schema
  123. | Field | Type | Notes |
  124. |------------------|---------------------|------------------------------------------------------------------------|
  125. | `schema_version` | `int` | Currently `1`. |
  126. | `status` | `"ok"` \| `"error"` | Top-level result. |
  127. | `run_id` | `string` \| `null` | Use with `show` / `engineer` / `run`. |
  128. | `prompt` | `string` | |
  129. | `url` | `string` \| `null` | |
  130. | `mode` | `string` \| `null` | `"auto"`, `"chrome-mcp"`, or `"agent-browser"`. |
  131. | `har_path` | `string` \| `null` | Captured HAR. |
  132. | `script_path` | `string` \| `null` | Generated client; exists whenever `status` is `"ok"`. |
  133. | `usage` | `object` | `{input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, total_cost_usd}`, each present only when the SDK reports it, plus the SDK's own usage under `raw`. |
  134. | `error` | `string` \| `null` | When `status == "error"`. |
  135. ### Exit codes
  136. | Code | Meaning |
  137. |------|---------|
  138. | `0` | Success. |
  139. | `1` | Runtime error. |
  140. | `2` | Missing required arg under `--no-interactive` / `--json`. |
  141. 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.
  142. ### Debugging agent failures
  143. Set the `RAE_DEBUG` environment variable to `1` to print the Python traceback
  144. for unexpected agent capture failures to stderr. Normal error messages remain
  145. concise by default, and `--json` / `--json-stream` stdout remains machine-readable.
  146. ## Output locations
  147. - `~/.reverse-api/runs/scripts/{run_id}/`: permanent storage
  148. - `./scripts/{descriptive_name}/`: local copy with a readable name
  149. - Collector: `./collected/{folder_name}/` (`items.json`, `items.csv`, `README.md`)
  150. ## Caveats
  151. - Generated code runs locally via Claude Code, so review before executing.
  152. - Sites with aggressive bot detection may block capture or require manual interaction.
  153. ## Development
  154. ```bash
  155. git clone https://github.com/kalil0321/reverse-api-engineer.git
  156. cd reverse-api-engineer
  157. uv sync
  158. uv run reverse-api-engineer
  159. ```
  160. Build: `./scripts/clean_build.sh`. Requires Python 3.11+ and an API key for agent mode. Manual mode additionally needs the `[manual]` extra plus `playwright install chromium`.
  161. ## License
  162. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.