Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AgricIDaniel/claude-seo/llms.txt

Use this file to discover all available pages before exploring further.

Local SEO in Claude SEO covers two complementary commands: /seo local analyzes the website for local signals — GBP embeds, NAP data, schema, and on-page content — while /seo maps connects to maps platforms to run geo-grid rank tracking, GBP profile audits, and competitor radius mapping. Together they give you a full picture of how a local business is performing, from the HTML on its homepage to its actual rank at 49 geographic grid points around a city block. This page also covers /seo plan, /seo programmatic, and /seo competitor-pages, which round out the strategic and scale-oriented commands in the skill set.

/seo local <url>

/seo local analyzes a local business website across six weighted dimensions and outputs a scored LOCAL-SEO-ANALYSIS-{domain}.md report with prioritized action items.
/seo local https://example.com

Three core layers

GBP Signals

Categories, hours, photos, posts, products, and attributes. The primary GBP category is the single highest-weighted local pack factor (Whitespark 2026, score 193). The skill checks for GBP embeds, Maps iframes, and place-ID references on the page, then scores completeness against a 25-field checklist.

NAP Consistency

Name, Address, and Phone extracted from three sources — visible page HTML, LocalBusiness JSON-LD schema, and any detectable GBP data — then compared for exact matches. Discrepancies are flagged as Critical (name mismatch), High (address), or Medium (phone).

Review Intelligence

Rating trends, velocity (the Sterling Sky 18-day rule — rankings cliff if no new review in 3 weeks), response rate, and sentiment coverage. The skill surfaces third-party review presence across Google, Yelp, Facebook, and Bing, and flags review-gating patterns (FTC: $53,088/violation).

Local Schema Generation

Produces LocalBusiness JSON-LD with all required and recommended properties: geo coordinates (minimum 5 decimal places), openingHoursSpecification, areaServed, telephone, aggregateRating, and industry-specific subtypes (Restaurant, LegalService, MedicalClinic, AutoDealer) rather than a generic type.

Business type detection

Before running checks, the skill auto-detects whether the site is brick-and-mortar (visible street address, Maps embed), a Service Area Business / SAB (service area language, no street address), or hybrid. SABs skip embedded map verification and physical address consistency checks; brick-and-mortar sites get the full NAP + map pass.

Industry vertical routing

The skill detects six industry verticals — Restaurant, Healthcare, Legal, Home Services, Real Estate, and Automotive — and routes to vertical-specific checks, including Menu + ReserveAction schema for restaurants, Physician + NPI for healthcare, and AutoDealer + inventory schema for automotive.

v2 Phase F: GBP deprecation linter

Version 2 added a linter that flags retired GBP features still referenced on the page or in schema: the chat field (removed), .business.site URLs (deprecated), and the Q&A feature (removed December 2025, replaced by Ask Maps Gemini AI). The recommendation is to recreate Q&A content as proper FAQ sections on the website.
Multi-location doorway-page risk. For sites with many location pages, Claude SEO enforces two thresholds to prevent Google’s doorway-page policy from triggering: a 30-page warning (requires 60–70% unique content per page) and a 50-page hard stop (requires explicit user justification before the audit continues). Both thresholds are configurable. The RicketyRoo “swap test” is applied — if you can replace the city name and the page still makes sense, it is flagged as a doorway page risk. An HVAC company lost 80% of its rankings after the March 2024 Core Update for exactly this pattern.

What the report contains

The output LOCAL-SEO-ANALYSIS-{domain}.md includes a scored dimension breakdown (GBP signals 25%, Reviews 20%, On-Page 20%, NAP/Citations 15%, Schema 10%, Link Authority 10%), detected business type and industry vertical, GBP optimization checklist, NAP cross-source audit, citation presence check for Tier 1 directories, ready-to-use schema fix, and a Top 10 prioritized action list.

/seo maps [command]

/seo maps operates on maps platforms directly rather than on the website HTML. It auto-detects a three-tier capability level at startup — Tier 0 (free: Overpass API, Geoapify, Nominatim), Tier 1 (DataForSEO extension: full geo-grid + live GBP), and Tier 2 (DataForSEO + Google Maps Platform: real-time place summaries). The detected tier is always communicated before any analysis begins.

Subcommands

# Full maps presence audit (auto-selects tier)
/seo maps https://example.com

# Geo-grid rank tracking — 7×7 grid, 49 points, SoLV percentage
/seo maps grid "coffee shop austin tx" "Austin, TX"

# Cross-platform review intelligence (Google, Yelp, Tripadvisor, Trustpilot)
/seo maps reviews "Blue Bottle Coffee" "San Francisco, CA"

# Competitor discovery within a configurable radius
/seo maps competitors "auto repair denver" 5mi

# Cross-platform NAP verification (Google / Bing / Apple / OSM)
/seo maps nap "Example Business"

# GBP completeness audit (25-field scoring with industry weights)
/seo maps gbp "Example Business" "Austin, TX"

# Generate LocalBusiness JSON-LD from collected data
/seo maps schema "Example Business"

Geo-grid rank tracking

Geo-grid tracking simulates Google Maps searches from 49 GPS coordinates (default: 7×7 grid over a 5 km radius) using the Haversine offset formula. It calculates Share of Local Voice (SoLV): (top_3_count / total_points) × 100. The skill always shows a cost estimate and requests confirmation before firing DataForSEO credits.

GBP profile audit

The 25-field GBP audit scores each field: Present + Optimized = 2 pts, Present = 1 pt, Missing = 0 pts. Industry-specific weight multipliers apply. At Tier 0 (no DataForSEO), the skill falls back to a static checklist derived from detectable website signals, marking undetectable fields as “Unknown — requires DataForSEO for live data.”

Review intelligence

Review velocity is tracked against the 18-day rule; rating distribution health is assessed (a healthy profile skews bell-curve toward 5-star); fake review patterns are flagged when two or more signals match (uniform timing, single-review accounts, geographic inconsistencies, sudden spike without marketing activity).

Competitor radius mapping

At Tier 0, Overpass API discovers businesses with the same OSM tag within the radius and ranks by distance. At Tier 1, DataForSEO returns the top 20 competitors with full profile data for a competitive density score (competitors per km²).

Additional strategic commands

/seo plan <type>

Generates a full SEO strategy document set for five business types:
/seo plan saas
/seo plan local
/seo plan ecommerce
/seo plan publisher
/seo plan agency
Outputs include SEO-STRATEGY.md, COMPETITOR-ANALYSIS.md, CONTENT-CALENDAR.md, IMPLEMENTATION-ROADMAP.md (four phases: Foundation → Expansion → Scale → Authority), and SITE-STRUCTURE.md.

/seo programmatic <url>

Audits pages generated at scale from data sources — integration pages, city/service pages, glossary pages — and enforces quality gates: a warning at 30–40% unique content and a hard stop at 500+ pages without justification. Covers data source assessment, template engine design, URL pattern strategy (/[city]/[service], /tools/[tool-name]), internal linking automation, and index bloat prevention.
/seo programmatic https://example.com/locations/
/seo programmatic plan

/seo competitor-pages <url>

Generates “X vs Y” comparison layouts, “Alternatives to X” page structures, and feature comparison matrices with scoring. Applies conversion-optimized CTA placement and produces Product + AggregateRating schema markup. Fairness guidelines enforce accurate data, source citations, affiliate disclosure, and quarterly update cadence.
/seo competitor-pages https://example.com/vs/competitor
/seo competitor-pages generate

Build docs developers (and LLMs) love