GeoLook快速上手:3步跑起本地GEO监测看板,免费开源、零API Key也能用
GeoLook快速上手:3步跑起本地GEO监测看板,免费开源、零API Key也能用
GeoLook 是一款免费开源、自托管的 GEO(Generative Engine Optimization,生成式引擎优化)实施平台。它能监测 ChatGPT、DeepSeek、豆包、Perplexity 等 AI 引擎在回答真实问题时是否提到并引用你的品牌,把"AI 里搜不到我们"这个黑盒问题,变成一份可量化、可执行、可验收的本地 GEO 监测看板。
只需 3 步、约 5 分钟,就能在自己的电脑上跑起来:装 3 个依赖、启动一条命令、浏览器自动打开。不配置任何 API Key 也能完整使用——抓站体检、诊断、工单、资产生成全部照常,只有"AI 答案自动采样"这一步会跳过(可改用人工采样表补上)。
🚀 三步启动本地GEO监测看板
第一步:克隆仓库并安装依赖
环境要求很低:macOS / Linux(Windows 用 WSL),Python 3.9+,全部依赖只有 3 个第三方包。
git clone https://gitcode.com/gh_mirrors/ge/geolook
cd geolook
pip3 install requests beautifulsoup4 lxml
第二步:一条命令启动看板
python3 scripts/geo.py ui
服务默认只绑定本机 127.0.0.1:8765,数据全部留在本机 work/ 目录(JSON/Markdown 文件,git init 一下就是备份),无数据库、无账号、断网可用。浏览器会自动打开,首次进入是三步接入引导:填官网域名 → 选目标市场(国内 / 海外 / 双市场)→ 点「创建并开始自动引导」,首期周期在后台自动跑完,关掉页面任务照跑。
macOS 用户还可以多注册一个常驻服务,登录自启、崩溃自动拉起、关终端不停:
./scripts/service.sh install
第三步:(可选)配置引擎 API Key
配置入口在 设置 → 引擎与密钥,点「配置」即可写入本地 .env,也可 cp .env.example .env 手动编辑。支持豆包、智谱GLM、DeepSeek、Kimi、MiniMax、Gemini、OpenAI、Claude、Grok、Perplexity 共 10 个可自动采样的引擎。
💡 一个 Key 都不配也能用:自动采样会跳过,改用「导出人工采样表 → 浏览器人工提问 → 回灌」的流程,与自动采样共用同一套指标。只配一个国内引擎 Key(如 DeepSeek/GLM),即可额外解锁「自动推导问题库/品牌事实」和「AI 初稿」功能。
📊 看板跑起来之后能看什么
总览:一句话结论 + GEO健康分
「总览」页顶部是由数据自动生成的一句结论(例如"AI 从未无提示提及你的品牌"),下面是 GEO 健康分(提及率、引用份额、阵地、内容、事实五个维度加权,未测项显示"未测",绝不编数),以及"下一步 3 件事"优先级清单,点开直接跳转到对应工单。
「引擎表现」页可逐引擎下钻:每个引擎的提及率、提及位次、引用份额、它实际引用了谁,还能回放真实回答原文(品牌命中高亮),发现 AI 说错的地方可当场记一条事实偏差。
诊断:四层依赖链站点体检
「站点体检」按 访问 → 定向 → 理解 → 可引用 四层依赖链组织——访问层失败时,下游一切优化在 AI 引擎侧都不可见,所以修复顺序会自动算好。它远不止查 robots:会用真实 AI 爬虫 UA 探测 WAF/CDN 差异(robots 放行但 CDN 直接 403,浏览器里根本看不出来),并做段落级可引分析——整页没有一段"自包含可被引用"的页面会被点名,右侧还列出了全站缺失最多的抽取块(定义块、FAQ、数字事实……)及对应修复工单。
配套还有「差距诊断」(内容 / 阵地 / 事实三类缺口按先修哪个排序)和「阵地地图」(19 个阵地按真实引用语料标注优先级——官网只占国内 AI 引用的 1.37%,外部阵地才是引用来源)。
执行:行动计划工单 + 内容工作台
诊断结果会生成结构化工单(依据 / 负责角色 / 工作量 / 时间窗口 / 验收标准 + 独立风险分级),按 P0→P1 领取执行。内容工作台里,选题池按"未提及 + 无内容"排序,写稿时左侧给必含抽取块与品牌事实,右侧实时做可被引用度预检,成稿后还有分发清单告诉你该铺到哪些阵地。
「部署资产」页一键产出 llms.txt、JSON-LD、定义块/FAQ 的 HTML 片段(每个文件顶部标好去处);「发布」页支持 GitHub、WordPress 草稿、公众号草稿箱、X、Reddit 等渠道,每篇发布都需人工确认,无任何自动外发路径。
验收:用数据证明"AI 真的改了口"
「效果验收」页展示逐题 before/after 提及率对比(全部/国内/海外分 tab)+ 任务级验收历史。工单验收靠"重抓站点"这类确定性信号,回归了自动打回——做没做完不靠口头确认。归因纪律也写得很直白:单期波动只作观察相关,连续两期同向变化才算趋势。
💡 上手小贴士
- 升级很简单:
git pull即可,你的数据都在work/与.env(已被 gitignore),升级不影响 - 常用命令速查:
new(一条命令全自动)、cycle(轻量循环)、sample-sheet/sample-import(人工采样表导出/回灌)、verify(自动验收)、deliver(打包客户交付物),每条命令--help有完整参数 - 无 API 的引擎(纳米AI、百度AI、ChatGPT 网页版等):配套 Chrome 采样助手插件(侧栏载入队列 → 一键提取答案与引用 → 回传本机看板),每周核查从约 30 分钟压到 10 分钟,安装说明见 extension/README.md
- 评分依据不靠玄学:六个体检维度全部锚定公开实证数据(602 条 Prompt / 21,143 条引用),方法论全文见 references/method.md
- 远程部署:推荐 SSH 隧道
ssh -N -L 8765:127.0.0.1:8765 user@your-server,不暴露任何端口;公网部署需令牌 + HTTPS 反向代理
📚 进一步阅读
| 资料 | 路径 |
|---|---|
| 中文完整文档(功能全景 / 部署教程 / FAQ) | README.zh-CN.md |
| 方法论与全部判据出处 | references/method.md |
| 国内信源实测引用榜 | references/cn-source-ranking.md |
| 可抽取内容模板 | references/content-patterns.md |
| CLI 总入口 | scripts/geo.py |
| 看板服务与前端 | scripts/dashboard.py · scripts/ui.html |
| Chrome 采样助手插件 | extension/ |
| 全部界面截图 | docs/screenshots/ |
GeoLook 是单机工具、无账号体系,这是刻意的设计取舍:数据全在你手里,工具免费,只花你自己的引擎 API 采样费(可以为零)。现在就克隆下来,5 分钟看到你的品牌在 AI 里的真实位置吧 🔍





