Auriti-Labs/geo-optimizer-skill
GEO Optimizer, the open-source engine behind GeoReady (geoready.dev): audit whether ChatGPT, Perplexity, Gemini & Google AI Overviews cite your site. CLI, Python, MCP.
📦 geo-optimizer-skill – AI可见性审计与修复工具
它是什么 – 一个开源Python包(MIT许可),以0-100分评估生成式AI答案引擎(ChatGPT、Perplexity、Gemini、Claude、Google AI Overviews)抓取、理解和引用网站的难易程度。然后生成具体、优先排序的修复方案(robots.txt、llms.txt、JSON-LD schema、meta标签等)。
为什么重要 – 传统SEO关注Google排名,但LLM驱动的答案引擎只引用少数“源就绪”网站。此工具包让开发者、SEO团队或CI管道能够衡量并提升答案引擎优化(AEO)/ 生成式引擎优化(GEO)就绪度。
快速开始(零安装)
uvx --from geo-optimizer-skill geo audit --url https://example.com
秒级运行,无需API密钥。
或正常安装:
pip install -U geo-optimizer-skill
geo audit --url https://example.com # 评分 + 修复
geo fix --url https://example.com # 预览/写入修复文件
geo audit --url https://example.com --threshold 70 # 如果分数 < 70 则退出码为1(CI门禁)
核心功能(如README所列)
| 类别 | 工具功能 |
|---|---|
| 评分 | 0-100 AI可见性评分,涵盖9个类别(robots.txt、llms.txt、schema、meta、内容、品牌、信号、AI发现、Google AI就绪度)。 |
| 修复生成 | geo fix 创建可直接发布的文件:27个AI机器人的robots.txt规则、llms.txt、JSON-LD片段、meta标签等。 |
| CLI丰富性 | 16个命令(audit、fix、diff、history、drift、monitor、citations、snapshots、track、llms、schema、coherence、authority、logs、access、perception)。 |
| CI/CD集成 | GitHub Action(Auriti-Labs/geo-optimizer-skill@vX),低于可配置分数时构建失败,并输出SARIF/JUnit报告。 |
| MCP服务器 | 可选[mcp]额外安装,提供12个“工具”端点,可从Claude、Cursor、Windsurf等使用。 |
| Python API | from geo_optimizer import audit; result = audit(url) 返回score、band、citability.total_score、细分和推荐列表。 |
| Astro集成 | 在构建时为静态站点生成llms.txt、/.well-known/ai.txt和/ai/summary.json。 |
| 监控与历史 | geo history、geo drift、geo track 可记录随时间变化的分数、检测回归,并通过托管的geoready.dev服务接收邮件漂移警报。 |
| 引用检查 | geo citations 查询真实答案引擎(OpenAI、Anthropic、Perplexity、Gemini、SerpBase),查看您的品牌/域名是否被引用,并带多轮置信区间。 |
| 可扩展性 | 插件入口点(geo_optimizer.checks)用于自定义检查;提供示例插件。 |
安装选项
| 方法 | 命令 | 使用场景 |
|---|---|---|
| 零安装 | uvx --from geo-optimizer-skill geo … |
快速一次性审计,无需Python环境 |
| Pip | pip install -U geo-optimizer-skill |
常规使用、CI管道 |
| 额外功能 | pip install "geo-optimizer-skill[mcp]" |
需要用于LLM代理的MCP工具 |
典型工作流
- 审计 –
geo audit --url https://yoursite.com→ 评分 + 优先列表。 - 修复预览 –
geo fix --url …显示将创建哪些文件。 - 应用 – 添加
--apply写入文件,重新运行审计查看新估计。 - CI门禁 – 添加GitHub Action或在管道中运行
geo audit --threshold 70。 - 监控 – 启用免费托管监控或运行
geo track --url … --report获取定期HTML报告。
许可证与社区
- 许可证: MIT – 免费用于商业或个人用途。
- 包统计: 每月约2,000+次下载,CI徽章显示活跃测试。
- 星标: ⭐ 在GitHub上(截至README)。
- 文档:
/docs/包含命令指南、JSON契约、评分标准和提供商设置。
结论
geo-optimizer-skill是一个功能齐全的开源引擎,让任何人都能量化并改进生成式AI模型如何发现和引用网站。它连接了SEO和以LLM为中心的“搜索工程”,提供用于临时检查的CLI以及用于CI、MCP代理和静态站点生成器的集成。
相关
- 项目
- 项目
- 项目
- 项目
- 项目