eGEOagents

<div align="center"> <!-- HERO BANNER --> <img src="assets/hero-banner.png" alt="E-GEO: 排名第一的AI搜索引擎" width="100%" /> <br /> # 🌍 E-GEO ### **生成引擎优化（GEO）** 和 **答案引擎优化（AEO）** 用于AI驱动的搜索 <p> <a href="https://github.com/mverab/eGEOagents/actions/workflows/ci.yml"><img src="https://github.com/mverab/eGEOagents/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License" /></a> <a href="https://github.com/mverab/eGEOagents/stargazers"><img src="https://img.shields.io/github/stars/mverab/eGEOagents?style=social" alt="GitHub Stars" /></a> <a href="https://github.com/mverab/eGEOagents/network/members"><img src="https://img.shields.io/github/forks/mverab/eGEOagents?style=social" alt="GitHub Forks" /></a> <a href="https://github.com/mverab/eGEOagents/issues"><img src="https://img.shields.io/github/issues/mverab/eGEOagents" alt="Issues" /></a> <a href="https://arxiv.org/abs/2511.20867"><img src="https://img.shields.io/badge/arXiv-2511.20867-b31b1b.svg" alt="研究论文" /></a> </p> <p> <a href="https://claude.com/claude-code"><img src="https://img.shields.io/badge/Built%20with-Claude%20Code-8B5CF6?logo=anthropic" alt="Built with Claude Code" /></a> <a href="CONTRIBUTING.md#ai-transparency"><img src="https://img.shields.io/badge/🤖-AI--Assisted-blueviolet" alt="AI-Assisted" /></a> </p> <br /> > **🚀 一条命令，卓越效果。<br />在 **ChatGPT**、**Perplexity**、**Claude** 和 **Gemini** 中排名更高。** <br /> [**📖 文档**](docs/getting-started.md) • [**🐛 问题**](https://github.com/mverab/eGEOagents/issues) • [**💬 讨论**](https://github.com/mverab/eGEOagents/discussions) • [**📝 研究论文**](https://arxiv.org/abs/2511.20867) --- </div> <!-- AI TRANSPARENCY BADGE --> <p align="center"> _{🤖 <strong>AI辅助开发</strong> — <a href="CONTRIBUTING.md#ai-transparency">查看AI生成的内容</a>} </p> --- ## ✨ 什么是E-GEO？ <table> <tr> <td width="60%"> **E-GEO** 是一个开源的 **生成引擎优化（GEO）** 和 **答案引擎优化（AEO）** 工具包，可以将您的网站内容转换为在AI驱动的搜索引擎中排名更高的内容 — 包括 **ChatGPT**、**Perplexity**、**Google AI概览**、**Claude** 和 **Gemini**。 也被称为 **AI SEO** 或 **LLM SEO**，GEO是优化内容的实践，以便生成式AI引擎可以爬取、理解、引用和推荐它。E-GEO自动完成整个过程。 基于 [E-GEO研究论文](https://arxiv.org/abs/2511.20867)（arXiv:2511.20867），它应用了 **10个通用特征**，这些特征一致提高了AI引擎的排名 — 竞争性框架、引用优化、结构化数据和语义密度改进，都有同行评审的研究支持。 - ✅ **无学习曲线** — 一条命令即可优化 - ✅ **研究支持** — 基于同行评审的研究 - ✅ **生产就绪** — 复制粘贴优化内容 - ✅ **多引擎** — 为ChatGPT、Perplexity、Gemini、Claude和Google AI概览优化 - ✅ **全流程** — 分析 → 排名 → 重写 → 模式，一条命令搞定 </td> <td width="40%"> ```bash /geo https://yoursite.com/pricing ``` ↓ ``` geo-output/ ├── report.md ├── optimized/ │ └── pricing.md └── schema/ └── pricing.json ``` </td> </tr> </table> --- ## 📈 为什么AI可见性在2026年很重要 AI搜索引擎提供一个综合答案，并引用少数来源。如果您的网站不在其中，即使您在Google排名第一，也会变得不可见。 ``` 用户向ChatGPT提问：“最好的GEO工具是什么？” ChatGPT：“根据[竞争对手]，最好的工具是...” ↑ 他们被引用了，您没有。 ``` - **ChatGPT每周为9亿+用户提供服务** — 这是以前的Google搜索会话中越来越大的份额。 - **28.3%的ChatGPT最常引用的页面在Google上具有*零*有机可见性** （Ahrefs） — AI引擎奖励与经典SEO不同的信号。 - **适当的JSON-LD模式将LLM提取准确率从16%提高到54%** （Semrush关于GPT-4的研究）。 - **超过84万个网站** 已经提供了`llms.txt`文件。您的网站是其中之一吗？ 传统的SEO优化蓝色链接。 **GEO优化AI生成答案中的引用。** E-GEO是弥合这一差距的开源工具。 --- ## 🚀 快速入门（3步骤） ### 1. 安装 将 `.claude/` 文件夹复制到您的项目中： ```bash cp -r /path/to/eGEOagents/.claude . ``` ### 2. 激活 在Claude Code中，切换到GEO模式： ``` /output-style geo-optimizer ``` ### 3. 优化 运行您的第一个优化： ``` /geo https://yoursite.com ``` --- ## 🧩 安装为技能（skills.sh） 安装完整的技能集合： ```bash npx skills add https://github.com/mverab/eGEOagents ``` 仅安装一个技能： ```bash npx skills add https://github.com/mverab/eGEOagents --skill competitive-analysis ``` 在发布更新前验证解析器发现： ```bash npx skills add https://github.com/mverab/eGEOagents --list ``` 验证索引页面： - 集合： [skills.sh/mverab/egeoagents](https://skills.sh/mverab/egeoagents) - 所有者： [skills.sh/mverab](https://skills.sh/mverab) --- ## 📋 命令 | 命令 | 功能 | |---------|--------------| | `/geo <url>` | **全流程** - 分析、排名、重写、模式 | | `/geo:audit <url>` | 仅分析，无更改 | | `/geo:optimize <file>` | 优化本地内容文件 | | `/geo:batch <folder>` | 处理整个文件夹 | | `/geo:report` | 生成执行报告 | | `/geo:compete <query>` | 竞争分析 | --- ## 📊 您将获得的内容 运行 `/geo` 后： ``` geo-output/ ├── report.md # 执行摘要 + 分数 ├── analysis.json # 原始分析数据 ├── optimized/ │ └── pricing.md # 重写内容（可直接使用） ├── schema/ │ └── pricing.json # JSON-LD标记（复制到站点） └── checklist.md # 分步实施 ``` --- ## 🎯 研究支持的结果 E-GEO基于 [E-GEO研究论文](https://arxiv.org/abs/2511.20867)（arXiv:2511.20867）的同行评审研究，构建在 [Aggarwal等人（普林斯顿，KDD 2024）](https://arxiv.org/abs/2311.09735)的基础工作之上 — 最初定义生成引擎优化为一门学科的研究。 E-GEO论文报告： 1. **竞争框架** 在所有测试的GEO策略中产生了最强的立即排名提升。 2. **通用优化策略** （应用所有10个特征）比单个启发式方法具有显著优势。 3. **10个GEO特征** （排名强调、用户意图匹配、竞争优势、社会证明、权威信号、可扫描性、引用密度、结构化数据、事实语言和新鲜度）始终出现在ChatGPT、Perplexity和Gemini的排名更高的内容中。 | 特征 | E-GEO的作用 | |---------|-----------------| | **排名强调** | 将您的内容定位为首选 | | **用户意图** | 直接回答用户的问题 | | **竞争优势** | 突出您的独特优势 | | **社会证明** | 整合信任信号和推荐 | | **权威** | 建立专家、自信的语气 | | **可扫描性** | 结构化以便于AI解析 | 结果因内容质量和竞争而异。有关完整的方法论和发现，请参阅论文： [arXiv:2511.20867](https://arxiv.org/abs/2511.20867)。 --- ## 🧪 可复制的结果 E-GEO提供了一个评估工具包，以便您自己衡量提示质量 — 无需信任。 它评估GEO重写器是否将目标项目 **提升** 在LLM模拟排名中。 ```bash pip install pyyaml jsonschema # 确定性、离线烟雾测试（无需API密钥） GEO_EVAL_MOCK=1 python geo_eval.py evaluate \ --dataset eval/datasets/geo_smoke.jsonl --limit 5 --verbose ``` 这是 [CI](.github/workflows/ci.yml) 中每次拉取请求运行的确切检查。报告的指标： `avg_rank_improvement`、`win_rate` 和 `stderr_rank_improvement`。 > **诚实的范围：** 这些数字是 **代理** 由LLM排名器生成的，而不是实际ChatGPT/Perplexity排名的衡量标准。参见 > **[docs/evaluation.md](docs/evaluation.md)** 以获取完整的方法论、指标定义和局限性。 --- ## 🖥️ 独立CLI（`egeo`） 除了Claude Code之外，E-GEO还提供了一个 **运行时无关的命令行** ，因此相同的GEO引擎可以在Python运行的任何地方运行 — 本地shell、笔记本、Docker或CI。 CLI是 `geo_eval.py` 和 `llm_client.py` 模块的薄包装器，与Claude Code代理使用的 **完全相同** ，因此没有 **重复的优化逻辑** — 两个运行时共享一个真实源。 ### 安装 ```bash # 从存储库根目录 — 安装`egeo`控制台脚本+依赖项 pip install -e . # ... 或在不安装依赖的情况下运行（依赖项：pip install pyyaml jsonschema） python -m egeo --help ``` ### 命令 | 命令 | 功能 | |---------|--------------| | `egeo optimize <file>` | **全流程** — 分析 → 排名 → 重写 → 模式，写入 `report.md`、`optimized/*.md`、`schema/*.json`、`analysis.json` | | `egeo evaluate` | 运行评估工具包（重用 `geo_eval.py`，相同的指标） | | `egeo optimize-prompts` | 元优化重写提示（默认情况下非破坏性） | | `egeo runtimes` | 列出可用的运行时适配器及其状态 | ```bash # 优化本地内容文件（输出目录默认为./geo-output） egeo optimize examples/sample-input.md --out-dir ./geo-output # 在数据集上评估提示质量 egeo evaluate --dataset eval/datasets/geo_smoke.jsonl --limit 5 # 检查运行时适配器 egeo runtimes ``` ### 离线/确定性模式 每个命令都支持 `GEO_EVAL_MOCK=1`，它交换了一个确定性模拟LLM客户端 — **无需API密钥** 。这是 [CI](.github/workflows/ci.yml) 中执行的确切操作： ```bash GEO_EVAL_MOCK=1 egeo optimize examples/sample-input.md --out-dir /tmp/egeo GEO_EVAL_MOCK=1 egeo evaluate --dataset eval/datasets/geo_smoke.jsonl --limit 3 ``` ### 支持的运行时 E-GEO公开了一个小型 **运行时适配器** 层，以便相同的代理（分析器、排名器、重写器、索引器）可以由不同的执行主机驱动： | 运行时 | 别名 | 模式 | 状态 | 描述 | |---------|---------|------|:------:|-------------| | **`python`** | `cli`, `local` | 进程内 | ✅ 可用 | `egeo` CLI背后的纯Python运行时。 在进程内运行整个管道，并支持 `GEO_EVAL_MOCK` 进行离线、确定性运行。 | | **`claude-code`** | `claude` | 主机执行 | ✅ 可用 | 通过Claude Code `/geo` 斜线命令在主机上执行 `.claude/` 代理。 自动检测到 `.claude/` 目录存在时。 | > 运行 `egeo runtimes` 以打印环境中每个适配器的实时状态。 可以通过实现 `RuntimeAdapter` 接口在 [`egeo/runtimes.py`](egeo/runtimes.py) 中添加额外的主机。 --- ## 🆚 E-GEO与其他GEO工具的比较 | 功能 | E-GEO | GEO Optimizer | GEO-optim/GEO | Awesome GEO | 传统SEO | |---------|-------|---------------|---------------|-------------|----------------| | **类型** | CLI + Claude Code | CLI + MCP | 研究仓库 | 曲目列表 | — | | **内容重写** | ✅ 全流程 | ⚠️ 仅审计 | ❌ | ❌ | ❌ 无 | | **AI排名模拟** | ✅ 基于LLM | ❌ | ❌ | ❌ | ❌ 无 | | **模式生成** | ✅ 自动JSON-LD | ⚠️ 部分 | ❌ | ❌ | ❌ 手动 | | **竞争分析** | ✅ 内置 | ❌ | ❌ | ❌ | ❌ 无 | | **学术基础** | ✅ [arXiv:2511.20867](https://arxiv.org/abs/2511.20867) | ✅ KDD 2024 | ✅ 原始GEO论文 | ❌ | ❌ 启发式 | | **多运行时** | ✅ Python + Claude Code | ✅ Python + MCP | ❌ | ❌ | ❌ | | **llms.txt 支持** | ✅ | ✅ | ❌ | 📖 列表 | ❌ | | **成本** | 免费 / MIT | 免费 / MIT | 免费 | 免费 | 昂贵 | | 特征 | E-GEO | GEO Optimizer | GEO-optim/GEO | Awesome GEO | 传统SEO | |---------|-------|---------------|---------------|-------------|----------------| | **类型** | CLI + Claude Code | CLI + MCP | 研究仓库 | 曲目列表 | — | | **内容重写** | ✅ 全流程 | ⚠️ 仅审计 | ❌ | ❌ | ❌ 无 | | **AI排名模拟** | ✅ 基于LLM | ❌ | ❌ | ❌ | ❌ 无 | | **模式生成** | ✅ 自动JSON-LD | ⚠️ 部分 | ❌ | ❌ | ❌ 手动 | | **竞争分析** | ✅ 内置 | ❌ | ❌ | ❌ | ❌ 无 | | **学术基础** | ✅ [arXiv:2511.20867](https://arxiv.org/abs/2511.20867) | ✅ KDD 2024 | ✅ 原始GEO论文 | ❌ | ❌ 启发式 | | **多运行时** | ✅ Python + Claude Code | ✅ Python + MCP | ❌ | ❌ | ❌ | | **llms.txt 支持** | ✅ | ✅ | ❌ | 📖 列表 | ❌ | | **成本** | 免费 / MIT | 免费 / MIT | 免费 | 免费 | 昂贵 | > **E-GEO 是唯一一款将内容重写、排名模拟和模式生成结合在一个管道中的开源GEO工具。** 其他工具专注于审计或列表 — E-GEO完成整个优化过程。 --- ## 💎 高质量输出 E-GEO 提供的高质量输出就像来自一家价值1亿美元的公司： ``` ┌─────────────────────────────────────────────────────────────┐ │ 🎯 GEO 审计报告 │ ├─────────────────────────────────────────────────────────────┤ │ URL: yoursite.com/pricing │ │ 分数: 78/100 │ │ 潜在排名: ████████░░ 78% │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ✅ 优势 │ │ • 清晰的价值主张 │ │ • 良好的内容结构 │ │ │ │ ⚠️ 差距 │ │ • 缺乏社会证明 → 添加用户数量 │ │ • 没有紧迫感信号 → 添加限时优惠 │ │ │ │ 📈 优先级行动 │ │ 1. 添加推荐语 (+15 分) │ │ 2. 包含价格比较 (+10 分) │ │ 3. 添加模式标记 (+5 分) │ │ │ └─────────────────────────────────────────────────────────────┘ ``` --- ## 🤖 工作原理 <div align="center"> <!-- 系统图 --> <img src="assets/egeo-agents.png" alt="E-GEO 多智能体系统" width="600" /> </div> <br /> E-GEO 使用 **4 个专门的AI代理** 由Claude Code编排： | 代理 | 功能 | 输出 | |:------|:-------------|:-------| | 🔍 **分析器** | 提取内容，评估GEO信号，识别差距 | `analysis.json` | | 📊 **排名器** | 模拟AI引擎排名，预测位置 | 基线分数 | | ✍️ **重写器** | 优化内容，同时保留品牌声音 | `optimized/*.md` | | 🗂️ **索引器** | 生成模式标记和技术资产 | `schema/*.json` | --- ## 📁 包含内容 ``` .claude/ ├── CLAUDE.md # 系统知识库 ├── output-styles/ │ └── geo-optimizer.md # 高级格式化模式 ├── agents/ │ ├── geo-analyzer.md # 内容分析 │ ├── geo-rewriter.md # 内容优化 │ ├── geo-ranker.md # 排名模拟 │ └── geo-indexer.md # 模式生成 ├── skills/ │ ├── competitive-analysis/ # 自动触发竞争对手分析 │ ├── content-scoring/ # 自动触发评分 │ └── schema-generator/ # 自动触发模式 └── commands/ ├── geo.md # 主命令 ├── geo-audit.md ├── geo-optimize.md ├── geo-batch.md ├── geo-report.md └── geo-compete.md ``` --- ## 🎁 完美适用 <table> <tr> <td align="center" width="20%"> 🚀<br /><strong> SaaS 创始人</strong><br />_{AI引擎流量} </td> <td align="center" width="20%"> 💼<br /><strong>B2B 市场营销人员</strong><br />_着陆页 </td> <td align="center" width="20%"> 🛍️<br /><strong>电子商务</strong><br />_产品描述 </td> <td align="center" width="20%"> ✍️<br /><strong>内容创作者</strong><br />_{AI可发现性} </td> <td align="center" width="20%"> 🏢<br /><strong>机构</strong><br />_{GEO 服务} </td> </tr> </table> --- ## 📚 文档 | 资源 | 描述 | |:---------|:------------| | 📖 **[入门指南](docs/getting-started.md)** | 逐步教程 | | ⚙️ **[工作原理](docs/how-it-works.md)** | 技术深入解析 | | ❓ **[FAQ](docs/faq.md)** | 常见问题解答 | | 🧩 **[skills.sh 指南](docs/skills-sh-playbook.md)** | 列表、排名和元数据检查清单 | | 🧪 **[评估工具](docs/evaluation.md)** | 数据集格式、命令、指标和诚实的局限性 | | 📝 **[使用指南](USAGE.md)** | 完整命令参考 | | 📝 **[研究论文](https://arxiv.org/abs/2511.20867)** | E-GEO背后的科学 | | 📜 **许可** --- ## 🤝 贡献 我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。 **快速贡献方式：** - 通过 [问题](https://github.com/mverab/eGEOagents/issues) 报告错误 - 提交功能请求 - 改进文档 - 分享您的GEO结果 --- ## 🔍 SEO & AI 搜索引擎词典 E-GEO涵盖了AI搜索引擎优化的全部范围。如果您正在搜索以下任何内容，您就来对了： | 术语 | 含义 | |------|---------------| | **GEO** (生成引擎优化) | 为ChatGPT、Perplexity、Gemini等AI答案引擎优化内容 | | **AEO** (答案引擎优化) | 构建内容以便AI引擎可以解析和引用 | | **AI SEO** | 适应AI驱动的搜索的传统SEO | | **LLM SEO** | 针对大型语言模型响应的优化 | | **AI可见性** | 您的品牌在AI生成的答案中出现频率和质量 | | **引用跟踪** | 监控AI引擎是否引用您的网站作为来源 | | **llms.txt** | 一个标准文件（类似robots.txt），告诉AI爬虫器优先处理哪些内容 | --- ## 📜 许可 MIT 许可 - 可以使用、修改、出售。有关详细信息，请参阅 [LICENSE](LICENSE)。 --- ## 🙋 支持与社区 - **问题：** [GitHub 问题](https://github.com/mverab/eGEOagents/issues) - **讨论：** [GitHub 讨论](https://github.com/mverab/eGEOagents/discussions) - **研究：** [E-GEO 论文 (arXiv:2511.20867)](https://arxiv.org/abs/2511.20867) --- ## 🚀 准备好提升排名？ <div align="center"> ```bash # 安装 cp -r eGEOagents/.claude . # 激活（在Claude Code中） /output-style geo-optimizer # 优化您的第一个页面 /geo https://yoursite.com ``` <br /> <a href="https://github.com/mverab/eGEOagents"> <img src="https://img.shields.io/badge/⭐-Star%20on%20GitHub-yellow?style=for-the-badge&logo=github" alt="Star on GitHub" /> </a> <br /><br /> --- **为AI-first网络构建 — 使用E-GEO优化您的内容以适应ChatGPT、Perplexity、Claude和Gemini。 🌐** _{由 <a href="https://verabadias.gumroad.com/">Vera Badias</a> 制作 • 基于 <a href="https://arxiv.org/abs/2511.20867">arXiv:2511.20867</a> 的研究} _{🤖 该项目由AI辅助。有关详细信息，请参阅 <a href="CONTRIBUTING.md#ai-transparency">AI透明度</a>。} </div>