Integuru：用 AI 逆向内部 API，自动生成平台集成代码

Integuru 是一个 AI Agent：通过逆向浏览器里的内部 API，给没有官方开放接口的平台生成可运行的集成代码。仓库约 4750 stars，Python，AGPL-3.0。官网产品线在 integuru.com；本仓库是他们最早公开的 v0 思路。

项目简介

很多业务数据只能在网页里点一点——下载账单、导出列表、触发某个后台操作——却没有稳定的公开 API。Integuru v0 的做法是：

1. 用浏览器录下完整网络请求（HAR）和 cookies
2. 用自然语言描述「我刚完成了什么动作」
3. Agent 找出关键请求、理清依赖、输出能打内部 endpoint 的 Python 代码

README 里举的例子是下载水电账单：最终请求 URL 可能带 accountId / userId，这些参数又来自更早的接口；Agent 把依赖图建好，再从叶子节点一路生成可执行函数，直到只剩登录 cookie。

工作原理（简版）

1. 在 HAR 里定位「完成目标动作」的那条请求
2. 找出 URL/body 里的动态字段，以及它们依赖的其它请求
3. 反复挂依赖，直到请求只依赖认证 cookie
4. 从无出边的节点往上遍历，把图转成可运行函数链

可选：图生成阶段支持输入变量（例如选 YEAR 再下载某年文档）；完整代码生成侧的变量支持 README 写仍在演进。

核心特性

• 从浏览器流量反推 unofficial API 调用链
• 自动建 请求依赖图，而不是只抄一条 URL
• 输出可跑的 Python 集成代码（--generate-code）
• 支持自定义 prompt、HAR/cookie 路径、max_steps、模型选择
• 2FA：先完成二次验证，再拿 cookie/session 进流程（仓库有专门说明）

技术栈与环境

安装与使用

# 1. 配置 OPENAI_API_KEY
export OPENAI_API_KEY=sk-...

# 2. 依赖
poetry install
poetry shell

# 可选：Jupyter
poetry run ipython kernel install --user --name=integuru

# 3. 起浏览器录流量，登录目标站并完成一次目标操作
poetry run python create_har.py

# 4. 跑 Agent
poetry run integuru --prompt "download utility bills" --model gpt-4o

# 需要完整集成代码时
poetry run integuru --prompt "download utility bills" --model gpt-4o --generate-code

CLI 常用参数：

--model            LLM 模型（默认 gpt-4o）
--prompt           描述要触发的动作 [必填]
--har-path         HAR 路径（默认 ./network_requests.har）
--cookie-path      cookie 路径（默认 ./cookies.json）
--max_steps        最大步数（默认 20）
--input_variables  key value 形式的输入变量
--generate-code    是否生成完整集成代码

测试：poetry run pytest。

隐私与合规注意

• HAR 和 cookies 默认落在本机文件里
• 请求会发到 云端 OpenAI（GPT-4o / o1 等）；README 称不会用你的使用数据训练模型
• 这是逆向 内部 API / 非官方接口：目标站 ToS、账号风控、法律边界都要自己评估
• 授权：AGPL-3.0，分发/改造成网络服务时义务更重，商用前看清协议

v0 与产品线

本仓库明确是 最早公开的 v0，用来展示「HAR → 依赖图 → 代码」路线。后续版本和托管能力在 www.integuru.com / integuru.ai。问产品可联系 richard@integuru.com。

演示视频：YouTube。

小结

Integuru v0 适合研究「如何把浏览器里的一次操作变成可重复的内部 API 脚本」：录 HAR、写 prompt、让 LLM 拆依赖并吐 Python。要生产级集成或最新能力，以官网当前产品为准；用开源版时注意密钥、cookie 保管和目标站合规。

• GitHub：https://github.com/Integuru-AI/Integuru
• 产品：https://www.integuru.com
• Topics：ai-agent、integrations、rpa、openapi、unofficial-api