🚀 GEO 1-Click Audit

The Chrome Extension That Reveals Your AI Visibility Score

In 2026, GEO (Generative Engine Optimization) is the new SEO. While traditional SEO was about ranking #1 on Google's list of links, GEO is about being the source of truth in AI-generated answers.

This extension helps brands understand how often ChatGPT, Perplexity, and Gemini are recommending their competitors over them.

---

🎯 Features

1. llm.txt Checker ✅

Automatically detects if your website has an llm.txt file (the 2026 standard for AI-ready websites). If missing, it generates one for you using Gemini Nano or template-based generation.

2. On-Page Readiness Score 📊

Analyzes your page structure using local AI to determine how well it's optimized for AI consumption:

• Title optimization
• Meta descriptions
• Heading structure
• List usage
• Structured data (JSON-LD, Microdata)
• Content length and quality

3. AI Visibility Score (Share of Voice) 👁️

Calculates how often your brand appears in AI-generated answers by:

• Running the same query 5 times across ChatGPT, Perplexity, and Gemini
• Measuring brand mentions vs. competitors
• Computing probabilistic Share of Voice percentage

4. Shadow Competitor Report 👻

Identifies companies that:

• Don't rank well in traditional Google Search
• Are dominating AI-generated answers
• Are stealing your AI traffic

5. Revenue Gap Calculator 💰

Shows potential monthly revenue loss using the formula:

$$ \text{Loss} = (SoV_{\text{competitor}} - SoV_{\text{brand}}) \times (\text{Search Volume} \times \text{Avg Order Value}) $$

---

🏗️ Technical Architecture

Frontend: Side Panel API

• Persistent UI that displays audit results while browsing
• Modern gradient design with real-time updates
• "Scan Now" button triggers comprehensive audit

Intelligence: Hybrid AI Approach

Local AI (Gemini Nano)

• Purpose: On-page readiness analysis
• Benefits: Zero latency, no API costs
• API: window.ai (Chrome's built-in AI)

External APIs

• Purpose: AI visibility scoring across platforms
• Platforms: ChatGPT, Perplexity, Gemini
• Architecture: Node.js backend for secure API key management

---

📁 Project Structure

GEO-1-click/
├── manifest.json           # Extension configuration
├── background.js           # Service worker (llm.txt checks, API coordination)
├── content.js              # Page analysis and data extraction
├── apiClient.js            # Backend API integration (with example implementation)
├── sidepanel/
│   ├── sidepanel.html      # UI structure
│   ├── sidepanel.css       # Styling (gradient theme)
│   └── sidepanel.js        # UI controller and logic
└── icons/                  # Extension icons (16px, 48px, 128px)

---

🚀 Installation & Setup

1. Load the Extension (Development)

1. Clone or download this repository
2. Open Chrome and navigate to chrome://extensions/
3. Enable Developer Mode (toggle in top-right)
4. Click Load unpacked
5. Select the GEO-1-click folder

2. Create Icon Files

The extension requires 3 icon sizes. You can:

• Use a tool like Canva or Figma to design them
• Use an online icon generator
• Create simple placeholder icons for testing

Place them in the icons/ folder:

• icon16.png (16×16px)
• icon48.png (48×48px)
• icon128.png (128×128px)

Quick temporary solution: Create a simple colored square in any image editor and resize it to the 3 sizes.

3. Enable Gemini Nano (Optional)

For local AI features:

1. Ensure you're using Chrome Canary or Chrome Dev (version 127+)
2. Navigate to chrome://flags/#optimization-guide-on-device-model
3. Enable "Optimization Guide On Device Model"
4. Navigate to chrome://flags/#prompt-api-for-gemini-nano
5. Enable "Prompt API for Gemini Nano"
6. Restart Chrome
7. Open DevTools Console and run: await window.ai.canCreateTextSession()
8. If it returns "readily" or "after-download", you're set!

---

🔌 Backend Setup (For Production)

The extension currently uses simulated data for the AI Visibility Score. To get real results:

Option 1: Node.js + Express Backend

1. Create a new Node.js project:

mkdir geo-audit-backend
cd geo-audit-backend
npm init -y
npm install express openai cors dotenv

2. Use the example implementation in apiClient.js as your starting point

3. Set environment variables:

OPENAI_API_KEY=your_openai_key
PERPLEXITY_API_KEY=your_perplexity_key
GEMINI_API_KEY=your_gemini_key

4. Deploy to:

   • Vercel (easiest for serverless)
   • Railway (full hosting)
   • AWS Lambda + API Gateway
   • Google Cloud Functions

5. Update API_CONFIG.backendUrl in apiClient.js with your deployed URL

Option 2: Serverless Functions

Create individual serverless functions for each platform check:

• /api/check-chatgpt
• /api/check-perplexity
• /api/check-gemini

Deploy to Vercel, Netlify, or Cloudflare Workers.

---

💡 Usage

1. Click the extension icon in Chrome toolbar
2. The side panel opens automatically
3. Click "Scan Now" to run the audit
4. Review the results:
   • ✅ llm.txt status (with auto-generation option)
   • 📊 On-Page Readiness Score
   • 👁️ AI Visibility Score
   • 👻 Shadow Competitors
   • 💰 Revenue Gap Estimate

---

🎓 Key Learning Outcomes

Building this extension teaches:

1. Chrome Extension APIs

   • Side Panel API
   • Background Service Workers
   • Content Scripts
   • Message passing between components

2. AI Integration

   • Local AI (Gemini Nano via window.ai)
   • External AI APIs (OpenAI, Perplexity, Gemini)
   • Hybrid AI architecture

3. Backend Development

   • RESTful API design
   • Secure API key management
   • Rate limiting and retry logic
   • Aggregating data from multiple sources

4. Data Analysis

   • Share of Voice calculation
   • Probabilistic scoring
   • Revenue impact modeling

---

🚧 Roadmap / Future Enhancements

• User authentication and saved audits
• Weekly email reports with visibility trends
• Industry benchmarking (compare against category average)
• Automated recommendations for improving GEO score
• Export reports as PDF
• Integration with Google Analytics
• Multi-language support for international markets
• A/B testing different llm.txt formats

---

📊 Demo Data

The extension currently uses simulated competitor data for demonstration purposes. This allows you to:

• Test the UI without API costs
• Understand the data flow
• Present the concept in your portfolio

Real data requires connecting the backend API (see Backend Setup section).

---

🔐 Security Notes

⚠️ NEVER store API keys in extension code!

• API keys should only live in your backend server
• Use environment variables
• Implement rate limiting to prevent abuse
• Consider adding authentication for your backend API

---

🎨 Customization

Change Color Scheme

Edit sidepanel/sidepanel.css:

/* Primary gradient */
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);

/* Accent colors */
color: #f5576c; /* Change revenue/warning colors */

Adjust Scoring Weights

Edit content.js, function calculateReadinessScore():

// Modify point values for each check
if (pageData.title && pageData.title.length > 10) {
  score += 15; // Change this value
}

Add More AI Platforms

Extend apiClient.js to include:

• Claude (Anthropic)
• Llama (Meta)
• Mistral AI
• Other emerging platforms

---

📝 License

MIT License - Feel free to use this in your portfolio!

---

🤝 Contributing

This is a portfolio project, but suggestions are welcome! If you:

• Find a bug
• Have an enhancement idea
• Want to add a new AI platform integration

Open an issue or submit a pull request.

---

👨‍💻 About

Built as a 2026 portfolio project demonstrating:

• Modern Chrome Extension development
• Hybrid AI architecture (local + cloud)
• Data synthesis from multiple sources
• Business intelligence and revenue modeling

Perfect for: Frontend developers leveling up to full-stack with AI integration.

---

📚 Resources

• Chrome Extension Documentation
• Side Panel API
• Gemini Nano (window.ai)
• OpenAI API
• Perplexity API
• Google Gemini API

---

Ready to see how visible you are in the AI age? Install and scan now! 🚀