Albert-Weasker/niubigeo

项目介绍

NiubiGEO 是一个面向 GEO（生成式引擎优化）的自托管研究工作台。为某个域名建立项目后，可选择多个模型进行测试，记录每个模型对产品的描述、提到的竞品、关联关键词以及返回的来源。每条结果都保留原始回答、执行条件和失败记录，使一次曝光观察可以回溯到产生它的回答。

v0.3 版本新增独立的关键词监控模块：自定义或批量导入提示词，按 Discovery、Alternative、Comparison、Brand、Use case 分类，以小时、天或周为频率定时运行，再用 Diff View 比较两次存储记录中新增或消失的推荐、名次变化和来源链接。目标用户是产品、市场与开发者团队，希望看到原始证据而不是一个不透明的分数。

快速使用

不安装即可先看 20 个真实案例的测试条件、原始回答与截图（案例集）。测试自己的产品需要 Node.js 22.13+ 和自备的 OpenRouter API Key。

git clone --branch v0.3.3 --depth 1 https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
npm ci
cp .env.example .env

在 .env 中设置 OPENROUTER_API_KEY，然后启动：

npm run server

打开 http://localhost:8787，用域名创建项目，选择模型并逐个设置是否启用联网搜索，保存配置后发起测试。结果返回后逐条打开回答，检查描述、竞品、关键词和引用来源。容器部署可参考 Docker 指南；定时监控需要监控 worker 处于运行状态。

使用约束

• 模型、搜索和托管费用与开源许可分离，测试会消耗你自己的服务商额度。
• 只观察 Provider API 的响应，不覆盖消费级聊天界面；离线与联网测试结果需分开解读，也不包含传统搜索引擎排名跟踪。
• 部分功能依赖服务商能力：结构化分析需要 JSON Schema 支持，自定义搜索支持被标注为未经验证。
• v0.3 暂无独立的竞品检测面板；更换模型选择时，已有历史记录会保留。
• README 中的可选顾问卡片会跳转到外部视频服务，可用 NIUBIGEO_VIDEO_ADVISOR_ENABLED=false 关闭。
• 采用 Apache-2.0 许可证。

HotRepo 点评

2026-11-08 的快照显示，该项目在 GitHub TypeScript 日榜单日新增 1,307 Star、位列第 4，累计 10,138 Star、815 Fork。对一个 2026 年 9 月创建、已迭代到 v0.3.3 的工具来说，这是较强的单次记录。它的差异化在于把原始模型回答与引用放在聚合曝光数字之前，并以自托管和自带 Key 为默认方式；关键词监控 beta 在真实定时任务下是否稳定，是后续版本值得关注的观察点。