一款能够捕获浏览器流量并自动生成适用于生产环境的 Python API 客户端的命令行工具。
无需再进行手动逆向工程——只需浏览、捕获，并轻松获得干净的 API 代码。

代理模式

手动模式

目录

• 功能
• 安装
• 快速入门
• 使用模式
  • 手动模式
  • 工程师模式
  • 代理模式
  • 采集模式
• 标签
• 配置
  • 模型选择
  • 代理配置
  • SDK 选择
• CLI 命令
• Claude 代码插件
• Chrome 扩展程序
• 示例
• 开发
• 贡献

✨ 功能

• 🌐 浏览器自动化：基于 Playwright 构建，采用隐身模式实现逼真的浏览体验
• 🤖 自主代理模式：通过 AI 代理实现全自动的浏览器交互（自动模式，结合 MCP、浏览器使用、舞台助手功能）
• 📊 HAR 录制：以 HTTP 存档格式捕获所有网络流量
• 🧠 AI 驱动生成：利用 Claude 4.6 分析流量并生成干净的 Python 代码
• 🔍 采集模式：支持数据采集，并自动导出 JSON 和 CSV 文件
• 🔌 多 SDK 支持：与 Claude 和 OpenCode SDK 的原生集成
• 💻 交互式 CLI：极简主义的终端界面，支持模式切换（Shift+Tab）
• 📦 面向生产环境：生成的脚本包含错误处理、类型提示和文档说明
• 💾 会话历史：所有运行记录均保存在本地，并附带完整的消息日志
• 💰 成本追踪：通过缓存支持，详细记录令牌使用情况及成本估算
• 🏷️ 标签系统：强大的标签体系，实现细粒度控制（@record-only、@codegen、@docs、@id）

限制条件

• 本工具在本地执行代码时依赖 Claude Code——请留意输出结果
• 部分网站采用高级机器人检测机制，可能限制捕获或要求手动交互

🚀 安装

使用 uv（推荐方式）

# 基础安装
uv tool install reverse-api-engineer

# 含代理模式支持（包括浏览器使用与 HAR 录制）
uv tool install 'reverse-api-engineer[agent]' --with 'browser-use @ git+https://github.com/browser-use/browser-use.git@49a345fb19e9f12befc5cc1658e0033873892455'

使用 pip

# 基础安装
pip install reverse-api-engineer

# 含代理模式支持
pip install 'reverse-api-engineer[agent]'
pip install git+https://github.com/browser-use/browser-use.git@49a345fb19e9f12befc5cc1658e0033873892455'

安装后

安装 Playwright 浏览器：

playwright install chromium

增强版定价支持（可选）

默认情况下，Reverse API Engineer 会为最常用的模型（Claude 4.6、Gemini 3）提供定价数据。若需扩展模型覆盖范围（100 多种额外模型，包括 OpenAI GPT、Mistral、DeepSeek 等），可通过购买定价附加组件来实现：

# 使用 uv
uv tool install 'reverse-api-engineer[pricing]'

# 使用 pip
pip install 'reverse-api-engineer[pricing]'

这使得系统能够通过 LiteLLM 自动查询模型定价信息，适用于未收录于内置数据库中的模型。定价系统采用三层备选方案：

1. 本地定价（优先级最高）——内置常见模型的定价方案
2. LiteLLM 定价（如已安装）——为 100 多种模型提供更广泛的覆盖
3. 默认定价（终极备选方案）——采用 Claude Sonnet 4.6 的定价策略

无论是否安装定价附加组件，成本追踪功能始终可用。

🚀 快速入门

启动交互式 CLI：

reverse-api-engineer

CLI 提供四种模式（可通过 Shift+Tab 进行模式切换）：

• 手动模式：浏览器捕获 + AI 生成
• 工程师模式：对现有捕获进行重新处理
• 代理模式：自主的 AI 浏览器代理（默认为基于 MCP 的浏览器自动模式 + 实时逆向工程）
• 采集模式：AI 驱动的网页数据采集（目前仅提供极简版本）

示例工作流程：

$ reverse-api-engineer
> 获取苹果公司所有职位招聘信息

# 浏览器打开、导航并进行交互
# 完成后关闭浏览器
# AI 生成适用于生产环境的 API 客户端

# 脚本保存至：./scripts/apple_jobs_api/

📖 使用模式

手动模式

完整流程，包含手动浏览器交互：

1. 启动 CLI：reverse-api-engineer
2. 输入任务描述（例如：“获取苹果公司职位招聘信息”）
3. 可选地提供起始 URL
4. 浏览并与网站进行交互
5. 完成后关闭浏览器
6. AI 自动生成 API 客户端

输出位置：

• ~/.reverse-api/runs/scripts/{run_id}/（永久存储）
• ./scripts/{descriptive_name}/（本地副本，名称清晰易读）

工程师模式

对先前的捕获再次运行 AI 生成：

# 切换至工程师模式（Shift+Tab），输入运行 ID
# 或者使用命令行：
reverse-api-engineer engineer <run_id>

代理模式

完全自动化地通过 AI 代理进行浏览器交互：

1. 启动 CLI 并切换至代理模式（Shift+Tab）
2. 输入任务描述（例如：“点击第一个职位招聘信息”）
3. 可选地提供起始 URL
4. 代理自动完成导航与交互
5. 自动录制 HAR 数据
6. 自动生成 API 客户端

代理提供商选项：

• auto（默认）：基于 MCP 的浏览器自动化模式，结合 Claude Agent SDK 与 OpenCode。将浏览器控制与实时逆向工程整合到一个工作流中，无需额外安装，只需安装基础包即可。
• browser-use：使用 browser-use 库实现浏览器自动化。需通过 [agent] 附加组件以及特定 Git 仓库的 browser-use 版本进行安装（含 HAR 录制支持）。
• stagehand：使用 Stagehand 实现浏览器自动化，适用于计算机使用模型。

在 /settings 中更改代理提供商：agent provider。

收集模式

使用 Claude Agent SDK 进行网络数据采集：

1. 启动命令行界面，并切换至收集模式（按 Shift+Tab 键）。
2. 输入一段自然语言提示，描述需要采集的数据内容（例如：“查找 3 个 JavaScript 框架”）。
3. 代理会利用 WebFetch、WebSearch 以及文件工具，自主完成结构化数据的采集工作。
4. 数据会自动导出为 JSON 和 CSV 格式。

输出位置：

• ~/.reverse-api/runs/collected/{folder_name}/（永久存储）
• ./collected/{folder_name}/（本地副本，名称可读）

输出文件：

• items.json - 以 JSON 格式存储的采集数据
• items.csv - 以 CSV 格式存储的采集数据
• README.md - 采集元数据及架构文档

模型配置： 收集模式采用 collector_model 设置（默认值：claude-sonnet-4-6）。该设置可在 ~/.reverse-api/config.json 中进行配置。

示例工作流程：

$ reverse-api-engineer
> 查找 3 个 JavaScript 框架

# 代理将自主搜索并采集数据
# 数据保存至：./collected/js_frameworks/

🏷️ 标签

标签可在每种模式中提供额外的控制与功能：

手动/代理模式标签

• @record-only - 仅记录 HAR 文件，跳过反向工程步骤

  • 示例：@record-only navigate checkout flow
  • 在需要捕获流量以便后续分析时非常有用。

• @codegen - 记录浏览器操作并生成 Playwright 自动化脚本

  • 示例：@codegen navigate to google
  • 捕获点击、表单填写及导航操作，从而生成可复用的 Playwright 脚本。

工程师模式标签

• @id - 切换至特定运行 ID 的上下文

  • 示例：@id abc123
  • 加载上一次的捕获会话，用于重新进行反向工程。

• @id - 对特定运行执行工程师模式操作，并附带指令

  • 示例：@id abc123 extract user profile
  • 使用新指令对捕获结果进行重新处理。

• @id --fresh - 从头开始（忽略之前的脚本）

  • 示例：@id abc123 --fresh restart analysis
  • 从零开始生成新代码，忽略之前的实现方案。

• @docs - 为最新运行生成 API 文档（OpenAPI 规范）

  • 示例：@docs
  • 从捕获的流量中创建 OpenAPI 规范。

• @id @docs - 为特定运行生成 API 文档

  • 示例：@id abc123 @docs
  • 为特定的捕获会话生成 OpenAPI 规范。

🔧 配置

设置存储于 ~/.reverse-api/config.json：

{
  "agent_provider": "auto",
  "browser_use_model": "bu-llm",
  "claude_code_model": "claude-sonnet-4-6",
  "collector_model": "claude-sonnet-4-6",
  "opencode_model": "claude-sonnet-4-6",
  "opencode_provider": "anthropic",
  "output_dir": null,
  "output_language": "python",
  "real_time_sync": true,
  "sdk": "claude",
  "stagehand_model": "openai/computer-use-preview-2025-03-11"
}

模型选择

在 API 生成方面，可选择 Claude 4.6 模型：

• Sonnet 4.6（默认）：性能与成本均衡的选项
• Opus 4.6：适用于复杂 API 的最高能力版本
• Haiku 4.5：速度最快且成本最低的选项

可通过 /settings 或命令行进行更改：

reverse-api-engineer manual --model claude-sonnet-4-6

若使用 Opencode，请参阅 模型。

代理配置

为自主浏览器自动化配置 AI 代理。

代理提供商：

• auto（默认）：基于 MCP 的浏览器自动化工具，支持实时反向工程。通过 Claude Agent SDK 结合浏览器 MCP 工具，将浏览器控制与 API 反向工程整合为一个统一的工作流。既可与 Claude SDK（默认）配合使用，也可与 OpenCode SDK 搭配使用。
• browser-use：支持 Browser-Use LLM、OpenAI 以及 Google 模型。需通过 [agent] 附加组件进行安装。
• stagehand：支持 OpenAI 与 Anthropic Computer Use 模型

代理模型：

Browser-Use 提供商：

• bu-llm（默认） - 需要 BROWSER_USE_API_KEY
• openai/gpt-4、openai/gpt-3.5-turbo - 需要 OPENAI_API_KEY
• google/gemini-pro、google/gemini-1.5-pro - 需要 GOOGLE_API_KEY

Stagehand 提供商（仅限计算机使用）：

• openai/computer-use-preview-2025-03-11 - 需要 OPENAI_API_KEY
• anthropic/claude-sonnet-4-6-20260301 - 需要 ANTHROPIC_API_KEY
• anthropic/claude-haiku-4-5-20251001 - 需要 ANTHROPIC_API_KEY
• anthropic/claude-opus-4-6-20260301 - 需要 ANTHROPIC_API_KEY

API 密钥设置：

export BROWSER_USE_API_KEY="your-api-key"  # 适用于 Browser-Use
export OPENAI_API_KEY="your-api-key"       # 适用于 OpenAI 模型
export ANTHROPIC_API_KEY="your-api-key"    # 适用于 Anthropic 模型
export GOOGLE_API_KEY="your-api-key"       # 适用于 Google 模型

在 /settings 中进行更改，或通过命令行调整：

reverse-api-engineer manual --model claude-sonnet-4-6

若使用 Opencode，请参考 模型。

代理 SDK 选择

• Claude（默认）：直接集成 Anthropic 的 Claude API
• OpenCode：使用 OpenCode SDK（需在本地运行 OpenCode）

在 /settings 中进行更改，或直接编辑 config.json。

输出语言

控制生成的 API 客户端所使用的编程语言：

• python（默认）：生成 Python API 客户端
• javascript：生成 JavaScript API 客户端
• typescript：生成 TypeScript API 客户端

在 /settings 中更改“输出语言”，或直接编辑 config.json：

{
  "output_language": "typescript"
}

实时同步

在工程会话期间，启用或禁用文件的实时同步：

• 启用（默认）：文件会在生成时同步至磁盘
• 禁用：文件仅在会话结束时写入

启用后，您可以在 AI 生成文件的同时实时查看文件的更新情况。这一功能对于监控进度和调试非常有用。

在 /settings 中更改“实时同步”设置，或直接编辑 config.json：

{
  "real_time_sync": false
}

💻 命令行指令

在命令行中使用以下斜杠命令：

• /settings - 配置模型、代理、SDK 以及输出目录
• /history - 查看过往运行及其费用
• /messages <run_id> - 查看详细的消息日志
• /help - 显示所有命令
• /exit - 退出

🔌 Claude Code 插件

在 Claude Code 中安装插件：

claude # 打开 REPL
/plugin marketplace add kalil0321/reverse-api-engineer
/plugin install reverse-api-engineer@reverse-api-engineer

请参阅 插件文档 以了解命令、代理、技能及使用示例。

🌐 Chrome 扩展

⚠️ 正在开发中

一款 Chrome 扩展，可为 reverse-api-engineer 提供原生的浏览器集成功能。该扩展允许您直接从 Chrome 捕获浏览器流量，并通过侧边栏界面与反向工程流程进行交互。

功能：

• HAR 捕获：利用 Chrome 的 Debugger API 记录网络流量
• 侧边栏界面：提供交互式界面，用于管理捕获任务并与 AI 代理进行聊天交流
• 原生主机集成：与 reverse-api-engineer CLI 工具实现通信

设置

先决条件：

• Node.js 和 npm
• Chrome 浏览器
• 已安装 reverse-api-engineer CLI（uv tool install reverse-api-engineer）
• 已安装 Claude Code CLI（npm install -g @anthropic-ai/claude-code）

步骤：

1. 构建扩展：

   cd chrome-extension
   npm install
   npm run build
   

2. 在 Chrome 中加载：

   • 打开 chrome://extensions/
   • 启用 开发者模式（右上角切换开关）
   • 点击 加载已解压的扩展程序，并选择 chrome-extension/dist 目录
   • 复制扩展程序的 ID（扩展名下方显示的 32 位字符串）

3. 安装原生主机（将扩展程序与 CLI 连接）：

   reverse-api-engineer install-host --extension-id YOUR_EXTENSION_ID
   

4. 仅限 macOS — 在运行一次以通过 Gatekeeper 审核 Claude Code：

   claude --version
   

   如果 macOS 显示安全提示，请前往 系统设置 > 隐私与安全性，点击 允许一切，然后再次运行该命令。

开发流程：

• npm run dev — 监听模式（更改时自动重新构建，随后在 chrome://extensions/ 中重新加载）
• npm run build — 生产环境构建

💡 示例

示例：对招聘网站 API 进行反向工程

$ reverse-api-engineer
> 从其职业页面获取所有苹果职位

# 浏览器打开，您可进行导航和交互
# 完成后关闭浏览器

# AI 生成：
# - api_client.py（完整的 API 实现）
# - README.md（文档说明）
# - example_usage.py（使用示例）

# 脚本已复制到：./scripts/apple_jobs_api/

生成的 api_client.py 包含以下内容：

• 认证处理
• 清洁函数接口
• 类型提示与文档字符串
• 错误处理
• 适用于生产环境的代码

🛠️ 开发

设置

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

运行

uv run reverse-api-engineer

构建

./scripts/clean_build.sh

🔐 需求

• Python 3.11+
• Claude Code / OpenCode（用于反向工程）
• 已安装 Playwright 浏览器
• 代理模式所需的 API 密钥（参见 代理配置）

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

本项目采用 MIT 许可证——详情请参阅 LICENSE 文件。

reverse-api-engineer 快速上手指南

reverse-api-engineer 是一款强大的 CLI 工具，能够捕获浏览器流量并自动生成生产级的 Python API 客户端代码。无需手动逆向工程，只需浏览、捕获，即可获得干净的 API 代码。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL 推荐)
• Python 版本：3.11 或更高版本
• API Key：需要配置 Anthropic API Key (用于 Claude 模型) 或其他支持的 LLM Provider Key
• 浏览器内核：工具依赖 Playwright，安装后需单独下载浏览器内核

安装步骤

推荐使用 uv 进行安装以获得更快的速度和更好的依赖管理，同时也支持 pip。

1. 基础安装

使用 uv (推荐):

uv tool install reverse-api-engineer

使用 pip:

pip install reverse-api-engineer

2. 安装浏览器内核

安装完成后，必须执行以下命令下载 Playwright 所需的 Chromium 浏览器：

playwright install chromium

3. (可选) 安装智能体模式支持

如果您需要使用全自动的 Agent Mode（由 AI 自主控制浏览器），建议安装增强版依赖：

使用 uv:

uv tool install 'reverse-api-engineer[agent]' --with 'browser-use @ git+https://github.com/browser-use/browser-use.git@49a345fb19e9f12befc5cc1658e0033873892455'

使用 pip:

pip install 'reverse-api-engineer[agent]'
pip install git+https://github.com/browser-use/browser-use.git@49a345fb19e9f12befc5cc1658e0033873892455

4. 配置 API Key

在使用前，请在终端导出您的 API Key（以 Anthropic 为例）：

export ANTHROPIC_API_KEY="your-api-key-here"

基本使用

启动交互式 CLI

在终端输入以下命令启动工具：

reverse-api-engineer

启动后，您将进入交互式界面。默认处于 Manual Mode（手动模式）。您可以按 Shift+Tab 在不同模式间切换（Manual / Engineer / Agent / Collector）。

最简单的使用示例（手动模式）

此模式下，您手动操作浏览器，工具自动记录流量并生成代码。

1. 输入任务描述： 在提示符后输入您想要抓取的数据或操作，例如：

   > fetch all apple jobs from their careers page
   

   (可选：随后输入起始 URL，或直接回车使用默认页)

2. 操作浏览器： 工具会自动打开浏览器窗口。像平常一样浏览网页、点击按钮、滚动页面，直到完成所有需要捕获的操作。

3. 结束并生成： 关闭浏览器窗口。AI 将自动分析捕获的 HAR 流量数据，并生成包含错误处理、类型提示和文档的生产级 Python API 客户端代码。

4. 查看结果： 生成的脚本将保存在以下位置：

   • 永久存储：~/.reverse-api/runs/scripts/{run_id}/
   • 本地副本：./scripts/{descriptive_name}/

进阶：智能体模式 (Agent Mode)

如果您已安装 [agent] 扩展包，可以尝试全自动模式：

1. 启动工具后，按 Shift+Tab 切换到 agent 模式。
2. 输入自然语言指令，例如：

   > Click on the first job listing and extract the salary
   

3. AI 智能体将自动控制浏览器完成导航、点击和数据提取，并直接生成对应的 API 代码，全程无需人工干预。