SkillPkg Logo
如需下载,请在电脑端打开本页操作。
README.md

GEO 优先,SEO 兜底。为 AI 驱动的搜索引擎优化你的网站 (ChatGPT、Claude、Perplexity、Gemini、Google AI Overviews),同时保留传统 SEO 基础。

AI 搜索正在蚕食传统搜索。这个工具帮你优化流量去向的那一端,而不是流量来的那一端。


为什么 GEO 至关重要(2026)

指标数据
GEO 服务市场规模$8.5 亿+(预计 2031 年达 $73 亿)
AI 引荐流量增长同比增长 +527%
AI 流量转化率 vs 自然搜索高出 4.4 倍
Gartner 预测:到 2028 年传统搜索流量将下降-50%
AI 搜索中品牌提及 vs 反向链接相关性强 3 倍
目前正在投入 GEO 的营销人员仅 23%

快速开始

一行命令安装(macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash

手动安装

git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh

Windows(Git Bash)

需要安装 Git for Windows,自带 Git Bash。

# 方式一:一行命令安装(请在 Git Bash 中运行,不要用 PowerShell 或 CMD)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash

# 方式二:手动安装
git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install-win.sh

注意: 右键文件夹选择"Open Git Bash here",或打开 Git Bash 并导航到该目录。请勿使用 PowerShell 或命令提示符。

环境要求

  • Python 3.8+(Debian / Ubuntu 还需安装 python3-venv
  • Claude Code CLI
  • Git
  • 可选:uv — 如果已安装,安装脚本会用它来加速依赖安装
  • 可选:Playwright(用于截图)

隔离安装

Python 依赖会安装到专属虚拟环境 ~/.claude/skills/geo/.venv/ 中。你的系统 Python 不受任何影响,卸载技能时会一并删除虚拟环境及其他所有文件。

技能和代理文件直接引用该虚拟环境,因此无论你 PATH 上的 python3 指向什么版本,工具都能正常工作。


命令

打开 Claude Code,使用以下命令:

命令功能说明
/geo audit <url>全量 GEO + SEO 审计(并行子代理)
/geo quick <url>60 秒 GEO 可见性快照
/geo citability <url>评分内容的 AI 可引用性
/geo crawlers <url>检查 AI 爬虫访问权限(robots.txt)
/geo llmstxt <url>分析或生成 llms.txt
/geo brands <url>扫描 AI 引用平台中的品牌提及
/geo platforms <url>平台专属优化
/geo schema <url>结构化数据分析与生成
/geo technical <url>技术 SEO 审计
/geo content <url>内容质量与 E-E-A-T 评估
/geo report <url>生成面向客户提交的 GEO 报告
/geo report-pdf生成带图表和可视化的专业 PDF 报告

项目架构

geo-seo-claude/
├── geo/                          # 主编排技能
│   └── SKILL.md                  # 主技能文件,含命令与路由
├── skills/                       # 13 个专项子技能
│   ├── geo-audit/                # 全量审计调度与评分
│   ├── geo-citability/           # AI 可引用性评分
│   ├── geo-crawlers/             # AI 爬虫访问分析
│   ├── geo-llmstxt/              # llms.txt 标准分析与生成
│   ├── geo-brand-mentions/       # AI 引用平台上的品牌存在感
│   ├── geo-platform-optimizer/   # 各平台 AI 搜索优化
│   ├── geo-schema/               # 面向 AI 可发现性的结构化数据
│   ├── geo-technical/            # 技术 SEO 基础
│   ├── geo-content/              # 内容质量与 E-E-A-T
│   ├── geo-report/               # 面向客户的 Markdown 报告生成
│   ├── geo-report-pdf/           # 带图表的专业 PDF 报告
│   ├── geo-prospect/             # 轻量客户管线管理
│   ├── geo-proposal/             # 自动生成客户提案
│   └── geo-compare/              # 月度变化追踪与进展报告
├── agents/                       # 5 个并行子代理
│   ├── geo-ai-visibility.md      # GEO 审计、可引用性、爬虫、品牌
│   ├── geo-platform-analysis.md  # 平台专属优化
│   ├── geo-technical.md          # 技术 SEO 分析
│   ├── geo-content.md            # 内容与 E-E-A-T 分析
│   └── geo-schema.md             # Schema 标记分析
├── scripts/                      # Python 工具脚本
│   ├── fetch_page.py             # 页面抓取与解析
│   ├── citability_scorer.py      # AI 可引用性评分引擎
│   ├── brand_scanner.py          # 品牌提及检测
│   ├── llmstxt_generator.py      # llms.txt 校验与生成
│   └── generate_pdf_report.py    # PDF 报告生成器(ReportLab)
├── schema/                       # JSON-LD 模板
│   ├── organization.json         # Organization schema(含 sameAs)
│   ├── local-business.json       # LocalBusiness schema
│   ├── article-author.json       # Article + Person schema(E-E-A-T)
│   ├── software-saas.json        # SoftwareApplication schema
│   ├── product-ecommerce.json    # Product schema(含 offers)
│   └── website-searchaction.json # WebSite + SearchAction schema
├── install.sh                    # 一键安装脚本
├── uninstall.sh                  # 卸载脚本
├── requirements.txt              # Python 依赖
└── README.md                     # 本文件

数据存储

CRM 和报告类技能(/geo prospect/geo proposal/geo compare)将运行时数据存储在 Claude Code 目录之外:

~/.geo-prospects/
├── prospects.json              # 客户 / 潜在客户管线数据
├── proposals/                  # 生成的提案文档
│   └── <domain>-proposal-<date>.md
└── reports/                    # 月度趋势报告
    └── <domain>-monthly-<YYYY-MM>.md

卸载脚本不会删除此目录 — 如果你不再需要客户数据,请手动删除。


工作原理

全量审计流程

当你运行 /geo audit https://example.com 时:

  1. 发现阶段 — 抓取首页,识别业务类型,爬取 sitemap
  2. 并行分析 — 同时启动 5 个子代理:
    • AI 可见性(可引用性、爬虫、llms.txt、品牌提及)
    • 平台分析(ChatGPT、Perplexity、Google AI Overviews 就绪度)
    • 技术 SEO(Core Web Vitals、SSR、安全性、移动端)
    • 内容质量(E-E-A-T、可读性、时效性)
    • Schema 标记(检测、校验、生成)
  3. 综合评分 — 汇总各项得分,生成综合 GEO 分数(0-100)
  4. 报告输出 — 输出优先级排序的行动方案与速赢项

评分权重

评分维度权重
AI 可引用性与可见性25%
品牌权威信号20%
内容质量与 E-E-A-T20%
技术基础15%
结构化数据10%
平台优化10%

核心功能

可引用性评分

分析内容块在 AI 引用中的就绪程度。最容易被 AI 引用的段落特征:134-167 词、自包含、信息密度高、直接回答问题。

AI 爬虫分析

检查 robots.txt 中 14+ 种 AI 爬虫的访问策略(GPTBot、ClaudeBot、PerplexityBot 等),并提供具体的允许 / 禁止建议。

品牌提及扫描

品牌提及与 AI 可见性的相关性比反向链接强 3 倍。覆盖 YouTube、Reddit、Wikipedia、LinkedIn 等 7+ 个平台。

平台专属优化

在相同查询下,仅 11% 的域名同时被 ChatGPT 和 Google AI Overviews 引用。为每个平台提供定制化的优化建议。

llms.txt 生成

生成新兴的 llms.txt 标准文件,帮助 AI 爬虫理解你的网站结构。

面向客户的报告

生成 Markdown 或 PDF 格式的专业 GEO 报告。PDF 报告包含评分仪表盘、柱状图、平台就绪度可视化、彩色编码表格和优先级排序的行动方案——可直接交付客户。


应用场景

  • GEO 代理机构 — 运行客户审计并生成交付物
  • 市场营销团队 — 监控并提升 AI 搜索可见性
  • 内容创作者 — 优化内容以获得 AI 引用
  • 本地商家 — 在 AI 助手的回答中被用户找到
  • SaaS 公司 — 提升各 AI 平台的实体识别
  • 电商 — 优化产品页面以获得 AI 购物推荐

卸载

./uninstall.sh

或手动删除:

rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md

许可证

MIT License