项目简介
一个Claude Code技能，用于对网站进行生成引擎优化（GEO）审计和优化。它评估AI可引用性、检查爬虫访问、分析品牌权威、验证结构化数据，并生成PDF报告供客户使用。
README 预览
\n \n\n\n\n GEO-first, SEO-supported. Optimize websites for AI-powered search engines\n (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.\n\n\n\n AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.\n\n\n---\n\n## Star History\n\n\n \n \n \n \n\n\n---\n\n## Why GEO Matters (2026)\n\n| Metric | Value |\n|--------|-------|\n| GEO services market | $850M+ (projected $7.3B by 2031) |\n| AI-referred traffic growth | +527% year-over-year |\n| AI traffic conversion rate vs organic | 4.4x higher |\n| Gartner: search traffic drop by 2028 | -50% |\n| Brand mentions vs backlinks for AI | 3x stronger correlation |\n| Marketers investing in GEO | Only 23% |\n\n---\n\n## Quick Start\n\n### One-Command Install (macOS/Linux)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash\n```\n\n### Manual Install\n\n```bash\ngit clone https://github.com/zubair-trabzada/geo-seo-claude.git\ncd geo-seo-claude\n./install.sh\n```\n\n### Windows (Git Bash)\n\nRequires [Git for Windows](https://git-scm.com/downloads) which includes Git Bash.\n\n```bash\n# Option 1: One-command install (run from Git Bash, not PowerShell/CMD)\ncurl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash\n\n# Option 2: Manual install\ngit clone https://github.com/zubair-trabzada/geo-seo-claude.git\ncd geo-seo-claude\n./install-win.sh\n```\n\n> **Note:** Right-click the folder and select "Open Git Bash here", or open Git Bash and navigate to the directory. Do not use PowerShell or Command Prompt.\n\n### Requirements\n\n- Python 3.8+ (on Debian/Ubuntu also `python3-venv`)\n- Claude Code CLI\n- Git\n- Optional: [`uv`](https://docs.astral.sh/uv/) — if present, the installer uses it for a faster dependency install\n- Optional: Playwright (for screenshots)\n\n### Isolated install\n\nPython dependencies are
常见问题 (3)
故障排除在 macOS 上运行 install.sh 时如何修复 'No matching distribution found for Pillow>=12.1.0' 错误？
安装程序正在使用 macOS 系统自带的 Python 3.9.6，但锁定的依赖包要求 Python 3.10 或更高版本。请安装更新版本的 Python，并确保在安装过程中 python3 解析到该版本：
brew install python@3.12
rm -rf ~/.claude/skills/geo
mkdir -p /tmp/pybin
ln -sf "$(brew --prefix python@3.12)/bin/python3.12" /tmp/pybin/python3
export PATH="/tmp/pybin:$PATH"
python3 --version # 必须显示 Python 3.10+
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash安装程序的永久修复方案是：探测带版本号的解释器，例如 python3.13、python3.12、python3.11 和 python3.10，仅接受满足 sys.version_info >= (3, 10) 的解释器，并将前置要求提示从 Python 3.8+ 更新为 Python 3.10+。
故障排除为什么 schema audit 无法检测到位于 HTML <head> 中的 JSON-LD 标记？
审计失败的原因是 WebFetch 在 HTML 到 Markdown 转换过程中会剥离 <head> 内容，而 JSON-LD schema 块通常放置在 <head> 中。修复方法是使用 fetch_page.py 进行页面获取和 schema 检测，而不是 WebFetch，因为它能正确提取 JSON-LD。更新 geo-schema 代理和技能以调用 fetch_page.py，然后重新运行审计。
故障排除如何修复运行 /geo-audit 时出现的 "Agent type 'geo-citability' not found" 错误？
/geo-audit 命令引用了两个未在安装中注册的智能体类型：geo-citability 和 geo-brand-mentions。这是命令与智能体注册不匹配的问题，与网页或您的输入无关。作为临时解决方案，请改用以下可用的 geo 智能体之一：geo-ai-visibility、geo-content、geo-platform-analysis、geo-schema 或 geo-technical。请更新到最新版本或重启智能体环境；如果最新版本仍未列出这些缺失的智能体，则仓库必须注册或添加它们。