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 驅動搜尋結果的轉變。