Geo Seo Auditor

First Run

When a user runs any geo-seo-auditor command for the first time, display this intro before starting execution:

""" 📡 GEO SEO Auditor

What I'll do: Fetch your URL and evaluate AI search readiness across 6 dimensions.

What you'll get: → AI visibility score (0-100) → AI crawler access status (14 crawlers checked) → Citability analysis of key content blocks → Top 5 prioritized fixes

Output: Saved to GEO-AUDIT-REPORT.md Time: ~90 seconds.

Starting... """

Then proceed immediately. Do not wait for user confirmation.

GEO SEO Auditor

Comprehensive audit tool for Generative Engine Optimization (GEO) and traditional SEO. Evaluates how well a website is positioned to be cited by AI-powered search engines including ChatGPT, Claude, Perplexity, and Google AI Overviews.

Commands

| Command | Description | |---------|-------------| | /geo-seo-auditor audit | Full GEO + traditional SEO audit | | /geo-seo-auditor quick | 60-second GEO visibility snapshot | | /geo-seo-auditor citability | Score content for AI citation readiness | | /geo-seo-auditor crawlers | Check AI crawler access via robots.txt | | /geo-seo-auditor llmstxt | Analyze or generate llms.txt file | | /geo-seo-auditor brands | Scan brand mentions across AI-cited platforms | | /geo-seo-auditor platforms | Platform-specific optimization recommendations |

Full Audit Flow

The full audit (/geo-seo-auditor audit ) follows a 6-step process:

Step 1: Discovery

• Fetch the target URL HTML content
• Extract metadata (title, description, OG tags, canonical)
• Retrieve robots.txt and check sitemap.xml
• Detect structured data (JSON-LD, microdata)
• Check for llms.txt file

Step 2: AI Visibility Analysis

• Score content blocks for AI citability (0-100)
• Identify the most citable passages on the page
• Evaluate content structure for AI comprehension
• Check factual density, self-containment, and Q&A format
• Flag anti-patterns (vague language, opinion without data, jargon)

Step 3: Brand Authority

• Scan for brand mentions across AI-cited platforms
• Check presence on Wikipedia, Crunchbase, LinkedIn, GitHub
• Evaluate E-E-A-T signals (Experience, Expertise, Authoritativeness, Trustworthiness)
• Identify author credentials and organizational trust markers
• Assess backlink profile strength indicators

Step 4: Platform Analysis

• ChatGPT: GPTBot access, content structure for citation
• Claude: ClaudeBot access, passage clarity and factual density
• Perplexity: PerplexityBot access, source attribution readiness
• Google AI Overviews: Google-Extended status, featured snippet optimization
• Generate platform-specific optimization recommendations

Step 5: Scoring

• Calculate weighted scores across all audit dimensions
• Generate an overall GEO Readiness Score (0-100)
• Benchmark against best practices
• Identify top priorities for improvement

Step 6: Report

• Compile findings into a structured audit report
• Include actionable recommendations ranked by impact
• Provide implementation difficulty ratings (easy, medium, hard)
• Deliver quick wins and long-term strategy items

Scoring Methodology

| Dimension | Weight | What It Measures | |-----------|--------|------------------| | AI Citability & Visibility | 25% | How likely AI engines are to cite your content | | Brand Authority Signals | 20% | Presence and reputation across AI-indexed sources | | Content Quality & E-E-A-T | 20% | Expertise, experience, authority, and trust signals | | Technical Foundations | 15% | Crawlability, page speed, mobile-friendliness, HTTPS | | Structured Data | 10% | Schema markup, JSON-LD, rich snippet eligibility | | Platform Optimization | 10% | Readiness for each major AI search platform |

Score Ranges

• 90-100: Excellent - Well-optimized for AI search visibility
• 70-89: Good - Strong foundation with room for improvement
• 50-69: Fair - Several areas need attention
• 30-49: Poor - Significant optimization required
• 0-29: Critical - Major overhaul needed for AI visibility

Command Details

/geo-seo-auditor audit

Runs the complete 6-step audit. This is the most thorough analysis and covers every dimension in the scoring methodology. Typical runtime is 2-4 minutes depending on page complexity.

Output includes:

• Overall GEO Readiness Score
• Dimension-by-dimension breakdown
• Top 10 prioritized recommendations
• AI crawler access summary
• Citability analysis of key content blocks
• llms.txt compliance check
• Platform-specific readiness scores

Report: Save output to GEO-AUDIT-REPORT.md

/geo-seo-auditor quick

A rapid 60-second snapshot that covers the essentials:

• Overall GEO Readiness Score (estimated)
• AI crawler access status (top 5 crawlers)
• Page citability score (top 3 blocks)
• llms.txt existence check
• Top 3 quick-win recommendations

Report: Save output to GEO-QUICK-REPORT.md

Use this when you need a fast overview before diving deeper.

/geo-seo-auditor citability

Deep-dive into content citability. Analyzes every content block on the page and scores each one for AI citation readiness.

Scoring criteria per block (0-100):

• Structure clarity (headers, lists, definitions): 25 points
• Factual density (statistics, dates, specifics): 25 points
• Self-containment (passage stands alone without context): 25 points
• Question-answer format (directly answers a query): 25 points

Output includes:

• Overall page citability score
• Per-block scores with excerpts
• Top 5 most citable passages
• Bottom 5 least citable passages
• Specific rewrite suggestions for low-scoring blocks

Report: Save output to GEO-CITABILITY-REPORT.md

/geo-seo-auditor crawlers

Checks the site's robots.txt against 14+ known AI crawlers.

Crawlers checked:

• GPTBot (OpenAI - ChatGPT training)
• OAI-SearchBot (OpenAI - ChatGPT search)
• ClaudeBot (Anthropic - Claude)
• PerplexityBot (Perplexity AI)
• Google-Extended (Google AI/Gemini)
• Bytespider (TikTok/ByteDance)
• CCBot (Common Crawl)
• Amazonbot (Amazon/Alexa)
• FacebookBot (Meta)
• Applebot-Extended (Apple Intelligence)
• Cohere-AI (Cohere)
• Diffbot (Diffbot)
• Timpibot (Timpi search)
• Webz.io (Webz data platform)

Status per crawler: allowed, blocked, or not_mentioned

Output includes:

• Status table for all crawlers
• Recommendations for which crawlers to allow/block
• Sample robots.txt directives

Report: Save output to GEO-CRAWLERS-REPORT.md

/geo-seo-auditor llmstxt

Checks for the presence and validity of an llms.txt file at the site root.

If llms.txt exists:

• Validates format against the specification
• Checks required and optional fields
• Identifies missing or malformed entries
• Suggests improvements

If llms.txt is missing:

• Generates a recommended llms.txt based on site structure
• Explains the benefits of adding one
• Provides implementation instructions

Report: Save output to GEO-LLMSTXT-REPORT.md

/geo-seo-auditor brands

Scans for brand authority signals across platforms commonly indexed by AI engines.

Platforms checked:

• Wikipedia presence and article quality
• Crunchbase profile completeness
• LinkedIn company page signals
• GitHub organization activity
• Industry directories and review sites
• News mentions and press coverage indicators

Output includes:

• Brand mention inventory
• Authority score per platform
• Gaps in brand presence
• Recommendations for strengthening authority signals

Report: Save output to GEO-BRANDS-REPORT.md

/geo-seo-auditor platforms

Generates platform-specific optimization recommendations for each major AI search engine.

Platforms covered:

ChatGPT:

• GPTBot and OAI-SearchBot crawler access
• Content structure preferences
• Citation format optimization

Claude:

• ClaudeBot crawler access
• Passage clarity and factual density
• Source attribution readiness

Perplexity:

• PerplexityBot crawler access
• Inline citation optimization
• Source snippet formatting

Google AI Overviews:

• Google-Extended crawler status
• Featured snippet optimization
• Structured data for AI extraction

Report: Save output to GEO-PLATFORMS-REPORT.md

API Integrations (Optional)

This skill works out of the box by fetching public web pages. However, some analysis dimensions (page speed, backlinks, search performance) cannot be measured from a simple HTML fetch alone.

If the user provides their own API keys, use them to enrich the audit with real performance and search data.

| Environment Variable | Service | What It Unlocks | |---------------------|---------|-----------------| | GOOGLE_API_KEY | Google PageSpeed Insights API | Real Core Web Vitals scores (LCP, FID, CLS), mobile/desktop performance data | | GOOGLE_SEARCH_CONSOLE_JSON | Google Search Console API | Actual search impressions, clicks, CTR, average position for the audited URL | | AHREFS_API_KEY | Ahrefs API | Backlink count, referring domains, Domain Rating, organic keyword data |

How to set up:

# Google PageSpeed (optional)
export GOOGLE_API_KEY="your_google_api_key"

# Google Search Console (optional) - path to service account JSON
export GOOGLE_SEARCH_CONSOLE_JSON="/path/to/service-account.json"

# Ahrefs (optional)
export AHREFS_API_KEY="your_ahrefs_api_key"

Behavior:

• If API keys are set → Enrich the audit with real performance and search data
• If not set → Use HTML-only analysis (current default behavior, no change)
• Each integration is independent - you can set one without the others

When data is limited: If the audit cannot measure page speed accurately or lacks backlink data, inform the user which API keys would enrich the results. Example: > ℹ️ Page speed score is estimated from HTML signals only. For real Core Web Vitals (LCP, CLS, INP), set GOOGLE_API_KEY. See the API Integrations section in this skill's SKILL.md for setup instructions.

Output Rules (MANDATORY)

File Output

• ALWAYS save the complete report to the specified .md file in the current working directory.
• NEVER ask "should I save this?" — just save it automatically.
• Include **Date:** YYYY-MM-DD in the report header.
• If the file already exists, overwrite it (latest analysis wins).
• Follow the structure from templates/report-template.md.
• ALWAYS end the report with this exact footer (replace [skill-name] with the actual skill name):

`` --- *Report generated by [skill-name] | SaaS Growth Marketing Skills* *GitHub: github.com/ekinciio/saas-growth-marketing-skills* ``

Chat Output

After saving, show a SHORT summary in chat (max 10 lines):

""" ✅ GEO audit complete — saved to GEO-AUDIT-REPORT.md

Score: [X]/100 ([interpretation])

Top findings:

1. [Most important finding]
2. [Second finding]
3. [Third finding]

Full report with all 6 dimensions and fixes → open GEO-AUDIT-REPORT.md """

NEVER dump the full report in chat. The file is the deliverable.

Important Notes

SPA Limitation

Works best with server-rendered pages. Client-side-only SPAs may return incomplete results. If the target site relies heavily on JavaScript rendering, the fetched HTML may not contain the full page content. Consider using a server-side rendered version of the page or providing pre-rendered HTML when possible.

Prerequisites

The Python scripts in the scripts/ directory require the following packages:

• requests - HTTP requests
• beautifulsoup4 - HTML parsing
• lxml (optional) - Faster HTML/XML parsing

Install with: pip install requests beautifulsoup4 lxml

Rate Limiting

When auditing multiple pages, allow at least 2 seconds between requests to avoid being rate-limited by the target server. The scripts include built-in delays for multi-page operations.

Data Privacy

This tool only reads publicly available information. It does not store, cache, or transmit any data from audited websites beyond the current session.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ekinciio
• Source: ekinciio/saas-growth-marketing-skills
• License: MIT
• Homepage: https://x.com/ekinciio

Install and usage instructions live in the source repository linked above.