OpenSource-Hub

geo-seo-claude

CLI ツール

zubair-trabzada/geo-seo-claude

AI検索エンジン向けにウェブサイトを最適化し、GEO監査、スコアリング、レポートを提供します。

概要

ウェブサイトの生成エンジン最適化(GEO)監査および最適化を行うためのClaude Codeスキル。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 

FAQ (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  # Must show 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+ に更新することです。

参照 Issue #69
トラブル対応
スキーマ監査が HTML の <head> 内に配置された JSON-LD マークアップを検出できないのはなぜですか?

監査が失敗するのは、WebFetchがHTMLからmarkdownへの変換時に<head>コンテンツを除去する一方で、JSON-LDスキーマブロックは<head>内に配置されることが多いためです。修正方法は、WebFetchではなくfetch_page.pyをページ取得とスキーマ検出に使用することです。fetch_page.pyはJSON-LDを正しく抽出するためです。geo-schemaエージェントとスキルを更新してfetch_page.pyを呼び出すようにし、その後監査を再実行してください。

参照 Issue #16
トラブル対応
/geo-audit 実行時の「Agent type 'geo-citability' not found」エラーの修正方法

/geo-audit コマンドは、インストール環境に登録されていない2つのエージェントタイプ geo-citability と geo-brand-mentions を参照しています。これはウェブページや入力内容の問題ではなく、コマンドとエージェント登録の不一致です。回避策として、利用可能な geo エージェントのいずれかを代わりに使用してください: geo-ai-visibility、geo-content、geo-platform-analysis、geo-schema、または geo-technical。最新バージョンに更新するか、エージェント環境を再起動してください。最新ビルドでも不足しているエージェントが一覧に表示されない場合は、リポジトリ側でそれらを登録または追加する必要があります。

参照 Issue #17