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工具

典型工作流

  1. 审计 – geo audit --url https://yoursite.com → 评分 + 优先列表。
  2. 修复预览 – geo fix --url … 显示将创建哪些文件。
  3. 应用 – 添加--apply写入文件,重新运行审计查看新估计。
  4. CI门禁 – 添加GitHub Action或在管道中运行geo audit --threshold 70。
  5. 监控 – 启用免费托管监控或运行geo track --url … --report获取定期HTML报告。

许可证与社区

  • 许可证: MIT – 免费用于商业或个人用途。
  • 包统计: 每月约2,000+次下载,CI徽章显示活跃测试。
  • 星标: ⭐ 在GitHub上(截至README)。
  • 文档: /docs/包含命令指南、JSON契约、评分标准和提供商设置。

结论

geo-optimizer-skill是一个功能齐全的开源引擎,让任何人都能量化并改进生成式AI模型如何发现和引用网站。它连接了SEO和以LLM为中心的“搜索工程”,提供用于临时检查的CLI以及用于CI、MCP代理和静态站点生成器的集成。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目