GEO-first, SEO-supported. Optimize websites for AI-powered search engines
(ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.

AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.

🔀 OpenCode adaptation of geo-seo-claude by Zubair Trabzada

---

Why GEO Matters (2026)

Metric	Value
GEO services market	$850M+ (projected $7.3B by 2031)
AI-referred traffic growth	+527% year-over-year
AI traffic converts vs organic	4.4x higher
Gartner: search traffic drop by 2028	-50%
Brand mentions vs backlinks for AI	3x stronger correlation
Marketers investing in GEO	Only 23%

---

Quick Start

One-Command Install (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/mugnimaestra/geo-seo-opencode/main/install.sh | bash

Manual Install

git clone https://github.com/mugnimaestra/geo-seo-opencode.git
cd geo-seo-opencode
./install.sh

Requirements

• Python 3.8+
• OpenCode CLI
• Git
• Optional: Playwright (for screenshots)

---

Commands

Open OpenCode and use these commands:

Command	What It Does
/geo-audit <url>	Full GEO + SEO audit with parallel subagents
/geo-quick <url>	60-second GEO visibility snapshot
/geo-citability <url>	Score content for AI citation readiness
/geo-crawlers <url>	Check AI crawler access (robots.txt)
/geo-llmstxt <url>	Analyze or generate llms.txt
/geo-brands <url>	Scan brand mentions across AI-cited platforms
/geo-platforms <url>	Platform-specific optimization
/geo-schema <url>	Structured data analysis & generation
/geo-technical <url>	Technical SEO audit
/geo-content <url>	Content quality & E-E-A-T assessment
/geo-report <url>	Generate client-ready GEO report
/geo-report-pdf	Generate professional PDF report with charts & visualizations

---

Architecture

geo-seo-opencode/
├── .opencode/
│   ├── skills/                    # 11 specialized sub-skills + main orchestrator
│   │   ├── geo/                   # Main skill orchestrator
│   │   │   └── SKILL.md           # Primary skill file with commands & routing
│   │   ├── geo-audit/             # Full audit orchestration & scoring
│   │   ├── geo-citability/        # AI citation readiness scoring
│   │   ├── geo-crawlers/          # AI crawler access analysis
│   │   ├── geo-llmstxt/           # llms.txt standard analysis & generation
│   │   ├── geo-brand-mentions/    # Brand presence on AI-cited platforms
│   │   ├── geo-platform-optimizer/# Platform-specific AI search optimization
│   │   ├── geo-schema/            # Structured data for AI discoverability
│   │   ├── geo-technical/         # Technical SEO foundations
│   │   ├── geo-content/           # Content quality & E-E-A-T
│   │   ├── geo-report/            # Client-ready markdown report generation
│   │   └── geo-report-pdf/        # Professional PDF report with charts
│   ├── agent/                     # 5 parallel subagents
│   │   ├── geo-ai-visibility.md   # GEO audit, citability, crawlers, brands
│   │   ├── geo-platform-analysis.md # Platform-specific optimization
│   │   ├── geo-technical.md       # Technical SEO analysis
│   │   ├── geo-content.md         # Content & E-E-A-T analysis
│   │   └── geo-schema.md          # Schema markup analysis
│   └── command/                   # Slash command definitions
├── scripts/                       # Python utilities
│   ├── fetch_page.py              # Page fetching & parsing
│   ├── citability_scorer.py       # AI citability scoring engine
│   ├── brand_scanner.py           # Brand mention detection
│   ├── llmstxt_generator.py       # llms.txt validation & generation
│   └── generate_pdf_report.py     # PDF report generator (ReportLab)
├── schema/                        # JSON-LD templates
│   ├── organization.json          # Organization schema (with 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 with offers
│   └── website-searchaction.json  # WebSite + SearchAction schema
├── install.sh                     # One-command installer
├── uninstall.sh                   # Uninstaller
├── requirements.txt               # Python dependencies
└── README.md                      # This file

---

How It Works

Full Audit Flow

When you run /geo-audit https://example.com:

1. Discovery — Fetches homepage, detects business type, crawls sitemap
2. Parallel Analysis — Launches 5 subagents simultaneously:
   • AI Visibility (citability, crawlers, llms.txt, brand mentions)
   • Platform Analysis (ChatGPT, Perplexity, Google AIO readiness)
   • Technical SEO (Core Web Vitals, SSR, security, mobile)
   • Content Quality (E-E-A-T, readability, freshness)
   • Schema Markup (detection, validation, generation)
3. Synthesis — Aggregates scores, generates composite GEO Score (0-100)
4. Report — Outputs prioritized action plan with quick wins

Scoring Methodology

Category	Weight
AI Citability & Visibility	25%
Brand Authority Signals	20%
Content Quality & E-E-A-T	20%
Technical Foundations	15%
Structured Data	10%
Platform Optimization	10%

---

Key Features

Citability Scoring

Analyzes content blocks for AI citation readiness. Optimal AI-cited passages are 134-167 words, self-contained, fact-rich, and directly answer questions.

AI Crawler Analysis

Checks robots.txt for 14+ AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) and provides specific allow/block recommendations.

Brand Mention Scanning

Brand mentions correlate 3x more strongly with AI visibility than backlinks. Scans YouTube, Reddit, Wikipedia, LinkedIn, and 7+ other platforms.

Platform-Specific Optimization

Only 11% of domains are cited by both ChatGPT and Google AI Overviews for the same query. Provides tailored recommendations per platform.

llms.txt Generation

Generates the emerging llms.txt standard file that helps AI crawlers understand your site structure.

Client-Ready Reports

Generates professional GEO reports in markdown or PDF format. PDF reports include score gauges, bar charts, platform readiness visualizations, color-coded tables, and prioritized action plans — ready to deliver to clients.

---

Use Cases

• GEO Agencies — Run client audits and generate deliverables
• Marketing Teams — Monitor and improve AI search visibility
• Content Creators — Optimize content for AI citations
• Local Businesses — Get found by AI assistants
• SaaS Companies — Improve entity recognition across AI platforms
• E-commerce — Optimize product pages for AI shopping recommendations

---

Uninstall

./uninstall.sh

Or manually:

rm -rf ~/.config/opencode/skills/geo ~/.config/opencode/skills/geo-* ~/.config/opencode/agents/geo-*.md

---

Want to Turn This Into a Business?

The tool is free. Learning how to monetize it is where the community comes in.

Join the AI Workshop Community →

Inside you'll get:

• Video walkthroughs — Step-by-step setup, running audits, reading results
• Client acquisition playbook — How to find prospects, pitch GEO services, and close deals
• Live office hours — Bring your audit results, get direct help
• GEO agency pricing & templates — Proposal docs, cold outreach scripts, onboarding workflows

GEO agencies charge $2K–$12K/month. This tool does the audit. The community teaches you how to sell it.

---

Attribution

This project is an OpenCode adaptation of geo-seo-claude by Zubair Trabzada. The original tool was built for Claude Code — this fork restructures it for OpenCode's skill/agent/command system.

---

License

MIT License

---

Contributing

Contributions welcome! Please read the contribution guidelines in docs/CONTRIBUTING.md before submitting a PR.

---

Built for the AI search era.