zubair-trabzada/geo-seo-claude

GEO-first SEO skill for Claude Code. Comprehensive AI search optimization for any website — citability scoring, AI crawler analysis, brand authority, schema markup, platform-specific optimization, and PDF reports. If you want learn how to sell this to real businesses, check out the skool community

geo‑seo‑claude – Claude Code 用 AI‑搜索（GEO）审计技能

是什么 – 一个 Claude Code 技能，对网站进行多步骤审计并生成「GEO」（AI 搜索）评分。它检查网站在 ChatGPT、Claude、Perplexity、Gemini 和 Google AI 概览等新兴 AI 驱动型搜索引擎中被发现和引用的能力，然后输出客户端可用的 Markdown 或 PDF 报告。

为何重要 – 到 2026 年，AI 引用流量年增长率将超过 500%，转化率是传统自然流量的数倍。传统 SEO 已无法保证可见性；网站必须为 AI 爬虫做好 引用准备。此工具自动化了这一评估过程。

主要功能

功能	说明
完整 GEO 审计 (`/geo audit <url>`)	启动五个并行子代理（可见性、平台、技术、内容、结构化数据），聚合生成 0–100 的 GEO 评分。
快速快照 (`/geo quick`)	60 秒内完成可见性概览。
引用性评分 (`/geo citability`)	评估内容块的 AI 引用准备度（理想长度 134–167 字，自包含、事实丰富）。
AI 爬虫检查 (`/geo crawlers`)	解析 `robots.txt`，识别超过 14 个 AI 机器人（如 GPTBot、ClaudeBot 等），并建议允许/阻止规则。
品牌提及扫描 (`/geo brands`)	在 YouTube、Reddit、Wikipedia、LinkedIn 等平台扫描品牌提及，报告权威信号。
llms.txt 处理 (`/geo llmstxt`)	验证或生成新兴的 `llms.txt` 文件，告知 AI 爬虫网站结构。
结构化数据分析/生成 (`/geo schema`)	检测缺失的 JSON‑LD，根据模板验证，并可输出可直接粘贴的标记代码。
报告生成 (`/geo report`, `...‑pdf`)	生成包含评分仪表、条形图和优先级行动项的 Markdown 或 PDF 客户端报告。
潜在客户/提案助手 (`/geo prospect`, `/geo proposal`)	轻量级 CRM，存储销售管道数据，并可自动生成提案文档。

架构概览

geo-seo-claude/
├─ geo/                # 入口点（SKILL.md） – 定义 /geo 命令
├─ skills/            # 13 个专注子技能（audit、citability、crawlers…）
├─ agents/            # 5 个并行代理的 Markdown 文件，负责任务编排
├─ scripts/           # Python 工具（页面抓取、评分、PDF 生成）
├─ schema/            # 结构化数据子技能使用的 JSON‑LD 模板
└─ install.sh / uninstall.sh

所有 Python 代码在 ~/.claude/skills/geo/.venv/ 内的隔离虚拟环境中运行，系统 Python 保持不变。

安装与要求

单行命令（macOS/Linux）

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

手动安装 – 克隆仓库，运行 ./install.sh（Windows 上使用 Git Bash 运行 install‑win.sh）。
依赖项 – Python 3.8+、Claude Code CLI、Git；可选 uv 用于更快的 pip 安装，Playwright 用于截图支持。

典型工作流程

打开 Claude Code，输入命令，例如 /geo audit https://example.com。
该技能获取主页，发现站点地图，然后并行启动五个子代理。
每个代理返回一个数值子评分；协调器使用加权表（引用性 25%，品牌 20%，内容 20%，技术 15%，结构化数据 10%，平台 10%）合并得分。
输出综合 GEO 评分和 Markdown 报告。使用 /geo report-pdf 可生成专业 PDF 发送给客户。

数据持久化

潜在客户和提案数据存储在 ~/.geo-prospects/（JSON 和 Markdown 文件）。卸载脚本会移除技能，但 不会删除 此目录——如需清除存储的客户数据，必须手动删除。

许可证与社区

许可证：MIT – 免费使用、修改和商业化。
社区：作者推荐「AI 工作坊」社区（Skool），提供视频教程、客户获取手册和代理机构可变现审计服务的直播办公时间。

TL;DR

geo-seo-claude 是一个即开即用的 Claude Code 技能，用于审计网站的 AI 搜索可见性（GEO）。它整合了 Python 工具、JSON‑LD 模板和一组并行子代理，生成数值化 GEO 评分和专业客户端报告，帮助 SEO 机构和营销人员适应 AI 驱动搜索结果的转变。