<div align="center"> <!-- HERO BANNER --> <img src="assets/hero-banner.png" alt="E-GEO: Rank #1 in AI Search Engines" width="100%" /> <br />

🌍 E-GEO

Generative Engine Optimization for AI-Powered Search

<p> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License" /></a> <a href="https://github.com/mverab/eGEOagents/stargazers"><img src="https://img.shields.io/github/stars/mverab/eGEOagents?style=social" alt="GitHub Stars" /></a> <a href="https://github.com/mverab/eGEOagents/network/members"><img src="https://img.shields.io/github/forks/mverab/eGEOagents?style=social" alt="GitHub Forks" /></a> <a href="https://github.com/mverab/eGEOagents/issues"><img src="https://img.shields.io/github/issues/mverab/eGEOagents" alt="Issues" /></a> <a href="https://arxiv.org/abs/2511.20867"><img src="https://img.shields.io/badge/arXiv-2511.20867-b31b1b.svg" alt="Research Paper" /></a> </p> <p> <a href="https://claude.com/claude-code"><img src="https://img.shields.io/badge/Built%20with-Claude%20Code-8B5CF6?logo=anthropic" alt="Built with Claude Code" /></a> <a href="CONTRIBUTING.md#ai-transparency"><img src="https://img.shields.io/badge/🤖-AI--Assisted-blueviolet" alt="AI-Assisted" /></a> </p> <br />

🚀 One command. Premium results.<br /> Rank higher in ChatGPT, Perplexity, Claude, and Gemini.

<br />

📖 Docs • 🐛 Issues • 💬 Discussions • 📝 Research Paper

---

</div> <!-- AI TRANSPARENCY BADGE --> <p align="center"> _{🤖 <strong>AI-Assisted Development</strong> — <a href="CONTRIBUTING.md#ai-transparency">See what's AI-generated vs human-authored</a>} </p>

---

✨ What is E-GEO?

<table> <tr> <td width="60%">

E-GEO is a zero-effort Generative Engine Optimization toolkit that transforms your website content to rank higher in AI-powered search engines.

Based on the E-GEO research paper, it applies the 10 universal features that consistently improve AI-engine rankings.

• ✅ No learning curve — One command to optimize
• ✅ Research-backed — Based on peer-reviewed findings
• ✅ Production-ready — Copy-paste optimized content

</td> <td width="40%">

/geo https://yoursite.com/pricing

↓

geo-output/
├── report.md
├── optimized/
│   └── pricing.md
└── schema/
    └── pricing.json

</td> </tr> </table>

---

🚀 Quick Start (3 Steps)

1. Install

Copy the .claude/ folder to your project:

cp -r /path/to/eGEOagents/.claude .

2. Activate

In Claude Code, switch to GEO mode:

/output-style geo-optimizer

3. Optimize

Run your first optimization:

/geo https://yoursite.com

---

🧩 Install as Skills (skills.sh)

Install the complete skill collection:

npx skills add https://github.com/mverab/eGEOagents

Install one skill only:

npx skills add https://github.com/mverab/eGEOagents --skill competitive-analysis

Validate parser discovery before shipping updates:

npx skills add https://github.com/mverab/eGEOagents --list

Verify indexing pages:

• Collection: skills.sh/mverab/egeoagents
• Owner: skills.sh/mverab

---

📋 Commands

| Command | What it does | |---------|--------------| | /geo <url> | Full pipeline - Analyze, rank, rewrite, schema | | /geo:audit <url> | Analysis only, no changes | | /geo:optimize <file> | Optimize local content file | | /geo:batch <folder> | Process entire folder | | /geo:report | Generate executive report | | /geo:compete <query> | Competitive analysis |

---

📊 What You Get

After running /geo:

geo-output/
├── report.md           # Executive summary + scores
├── analysis.json       # Raw analysis data
├── optimized/
│   └── pricing.md      # Rewritten content (ready to use)
├── schema/
│   └── pricing.json    # JSON-LD markup (copy to site)
└── checklist.md        # Step-by-step implementation

---

🎯 Results: Backed by Research

E-GEO is based on the E-GEO research paper (arXiv:2511.20867). The paper reports that competitive framing produces the strongest immediate lift, a universal optimization strategy outperforms common heuristics, and the 10 GEO features consistently appear in higher-ranking content.

| Feature | What E-GEO Does | |---------|-----------------| | Ranking Emphasis | Positions your content as the top choice | | User Intent | Directly answers what users are looking for | | Competitive Edge | Highlights your unique advantages | | Social Proof | Integrates trust signals and testimonials | | Authority | Establishes expert, confident tone | | Scannability | Structures for easy AI parsing |

Results vary by content quality and competition. See the paper for full methodology and findings: arXiv:2511.20867.

---

🆚 E-GEO vs Alternatives

| Feature | E-GEO | Traditional SEO | Manual GEO | |---------|-------|----------------|------------| | AI-Engine Optimized | ✅ Yes | ❌ No | ⚠️ Partial | | One-Command Setup | ✅ Yes | ❌ No | ❌ No | | Research-Based | ✅ Yes (paper) | ❌ Heuristics | ⚠️ Variable | | Output Quality | Premium | Basic | Variable | | Time to Results | Minutes | Months | Days | | Cost | Free | Expensive | Time-intensive | | Schema Generation | ✅ Auto | ❌ No | ⚠️ Manual | | Competitive Analysis | ✅ Built-in | ❌ No | ❌ No |

---

💎 Premium Output

E-GEO delivers outputs that look like they came from a $100M company:

┌─────────────────────────────────────────────────────────────┐
│  🎯 GEO AUDIT REPORT                                        │
├─────────────────────────────────────────────────────────────┤
│  URL: yoursite.com/pricing                                  │
│  Score: 78/100                                              │
│  Ranking Potential: ████████░░ 78%                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ✅ STRENGTHS                                               │
│  • Clear value proposition                                  │
│  • Good content structure                                   │
│                                                             │
│  ⚠️ GAPS                                                    │
│  • Missing social proof → Add customer count                │
│  • No urgency signals → Add limited-time offer              │
│                                                             │
│  📈 PRIORITY ACTIONS                                        │
│  1. Add testimonials (+15 points)                           │
│  2. Include pricing comparison (+10 points)                 │
│  3. Add schema markup (+5 points)                           │
│                                                             │
└─────────────────────────────────────────────────────────────┘

---

🤖 How It Works

<div align="center"> <!-- SYSTEM DIAGRAM --> <img src="assets/egeo-agents.png" alt="E-GEO Multi-Agent System" width="600" /> </div> <br />

E-GEO uses 4 specialized AI agents orchestrated by Claude Code:

| Agent | What it does | Output | |:------|:-------------|:-------| | 🔍 Analyzer | Extracts content, scores GEO signals, identifies gaps | analysis.json | | 📊 Ranker | Simulates AI-engine ranking, predicts positions | Baseline score | | ✍️ Rewriter | Optimizes content while preserving brand voice | optimized/*.md | | 🗂️ Indexer | Generates schema markup and technical assets | schema/*.json |

---

📁 What's Included

.claude/
├── CLAUDE.md                    # System knowledge base
├── output-styles/
│   └── geo-optimizer.md         # Premium formatting mode
├── agents/
│   ├── geo-analyzer.md          # Content analysis
│   ├── geo-rewriter.md          # Content optimization
│   ├── geo-ranker.md            # Ranking simulation
│   └── geo-indexer.md           # Schema generation
├── skills/
│   ├── competitive-analysis/    # Auto-triggered competitor analysis
│   ├── content-scoring/         # Auto-triggered scoring
│   └── schema-generator/        # Auto-triggered schema
└── commands/
    ├── geo.md                   # Main command
    ├── geo-audit.md
    ├── geo-optimize.md
    ├── geo-batch.md
    ├── geo-report.md
    └── geo-compete.md

---

🎁 Perfect For

<table> <tr> <td align="center" width="20%"> 🚀<br /><strong>SaaS Founders</strong><br />_{AI-engine traffic} </td> <td align="center" width="20%"> 💼<br /><strong>B2B Marketers</strong><br />_{Landing pages} </td> <td align="center" width="20%"> 🛍️<br /><strong>E-commerce</strong><br />_{Product descriptions} </td> <td align="center" width="20%"> ✍️<br /><strong>Content Creators</strong><br />_{AI discoverability} </td> <td align="center" width="20%"> 🏢<br /><strong>Agencies</strong><br />_{GEO services} </td> </tr> </table>

---

📚 Documentation

| Resource | Description | |:---------|:------------| | 📖 Getting Started | Step-by-step tutorial | | ⚙️ How It Works | Technical deep dive | | ❓ FAQ | Common questions answered | | 🧩 skills.sh Playbook | Listing, ranking, and metadata checklist | | 📝 Usage Guide | Complete command reference | | 📝 Research Paper | The science behind E-GEO |

---

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick ways to contribute:

• Report bugs via issues