Web API Extractor

Web API Extractor — 操作手册 (Runbook)

让 Agent 在真实站点上完成「登录 → 操作 → 抓包 → 分析 → 生成 MCP」的闭环。

本文件是主索引：只保留核心流程与硬性规则；各步骤的详细操作拆在 runbook/ 下， 按需加载（顺利时不加载排错等无关章节，避免无关内容全量进上下文）。 需要环境变量、工具清单、项目结构等技术细节时查 docs/reference.md。

核心流程

按顺序执行；每步的「怎么做」见对应模块（runbook/xx.md，相对本目录）。

1. 环境准备 + 传输引导（新部署一次）：bootstrap → doctor；工具无法直接调用时用 start_server.py + mcp_call.py。→ runbook/00-environment.md
2. 探测登录方式 → 登录：probe_login；open_browser_login（或 http_login）； 用户确认登录完成后调 confirm_login 拿 auth_state。→ runbook/01-authentication.md
3. 抓包：start_capture（带 auth_state_path），用户操作目标功能，stop_capture。→ runbook/02-capture.md
4. 分析：analyze_traffic。→ runbook/03-analyze.md
5. 加密与凭据核实（强制，禁止跳过）：看 crypto_found，必要时 extract_crypto_logic。→ runbook/04-crypto.md
6. 生成：generate_mcp_server(session_id, output_dir)。→ runbook/05-generate.md
7. 持续迭代：diff_capture → merge_capture → regenerate_server → export_project。→ runbook/06-iterate.md

关键限制（硬规则）

• 步骤 5 不可跳过：抓包里的凭据值必然被脱敏为 ***，明文/密文不可区分，禁止假设，必须核实。
• 登录完成必须由用户确认：open_browser_login 后先问用户是否已登录完成，得到答复再调 confirm_login；抓包未带 auth_state_path 时，问用户后再调 confirm_login_ready。 不便在对话里问时，改用 request_login_confirm_dialog / request_capture_confirm_dialog 弹系统对话框让用户点选（点「否」不丢弃，可再次弹出）。 工具返回的 auth_evidence 只是旁证，不得据此自行判定并往下走——用户确认前不要开始抓包或分析。
• 启动服务务必用 start_server.py，不要直接在宿主 shell 后台跑 run_http.py（否则浏览器「打开后立刻消失」）。

模块索引