FreeWebAI

统一 10 个免费网页 AI 的 OpenAI 兼容网关

把你已登录的 Chrome AI 订阅（Gemini / ChatGPT / Claude / 通义千问 / Kimi / MiniMax / 智谱清言 / 豆包 / MiMo / DeepSeek）变成一个常驻服务 + 一个 API：报名字、发 prompt、拿答案。

English | 中文 | Changelog

⚠️ 重要声明（使用前请阅读）

本项目仅供个人学习、研究、技术交流使用，与文中涉及的 AI 厂商没有任何关联、授权或背书关系。本项目通过浏览器自动化访问各 AI 的网页免费端（非官方 API），自动化访问可能违反相关平台的服务条款，可能导致账号被风控、限制或封禁——请务必使用自己的账号，并自行承担全部风险与损失。

如您认为本项目中的任何内容侵犯了您的著作权、商标权或其他合法权益，请通过 GitHub Issue 联系我们，一经核实，我们将立即删除相关内容。

完整条款见下方「声明与免责」章节。

✨ 本版本优化点（相对原仓）

• 常驻热 daemon —— 一个常驻进程持有 Chrome CDP 连接和全部 provider 热 tab，不再每次调用 spawn 新进程 / 重连 CDP / 重新探测 10 个 AI。实测提速约 2 倍（15–30s vs 原 ~75s）。

• 统一接口，三个入口 —— HTTP REST + CLI + MCP server，同一套热核心。

• OpenAI 兼容协议 —— 提供 POST /v1/chat/completions 与 GET /v1/models，任何 OpenAI 系 SDK/客户端把 base URL 指向本服务即可用。

• 并行批量 + 串行管道 —— POST /v1/parallel 并发分发任务到多个 AI；POST /v1/pipeline 跑"搜索→推理→合成→审查"链路。

• 失败记忆 + 自愈 —— 失败 provider 进冷却自动跳过；Chrome 挂掉时 daemon 自动重启 Chrome 并重连，无需人工干预。

• 修复了 Gemini 自动化适配 —— 免费网页 AI 更新 UI 后原 adapter 的编辑器输入失效，本仓库内置修复（重新查询 + 重试循环输入），未改动原仓一个字节。

本仓库基于 AgentChat（原仓）二次开发，复用其 skills/lib/ CDP provider 库，对原仓零改动，并保留其 MIT 版权声明。详见下方 与原仓的差异。

Related MCP server: finalyy

🏗️ 架构

任意客户端 (OpenAI SDK / curl / Claude Code / MCP)
        │
        ├─ HTTP REST ─────────────────────────┐
        ├─ CLI (node src/cli.js) ─────────────┤
        └─ MCP server (stdio) ────────────────┤
                                              ▼
                              FreeWebAI daemon（常驻 Node 进程）
                                │  单次 CDP 连接 + 热 tab
                                │  进程内调度（复用 providerFactory）
                                ▼
                         Chrome（你的已登录会话）
                                │
                                ▼
              Gemini / ChatGPT / Claude / 通义 / Kimi / MiniMax /
                        智谱清言 / 豆包 / MiMo / DeepSeek

🚀 快速开始

git clone https://github.com/Amengclass/FreeWebAI.git
cd FreeWebAI
npm install

# 1. 确保专用调试 Chrome 已跑且各 AI 网页已登录
#    （登录态存在独立 Chrome profile 里，见 AgentChat 文档）

# 2. 启动 daemon
npm start

# 3. 开问
node src/cli.js "你好"
node src/cli.js --provider=deepseek "解释一下思维链"

⚙️ 配置

复制 .env.example 为 .env（全部可选，默认值合理）：

🔌 API 一览

provider 路由：provider / model 接受任意写法 —— gemini、google、gpt-4o、deepseek-r1、豆包…… 全部自动路由到对应网站；省略则 auto 降级。

⚠️ 关于 model 的准确说明：它路由到网站，不能控制网页实际跑哪个模型——真正用什么模型由网页按你的账号/套餐决定。保留该字段是为了兼容 OpenAI 协议（SDK 必带 model）。

🔍 与原仓的差异

两者驱动同一个已登录 Chrome、复用同一套 skills/lib。区别在生命周期与接口面：

❓ 常见问题

📁 项目结构

FreeWebAI/
├── src/
│   ├── hub.js        # 热 daemon 核心：CDP、热 tab、调度、冷却、重连
│   ├── http.js       # REST + OpenAI 兼容端点
│   ├── mcp.mjs       # MCP server（chat / parallel / pipeline / status）
│   ├── cli.js        # 终端客户端
│   ├── router.js     # provider/厂商/模型名 → 网站 路由
│   └── config.js     # .env + 常量
├── .env.example
├── package.json
└── README.md / README_EN.md / CHANGELOG.md / LICENSE

⚠️ 声明与免责（重要）

使用本软件即表示您已阅读并同意以下条款：

1. 用途限制 本项目仅供个人学习、研究、技术交流使用，不得用于商业用途，也不得用于任何违反法律法规或第三方平台服务条款的用途。

2. 账号与风控风险 本项目通过浏览器自动化（CDP）访问各 AI 的网页免费端，并非各厂商的官方 API，与各厂商不存在任何授权或合作关系。自动化方式访问网页端可能违反相关平台的服务条款（ToS），并可能触发风控，导致账号被限制、封禁等后果。请务必使用您本人的账号，并自行承担由此产生的全部风险与损失。

3. 商标与版权

• 文中出现的所有产品名称、商标、Logo（如 Gemini、ChatGPT、Claude、通义千问、Kimi、MiniMax、智谱清言、豆包、DeepSeek 等）均归各自所有者所有，此处仅用于说明兼容性，不构成任何关联、授权或背书。

• 本项目基于 AgentChat（MIT 协议）二次开发，已保留其版权声明与归属。

• 如您认为本项目中的任何内容侵犯了您的著作权、商标权、专利权或其他合法权益，请通过 GitHub Issue 联系作者，一经核实，我们将立即删除相关内容。

4. 合规与法律 使用者须自行遵守所在国家/地区的法律法规及各 AI 平台的服务条款。因违反上述约定产生的任何法律后果，由使用者本人承担，作者与贡献者不承担任何责任。

5. 无担保与责任限制 本项目按 MIT 协议以"原样"（AS-IS）提供，不含任何明示或暗示的担保（包括但不限于适销性、特定用途适用性、非侵权性）。在任何情况下，作者或贡献者均不对因使用本软件或其相关内容而产生的任何直接、间接、附带、特殊或后果性损害承担责任。

🤝 贡献

欢迎 PR。daemon 核心复用 AgentChat 的 skills/lib——如果发现某个 provider adapter 需要更新（UI 漂移），也请把选择器修复上提到原仓 AgentChat。

📜 License

MIT © Amengclass。基于 AgentChat（MIT © ziwang-Physics）。详见上方「声明与免责」章节。