项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1297
使用教程
环境要求
- 可访问的目标网站地址（如 https://yoursite.com）
- 零安装方式需要本机已安装 uv（提供 uvx 命令）
- 本地安装方式需要 Python 环境与 pip
- citations 引用追踪命令需自备 AI 服务商的 API key
安装与启动步骤
-
1零安装直接试跑
用 uvx 免安装运行审计，适合先快速看结果再决定是否安装。
uvx --from geo-optimizer-skill geo audit --url https://yoursite.com -
2安装到本地
用 pip 安装并升级到最新版，之后可直接使用 geo 命令。
pip install -U geo-optimizer-skill -
3审计网站得分
输出 0–100 评分和按优先级排列的修复清单。
geo audit --url https://yoursite.com -
4预览修复方案
预览 robots.txt、llms.txt、schema、meta 的修改建议，默认不改动线上文件，加 --apply 才写入。
geo fix --url https://yoursite.com -
5当作 CI 门槛
设定阈值，低于该分数时命令以退出码 1 结束，可用于流水线卡口。
geo audit --url https://yoursite.com --threshold 70 -
6追踪 AI 引用
查询 AI 回答中是否提及你的品牌与域名，需要自备 API key。
geo citations --brand "Acme" --domain acme.com
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--url | 是 | 要审计或修复的目标网站地址 | https://yoursite.com |
--threshold | 否 | 评分低于该值时命令返回退出码 1，默认无阈值 | 70 |
--brand | 是 | citations 命令要追踪的品牌名 | "Acme" |
--domain | 是 | citations 命令要追踪的域名 | acme.com |
--topic | 否 | 限定产品类别主题，让引用查询更聚焦 | "your product category" |
--runs | 否 | 同一查询重复采样次数，用于给出置信区间 | 5 |
如何确认成功
命令正常输出 0–100 的评分与修复建议列表（或引用追踪结果），即表示执行成功。
常见问题
Q：不想安装任何东西能用吗？
A：可以，README 提供零安装方式：uvx --from geo-optimizer-skill geo audit --url https://yoursite.com，只需本机有 uv。
Q：怎么判断分数是否达标？
A：加 --threshold 70，分数低于 70 时命令退出码为 1，可直接作为 CI 构建失败条件。
Q：geo fix 会直接改我的网站吗？
A：默认只是预览 robots.txt、llms.txt、schema、meta 的修改内容，需显式加 --apply 才会写入。
Q：citations 为什么取不到结果？
A：该命令需要你自己提供 AI 服务商的 API key（bring your own API key），未配置密钥时无法查询。
Q：多次运行 citations 结果不一致？
A：AI 回答每次都有差异，可用 --runs 5 对同一查询采样 5 次得到置信区间。
注意事项
- geo fix 默认只预览改动，加 --apply 才会真正写入。
- citations 引用追踪需要自备 API key，属于额外成本项。
- AI 回答逐次不同，判断引用情况建议用 --runs 多次采样。
- 除 CLI 外项目还提供 Python 库、MCP 服务、GitHub Action 与 Astro 集成，按需选择。
核心亮点
- 覆盖主流AI引擎：同时支持ChatGPT、Perplexity、Gemini和Google AI Overviews，一站式追踪引用来源
- 提供多形态接入：既有CLI和Python库，也支持MCP协议和Astro组件，可嵌入现有内容工作流
- 从审计到追踪闭环：不仅诊断内容可被AI引用的程度，还持续监控引用变化，便于验证优化效果
不足之处
- 早期项目，API和功能可能不稳定，文档和社区支持有待观察
- AI引擎引用机制频繁变化，追踪结果的准确性和时效性需要持续维护
适用场景
- 内容营销团队监控品牌在AI回答中的提及率
- SEO顾问为客户网站做AI可见性审计并出具优化建议
- 开发者将GEO追踪集成到自己的内容发布或分析工具中
替代项目
Cognition AI's GEO tool、RankScience、Profound GEO
同类项目推荐
Lore
开源
一键唤起，本地 AI 帮你整理并检索所有记忆。
Summon it with a keystroke, throw in anything you want to remember or ask your own m···
medical-rag
开源
一键搭中文医学知识库，问答有据可查
医学中文RAG项目，使用langchain+milvus，支持快速一键式部署，支持无缝领域迁移
rag-in-action
开源
跟着实操项目，吃透 RAG 全流程，搞定业务落地
End-to-end RAG system design, evaluation, and optimization. 极客时间RAG训练营，RAG 1···
search_with_lepton
开源
用对话代替关键词，快速搭建智能搜索演示
Building a quick conversation-based search demo with Lepton AI.
rag-zero-to-hero-guide
开源
从零到一，手把手带你玩转RAG应用开发
Comprehensive guide to learn RAG from basics to advanced.
llm-arxiv-daily
开源
每天自动收 arXiv 大模型论文，不用手动刷
Automatically update arXiv papers about LLM Reasoning, LLM Evaluation, LLM & MLLM an···
arona
开源
给文档站加一个能听懂人话的 AI 搜索
Elysia AI doc search
JavaScript-AI-Buildathon
开源
参与挑战，用 JavaScript 快速构建你的 AI 应用
blog
开源
用博客记录技术成长，一键部署到GitHub Pages
:memo: 记录个人博客，见证成长之路 https://wangtunan.github.io/blog/