# Claude SEO - llms-full.txt # https://claude-seo.md/ > Full text of every page on claude-seo.md for single-fetch AI ingestion. > Summary index lives at /llms.txt. This file concatenates page content > with URL + title delimiters between each entry. # Generated: 2026-04-20 --- ## Claude SEO - Free AI SEO Audit Tool for Claude Code URL: https://claude-seo.md/ CRAWLER AUDITOR INDEXER RANKER v1.9.0 // FREE // OPEN SOURCE // MIT YOUR SEO TEAM IN THE TERMINAL. One day, SEO used to cost $5-10K/month for agencies to tell you what was broken. That era is over. Claude SEO is a free, open-source AI SEO audit tool: 23 sub-skills, 17 subagents, 3 extensions, one command. You type /seo audit and go make coffee. $ git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git && bash claude-seo/install.sh COPY WORKS ON MACOS, LINUX, WINDOWS. WINDOWS POWERSHELL INSTALL ★ 4.9K+ STARS SEE DEMO FEATURES DOCS // SEE IT IN ACTION FREE SEO AUDIT IN 12 MINUTES THE FULL DEMO. TYPE ONE COMMAND. 9 AI AGENTS ANALYZE YOUR SITE IN PARALLEL. 31K+ DEVELOPERS HAVE WATCHED THIS. 31K+ VIEWS 1K LIKES 12:52 RUNTIME BY AGRICI DANIEL WATCH ON YOUTUBE → QUICK PREVIEWS COMMAND MENU TYPE /SEO AND PICK YOUR ANALYSIS. 16 COMMANDS. PASTE A URL AND GO. FULL SITE AUDIT 9 AI AGENTS RUN IN PARALLEL. 0-100 HEALTH SCORE + PRIORITIZED ACTION PLAN. // INSTALL CLONE. INSTALL. AUDIT. 01 Clone git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git 02 Install bash claude-seo/install.sh Windows: powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1 03 Audit claude /seo audit https://your-site.com 9 AI agents analyze your site in parallel. Go make coffee. 14 SUB-SKILLS 9 PARALLEL AI AGENTS 16 COMMANDS $0 FOREVER. MIT LICENSED. 4,900+ GITHUB STARS 732 FORKS 31K+ YOUTUBE VIEWS 5 INDUSTRY TYPES $0 FREE FOREVER // WHAT IT COVERS 14 SEO TOOLS. ONE INSTALL. 01 FULL SITE AUDIT [9 AI AGENTS] 9 SUBAGENTS RUN SIMULTANEOUSLY. AUTO-DETECTS SAAS, LOCAL, E-COMMERCE, PUBLISHER, AGENCY. PRODUCES A 0-100 HEALTH SCORE THAT AGENCIES CHARGE $5K TO GENERATE. 02 TECHNICAL SEO [9 CATEGORIES] CRAWLABILITY, INDEXABILITY, SECURITY, URL STRUCTURE, MOBILE, CORE WEB VITALS (INP), STRUCTURED DATA, JS RENDERING, INDEXNOW. 03 E-E-A-T CONTENT [QRG 2025] EXPERIENCE, EXPERTISE, AUTHORITATIVENESS, TRUSTWORTHINESS PER SEPT 2025 QUALITY RATER GUIDELINES. THIN CONTENT DETECTION. 04 SCHEMA MARKUP DETECTS SCHEMA.ORG DATA, VALIDATES AGAINST GOOGLE, GENERATES JSON-LD. HOWTO REMOVED SEPT 2023, FAQPAGE RESTRICTED AUG 2023. 05 GEO / AI SEARCH [AI] GOOGLE AI OVERVIEWS, CHATGPT, PERPLEXITY, BING COPILOT. AI CRAWLER ACCESS, LLMS.TXT, PASSAGE-LEVEL CITABILITY. 06 LOCAL SEO GOOGLE BUSINESS PROFILE, NAP CONSISTENCY, CITATION TIERS, REVIEW SENTIMENT, MAP PACK FACTORS, MULTI-LOCATION. MAPS INTELLIGENCE STRATEGIC PLANNING PROGRAMMATIC SEO COMPETITOR PAGES HREFLANG / I18N IMAGE OPTIMIZATION SITEMAP ANALYSIS DATAFORSEO [EXT] AI IMAGE GEN [EXT] // ALL COMMANDS TYPE /SEO. PICK YOUR WEAPON. /seo audit FULL AUDIT, 9 PARALLEL AI AGENTS, 0-100 HEALTH SCORE /seo page DEEP SINGLE-PAGE ANALYSIS /seo technical TECHNICAL SEO ACROSS 9 CATEGORIES /seo content E-E-A-T CONTENT QUALITY ASSESSMENT /seo schema SCHEMA.ORG DETECTION, VALIDATION, GENERATION /seo sitemap XML SITEMAP ANALYSIS OR GENERATION /seo images IMAGE OPTIMIZATION ANALYSIS /seo geo GEO FOR AI OVERVIEWS, CHATGPT, PERPLEXITY /seo local GBP, CITATIONS, REVIEWS, NAP, MAP PACK /seo maps GEO-GRID RANK TRACKING, GBP AUDIT, COMPETITOR RADIUS /seo plan INDUSTRY-SPECIFIC STRATEGIC PLANNING /seo programmaticPROGRAMMATIC SEO AT SCALE WITH QUALITY GATES /seo competitor-pages"X VS Y" AND ALTERNATIVES COMPARISON PAGES /seo hreflang INTERNATIONAL SEO / HREFLANG AUDIT /seo dataforseoLIVE SERP, KEYWORD, BACKLINK DATA [EXT] /seo image-gen AI IMAGE GENERATION FOR SEO ASSETS [EXT] // HOW SCORING WORKS 0-100 SEO HEALTH SCORE CONTENT QUALITY 23% TECHNICAL SEO 22% ON-PAGE SEO 20% SCHEMA 10% PERFORMANCE 10% AI READINESS 10% IMAGES 5% CRITICAL BLOCKS INDEXING OR TRIGGERS PENALTIES. FIX IMMEDIATELY. HIGH SIGNIFICANTLY IMPACTS RANKINGS. FIX WITHIN 1 WEEK. MEDIUM OPTIMIZATION OPPORTUNITY. TARGET WITHIN 1 MONTH. LOW NICE TO HAVE. ADD TO THE BACKLOG. // REAL AUDITS TESTED ON PRODUCTION SITES REAL AUDITS RUN BY CLAUDE SEO ON LIVE WEBSITES. ACTUAL SCORES. ACTUAL FINDINGS. 64/100 dexdia.com NUXT 3 // VERCEL // TAILWIND // E-COMMERCE Multiple H1 tags on homepage and product page 6 blog posts below 1,500-word quality gate Missing CSP, X-Frame-Options, Referrer-Policy headers Title tags truncating at 85 characters 58/100 rankenstein.pro NEXT.JS // SAAS // AI SEO TOOL GPTBot blocked in robots.txt (ChatGPT score: 48/100) Multi-modal content score only 45/100 Authority and brand signals at 42/100 No IndexNow implementation detected 62/100 callperfectcatch.com LOCAL ELECTRICIAN // LARGO, FL GBP Profile Completeness 78/100 Review Health only 45/100 Cross-platform presence 72/100 (15 social links) Missing aggregateRating in LocalBusiness schema // FROM THE COMMUNITY WHAT DEVELOPERS ARE SAYING REAL FEEDBACK FROM DEVELOPERS WHO TRIED CLAUDE SEO. "Fantastic job! I've started using it on my business website, and it's uncovering so many issues and opportunities I completely overlooked." @Geronimo_sudo-AI // 8 LIKES // YOUTUBE "I've run this on two of my websites and uncovered tonnes of improvements that didn't show on other free online tools. THANK YOU!" @bazfurby // YOUTUBE "I made some changes to plug different MCP (Google Ads, Analytics, GSC and DataForSEO). That seems great!" @LordDjay // 7 LIKES // YOUTUBE "Amazing work man, currently using it on my business webpage and it's pointing out so many things I never found. Subscribed!" @Reesepj // YOUTUBE "This is soooo awesome man! Will share it to my readers. Thank you!" @michael_negele // YOUTUBE "This is great! Thank you!! Claude SEO FTW!!" @JakeStPeter // YOUTUBE VIEW ALL COMMENTS ON YOUTUBE → // FAQ QUESTIONS PEOPLE ACTUALLY ASK WHAT IS CLAUDE SEO?- A FREE, OPEN-SOURCE AI SEO AUDIT TOOL THAT RUNS INSIDE CLAUDE CODE. 23 SUB-SKILLS AND 17 SUBAGENTS HANDLE TECHNICAL SEO, E-E-A-T CONTENT QUALITY, SCHEMA MARKUP, GEO (AI SEARCH OPTIMIZATION), LOCAL SEO, SEMANTIC CLUSTERING, SXO, DRIFT MONITORING, E-COMMERCE, AND STRATEGIC PLANNING. MIT LICENSED. 4,900+ GITHUB STARS. THE IDEA: YOU TYPE ONE COMMAND AND GET THE SAME ANALYSIS AN AGENCY WOULD CHARGE YOU $5-10K/MONTH TO PRODUCE. HOW DO I INSTALL IT?+ THREE COMMANDS. git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git THEN bash claude-seo/install.sh. FOR WINDOWS: powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1. REQUIRES PYTHON 3.10+ AND CLAUDE CODE CLI. IS IT ACTUALLY FREE?+ YES. FULLY FREE AND OPEN SOURCE UNDER MIT LICENSE. NO PAID TIERS, NO FREEMIUM TRICKS. THE CORE TOOL DOES EVERYTHING WITHOUT SPENDING A CENT. OPTIONAL EXTENSIONS (DATAFORSEO FOR LIVE SERP DATA, BANANA FOR AI IMAGE GENERATION VIA GEMINI) NEED THEIR OWN API KEYS FROM THOSE SERVICES. WHAT DOES THE 0-100 HEALTH SCORE MEASURE?+ 7 WEIGHTED CATEGORIES: CONTENT QUALITY (23%), TECHNICAL SEO (22%), ON-PAGE SEO (20%), SCHEMA (10%), PERFORMANCE INCLUDING CORE WEB VITALS WITH INP (10%), AI SEARCH READINESS (10%), AND IMAGES (5%). EACH AUDIT PRODUCES A PRIORITIZED ACTION PLAN WITH CRITICAL, HIGH, MEDIUM, AND LOW SEVERITY LEVELS. WHICH INDUSTRIES DOES IT SUPPORT?+ ALL OF THEM. CLAUDE SEO AUTO-DETECTS 5 BUSINESS TYPES FROM YOUR HOMEPAGE: SAAS (PRICING PAGES, FEATURE LISTS), LOCAL SERVICE (PHONE, ADDRESS, SERVICE AREAS), E-COMMERCE (PRODUCT PAGES, CARTS), PUBLISHER (BLOG, ARTICLES), AND AGENCY (CASE STUDIES, PORTFOLIOS). THE ANALYSIS AND RECOMMENDATIONS ADAPT TO YOUR SPECIFIC INDUSTRY. WHAT IS GEO (GENERATIVE ENGINE OPTIMIZATION)?+ GEO OPTIMIZES YOUR CONTENT FOR AI-POWERED SEARCH ENGINES. GOOGLE AI OVERVIEWS, CHATGPT WEB SEARCH, PERPLEXITY, AND BING COPILOT NOW GENERATE ANSWERS THAT CITE SOURCES. CLAUDE SEO CHECKS YOUR AI CRAWLER ACCESS (GPTBOT, CLAUDEBOT, PERPLEXITYBOT), LLMS.TXT COMPLIANCE, PASSAGE-LEVEL CITABILITY, AND BRAND MENTION SIGNALS SO YOUR CONTENT GETS CITED. WHAT MCP INTEGRATIONS WORK WITH IT?+ OFFICIAL AHREFS MCP (@AHREFS/MCP), SEMRUSH MCP SERVER, PLUS COMMUNITY SERVERS FOR GOOGLE SEARCH CONSOLE, PAGESPEED INSIGHTS, AND DATAFORSEO. THE DATAFORSEO EXTENSION ALONE ADDS 22 COMMANDS ACROSS 9 API MODULES FOR LIVE SERP, KEYWORD VOLUME, BACKLINK, AND AI VISIBILITY DATA. HOW DOES IT COMPARE TO AHREFS OR SEMRUSH?+ AHREFS COSTS $99/MO. SEMRUSH COSTS $117/MO. CLAUDE SEO COSTS $0. IT RUNS IN YOUR TERMINAL, SPAWNS 9 PARALLEL AI AGENTS, GENERATES JSON-LD SCHEMA MARKUP, VALIDATES AGAINST CURRENT GOOGLE REQUIREMENTS, AND OPTIMIZES FOR AI SEARCH ENGINES. THE TRADE-OFF: IT REQUIRES CLAUDE CODE AND A TERMINAL. IF THAT IS YOUR WORKFLOW ALREADY, THERE IS NO REASON TO PAY FOR A BROWSER-BASED TOOL. // ECOSYSTEM WORKS WITH THESE CLAUDE SEO THIS PROJECT. 23 SUB-SKILLS, 17 SUBAGENTS, 30 SCRIPTS. INTEGRATES WITH AHREFS AND SEMRUSH MCP. FREE FOREVER. AGRICIDANIEL/CLAUDE-SEO → CLAUDE BLOG 19 SUB-SKILLS, 4 AI AGENTS, 17 COMMANDS, 12 CONTENT TEMPLATES. USES SEO FINDINGS TO WRITE BLOG POSTS THAT RANK. CLAUDE-BLOG.MD → CLAUDE BANANA AI IMAGE GENERATION VIA GOOGLE GEMINI. GENERATES OG IMAGES, HERO GRAPHICS, AND SEO ASSETS FROM TEXT PROMPTS. AGRICIDANIEL/BANANA-CLAUDE → [THE PITCH] YOU ALREADY HAVE A TERMINAL OPEN. 4,900+ developers on GitHub. 31K+ YouTube views. MIT licensed, free forever. The install takes 30 seconds. The audit runs itself. You just read the report. COPY THE INSTALL COMMANDGITHUB > --- ## CLAUDE.md URL: https://claude-seo.md/CLAUDE.md # Claude SEO Website ## Overview Multi-page static website for **Claude SEO** (https://claude-seo.md), the open-source AI SEO audit skill for Claude Code. Deployed on Vercel with custom domain. Live since 2026-03-24. Expanded from 1 page to 23 pages on 2026-03-25. Major SEO overhaul on 2026-03-27 (favicon, OG images, Lighthouse fixes, schema standardization, internal linking, author bios, performance optimization, 404 page). 5 new blog posts added 2026-03-28 to 2026-04-06 (v172, wp-mcp, google-api, v180, v181). ## Architecture Static HTML site. No frameworks, no build step, no dependencies. All CSS and JS are inline in each HTML file. Each page is fully self-contained. Vercel `cleanUrls: true` strips .html extensions. ``` claude-seo-website/ CLAUDE.md # This file (project context for Claude) index.html # Main landing page (all CSS/JS inline, ~84KB) claude-seo.md # Extended project description (Markdown, served as page) llms.txt # AI crawler summary (llms.txt standard, includes all page URLs) robots.txt # Crawler directives (8 AI bots explicitly allowed) sitemap.xml # 31-URL sitemap (no deprecated priority/changefreq) vercel.json # cleanUrls + security headers + Cache-Control for assets 404.html # Custom 404 page (branded, links to home/skills/blog) _headers # Netlify/Cloudflare-compatible security headers fd7eef1f-d9c8-4816-b5ee-5c12e7e6c58e.txt # IndexNow verification key favicon.svg # SVG favicon (coral S on dark bg, all pages) .gitignore # Excludes .vercel/, .env, node_modules, _shared/ scripts/ google-index.py # Google Indexing API submission script (OAuth2) gsc-audit.py # Google Search Console audit script (URL inspection, performance, sitemaps) .google-token.json # OAuth token (gitignored, regenerate with --auth) skills/ index.html # /skills - card grid of all 14 skills seo-audit.html # /skills/seo-audit - full site audit (9 agents) seo-technical.html # /skills/seo-technical - 9 technical categories seo-content.html # /skills/seo-content - E-E-A-T analysis seo-schema.html # /skills/seo-schema - JSON-LD detection/generation seo-geo.html # /skills/seo-geo - GEO for AI search platforms seo-local.html # /skills/seo-local - GBP, NAP, citations, reviews seo-maps.html # /skills/seo-maps - geo-grid, GBP audit, competitor radius seo-page.html # /skills/seo-page - single page deep analysis seo-images.html # /skills/seo-images - alt text, formats, lazy loading seo-sitemap.html # /skills/seo-sitemap - XML sitemap analysis/generation seo-hreflang.html # /skills/seo-hreflang - international SEO audit seo-competitor-pages.html # /skills/seo-competitor-pages - X vs Y page generator seo-plan.html # /skills/seo-plan - strategic SEO planning seo-programmatic.html # /skills/seo-programmatic - pages at scale blog/ index.html # /blog - card grid of all blog posts claude-seo-v181-image-seo.html # Release update (2026-04-06) claude-seo-v180-free-backlinks.html # Release update (2026-04-02) claude-seo-v172-update.html # Release update (2026-03-31) wp-mcp-ultimate-wordpress-ai-seo.html # Tutorial (2026-03-29) google-api-seo-reporting-claude.html # Tutorial (2026-03-28) how-to-run-free-seo-audit-claude-seo.html # Tutorial (step-by-step audit guide) claude-seo-vs-ahrefs-semrush.html # Comparison article (87/100 quality) technical-seo-with-claude-code.html # Tutorial (83/100) generative-engine-optimization-guide.html # GEO guide (92/100) best-claude-code-skills.html # Listicle (74/100) schema-markup-generator-guide.html # Tutorial (82/100) free-seo-audit-tool-guide.html # Roundup (83/100) assets/ og-image.jpg # Main OG image (1200x630, 72KB) og-image.webp # WebP version of main OG image seo-command-demo.mp4 # Demo video: command menu (33KB) seo-command-demo.webm # Demo video: command menu WebM (52KB) seo-audit-demo.mp4 # Demo video: full audit (48KB) seo-audit-demo.webm # Demo video: full audit WebM (69KB) seo-command-demo-poster.jpg # Video poster frame seo-audit-demo-poster.jpg # Video poster frame seo-command-demo-poster.webp # WebP poster seo-audit-demo-poster.webp # WebP poster og/ # OG images per page (1200x630, WebP) seo-audit.webp, seo-geo.webp, seo-schema.webp, seo-technical.webp, seo-local.webp, seo-content.webp, seo-images.webp, seo-sitemap.webp, seo-page.webp, seo-hreflang.webp, seo-competitor-pages.webp, seo-plan.webp, seo-programmatic.webp, seo-maps.webp, claude-seo-cover.webp, vs-ahrefs.webp, geo-guide.webp, best-skills.webp, technical-seo.webp, schema-guide.webp, free-tools.webp, free-audit-guide.webp, google-api-seo.webp, wp-mcp-ultimate.webp, claude-seo-v172.webp, claude-seo-v180.webp, claude-seo-v181.webp skills/ # Skill page hero images (16:9, WebP) seo-audit-hero.webp, seo-geo-hero.webp, seo-schema-hero.webp, seo-technical-hero.webp, seo-local-hero.webp, claude-seo-hero.webp, seo-command-demo.gif blog/ # Blog post hero images (16:9, WebP) vs-ahrefs-hero.webp, geo-guide-hero.webp, best-skills-hero.webp, technical-seo-hero.webp, schema-guide-hero.webp, free-tools-hero.webp, free-audit-guide-hero.webp, google-api-seo-hero.webp, wp-mcp-ultimate-hero.webp, claude-seo-v172-hero.webp, claude-seo-v180-hero.webp, claude-seo-v181-hero.webp ``` Total: 30 HTML pages (29 content + 404), 60 asset files (+ favicon.svg + favicon-48.png + favicon-192.png + favicon-512.png). ## Page Inventory (29 pages) ### Homepage (1) - `index.html` (/) - main landing page with 13 sections (incl. "Latest from the Blog"), 6 JSON-LD schema blocks ### Skill Pages (15 = 14 detail + 1 index) Each skill page has: SoftwareApplication + FAQPage + BreadcrumbList + Person schema, inline SVG diagram, bento feature grid, FAQ accordion, related skills section, "Related Guide" blog link section, install CTA. | File | URL | Target Keywords | |------|-----|----------------| | skills/index.html | /skills | "claude seo skills", "claude code seo tools" | | skills/seo-audit.html | /skills/seo-audit | "claude seo audit", "free seo audit tool" | | skills/seo-technical.html | /skills/seo-technical | "technical seo audit tool" | | skills/seo-content.html | /skills/seo-content | "eeat content analysis tool" | | skills/seo-schema.html | /skills/seo-schema | "schema markup generator", "json-ld generator" | | skills/seo-geo.html | /skills/seo-geo | "generative engine optimization", "GEO seo" | | skills/seo-local.html | /skills/seo-local | "local seo audit tool", "gbp audit" | | skills/seo-maps.html | /skills/seo-maps | "local seo rank tracking", "geo-grid seo" | | skills/seo-page.html | /skills/seo-page | "single page seo analysis" | | skills/seo-images.html | /skills/seo-images | "image seo optimization tool" | | skills/seo-sitemap.html | /skills/seo-sitemap | "xml sitemap generator" | | skills/seo-hreflang.html | /skills/seo-hreflang | "hreflang audit tool" | | skills/seo-competitor-pages.html | /skills/seo-competitor-pages | "competitor comparison generator" | | skills/seo-plan.html | /skills/seo-plan | "seo strategy template" | | skills/seo-programmatic.html | /skills/seo-programmatic | "programmatic seo tool" | ### Blog Posts (13 = 12 articles + 1 index) Each blog post has: BlogPosting + FAQPage + BreadcrumbList + Person schema, hero image, inline SVG charts, author bio section, FAQ accordion, related links, install CTA. | File | URL | Published | Quality Score | |------|-----|-----------|--------------| | blog/index.html | /blog | n/a | n/a (index) | | blog/claude-seo-v181-image-seo.html | /blog/claude-seo-v181-image-seo | 2026-04-06 | - | | blog/claude-seo-v180-free-backlinks.html | /blog/claude-seo-v180-free-backlinks | 2026-04-02 | - | | blog/claude-seo-v172-update.html | /blog/claude-seo-v172-update | 2026-03-31 | - | | blog/wp-mcp-ultimate-wordpress-ai-seo.html | /blog/wp-mcp-ultimate-wordpress-ai-seo | 2026-03-29 | - | | blog/google-api-seo-reporting-claude.html | /blog/google-api-seo-reporting-claude | 2026-03-28 | - | | blog/generative-engine-optimization-guide.html | /blog/generative-engine-optimization-guide | 2026-03-25 | 92/100 | | blog/claude-seo-vs-ahrefs-semrush.html | /blog/claude-seo-vs-ahrefs-semrush | 2026-03-25 | 87/100 | | blog/technical-seo-with-claude-code.html | /blog/technical-seo-with-claude-code | 2026-03-25 | 83/100 | | blog/free-seo-audit-tool-guide.html | /blog/free-seo-audit-tool-guide | 2026-03-25 | 83/100 | | blog/schema-markup-generator-guide.html | /blog/schema-markup-generator-guide | 2026-03-25 | 82/100 | | blog/best-claude-code-skills.html | /blog/best-claude-code-skills | 2026-03-25 | 74/100 | | blog/how-to-run-free-seo-audit-claude-seo.html | /blog/how-to-run-free-seo-audit-claude-seo | 2026-03-25 | - | ## Design System All pages share the same inline CSS (no external stylesheets). Changes must be propagated to every file. ### CSS Variables ```css :root { --coral: #E07850; /* Primary accent */ --orange: #FF6B35; /* Hover state */ --bg: #0A0A0A; /* Background */ --surface: #111111; /* Card backgrounds */ --surface2: #1A1A1A; /* Elevated surfaces */ --text: #F5F5F0; /* Primary text */ --text-gray: #888888; /* Secondary text */ --text-muted: #8a8a8a; /* Tertiary text (WCAG AA compliant on #0A0A0A and #111111) */ --text-dim: #878787; /* Dimmed text (WCAG AA compliant) */ --border: #2D2D2D; /* Borders */ --border-subtle: #1D1D1D;/* Subtle borders */ --green: #4ADE80; /* Success */ --blue: #60A5FA; /* Info */ --rose: #F43F5E; /* Critical */ --amber: #F0A830; /* Warning */ --grotesk: 'Space Grotesk', system-ui, sans-serif; /* Headings */ --mono: 'IBM Plex Mono', 'JetBrains Mono', monospace; /* Body */ } ``` ### Typography - Headings: Space Grotesk (700 weight) - Body/code: IBM Plex Mono (400/700 weight) - Google Fonts with `display=optional` (no FOIT/FOUT) ### Responsive Breakpoints - Desktop: 900px+ - Tablet: 768-900px (hamburger nav, single column grids) - Phone: 480-768px (reduced padding, stacked layouts) - Small phone: <360px (minimum sizes) ### Navigation - Homepage: section anchor links (Demo, Features, Commands, Skills, Blog, FAQ) - Subpages: simplified nav (Home, Skills, Blog, GitHub icon) - Mobile: hamburger menu with slide-down drawer ### Reusable Component Classes - `.wrap` - max-width:1100px container - `.section` - full-width section with 100px padding - `.sec-label` / `.sec-title` / `.sec-sub` - section headers - `.bento` / `.bento-card` - 3-column feature grid - `.btn-primary` / `.btn-ghost` - CTA buttons - `.faq-list` / `.faq-item` - accordion FAQ - `.pixel-div` - coral/black alternating divider - `.breadcrumb` - breadcrumb navigation - `.article-body` - prose content styling (blog posts) - `.skill-hero-img` - hero image styling - `.related-grid` / `.related-card` - related items grid - `.hero-install` - copy-to-clipboard install command bar - `.score-bars` / `.score-fill` - animated score bars (IntersectionObserver) ## Deployment Hosted on Vercel (Hobby plan, free tier). Domain: `claude-seo.md` (Moldova .md TLD). ```bash # Deploy to production cd /home/agricidaniel/Desktop/claude-seo-website vercel deploy --prod # Preview deployment vercel # Check deployment status vercel ls ``` - Vercel project: `site` (agricidaniel-9454) - Production URL: https://claude-seo.md/ - cleanUrls enabled (no .html extensions in URLs) ## DNS and SSL - Domain registrar: IP Host Moldova (client.innovahosting.net) - Nameservers: `ns1.vercel-dns.com`, `ns2.vercel-dns.com` (Vercel-managed) - SSL: Auto-provisioned by Vercel (Let's Encrypt) - HTTP redirect: 308 Permanent (HTTP -> HTTPS) - Google Search Console: TXT record added for verification - CAA records: pki.goog, sectigo.com, letsencrypt.org ## Indexing ### Google Indexing API Script at `scripts/google-index.py` submits URLs directly to Google for fast crawling. ```bash # First time: authenticate (opens browser for OAuth) python3 scripts/google-index.py --auth # Submit all URLs for indexing python3 scripts/google-index.py --submit # Check status python3 scripts/google-index.py --status ``` - OAuth credentials: `~/Downloads/client_secret_2_481030700720-*.json` - Token stored at: `scripts/.google-token.json` (auto-refreshes) - Last submitted: 2026-03-27 (24/24 URLs, 0 errors) ### Google Search Console Audit Script at `scripts/gsc-audit.py` inspects indexing status, search performance, and sitemaps. ```bash python3 scripts/gsc-audit.py # Full audit (sitemaps + performance + inspection) python3 scripts/gsc-audit.py --inspect # URL inspection only (indexing status per page) python3 scripts/gsc-audit.py --performance # Search queries and page performance python3 scripts/gsc-audit.py --sitemaps # Sitemap submission status ``` - Uses same OAuth token as google-index.py (webmasters scope) - GSC property: `sc-domain:claude-seo.md` (domain-level) - As of 2026-03-27: 3/24 pages indexed (homepage, seo-technical, seo-schema), 21 in queue ### IndexNow (Bing/Yandex) - Key: `fd7eef1f-d9c8-4816-b5ee-5c12e7e6c58e` - Key file served at: https://claude-seo.md/fd7eef1f-d9c8-4816-b5ee-5c12e7e6c58e.txt - Submit via POST to `https://api.indexnow.org/IndexNow` with the key and URL list - Last submitted: 2026-03-27 (24 URLs, HTTP 200) ## Security Headers (verified active on production) | Header | Value | |--------|-------| | Content-Security-Policy | Restrictive policy (self, inline, Google Fonts, YouTube only) | | Strict-Transport-Security | max-age=63072000; includeSubDomains; preload | | X-Content-Type-Options | nosniff | | X-Frame-Options | DENY | | Referrer-Policy | strict-origin-when-cross-origin | | Permissions-Policy | camera=(), microphone=(), geolocation=() | ## AI Crawler Access (robots.txt) All 8 major AI search crawlers explicitly allowed: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, PerplexityBot, Google-Extended, Googlebot, Bingbot ## Schema Markup ### Homepage (6 JSON-LD blocks) 1. SoftwareApplication (name, version 1.7.0, offers $0, dates, author, license, image) 2. FAQPage (8 Q&A pairs matching visible FAQ section) 3. WebSite (name, url, description, author) 4. BreadcrumbList (homepage) 5. Person (Daniel Agrici with sameAs: GitHub, YouTube, LinkedIn, Skool; knowsAbout: 6 topics) 6. VideoObject (YouTube demo, 31K+ views, duration PT12M52S) ### Skill Pages (4 JSON-LD blocks each) - SoftwareApplication (skill-specific name, description, version 1.7.0, $0) - FAQPage (4-5 Q&A pairs matching visible FAQ) - BreadcrumbList (Home > Skills > Skill Name) - Person (Daniel Agrici with sameAs: GitHub, YouTube, LinkedIn, Skool; knowsAbout: 6 topics) ### Blog Posts (4 JSON-LD blocks each) - BlogPosting (headline, datePublished, dateModified, author, wordCount, keywords, image) - FAQPage (4-5 Q&A pairs matching visible FAQ) - BreadcrumbList (Home > Blog > Title) - Person (Daniel Agrici with sameAs links) Note: FAQPage will not generate Google rich results (restricted to gov/health since Aug 2023) but is kept for AI/LLM citation value (GEO strategy). ## Internal Linking Structure ### From Homepage (index.html) - 6 bento feature cards link to their skill pages (wrapped in `` tags) - 14 command rows link to all skill pages including seo-maps (wrapped in `` tags) - "Latest from the Blog" section with 3 featured blog post cards + "View All" link - Nav has Skills and Blog links - Footer has Skills, Blog, GitHub, YouTube, Skool, LinkedIn, Docs, LLMs.txt, Changelog, License ### From Skill Pages - Each links to 3 related skills (keyword-rich anchor text, in "Related Skills" section) - 8 skill pages link to a matching blog post (in "Related Guide" section) - 6 skill pages without matching blog posts link to /blog index - All link back to /skills index - All link to / (homepage via nav brand) ### From Blog Posts - Each links to 2-3 relevant skill pages (inline + related section) - Each cross-links to 1-2 other blog posts - All link back to /blog index ### From Index Pages - skills/index.html links to all 14 skills + "From the Blog" cross-link to /blog - blog/index.html links to all 12 posts + "Explore Skills" cross-link to /skills ### Cross-linking Map (skill -> blog) - seo-audit -> blog/how-to-run-free-seo-audit - seo-technical -> blog/technical-seo-with-claude-code - seo-schema -> blog/schema-markup-generator-guide - seo-geo -> blog/generative-engine-optimization-guide - seo-content -> blog/generative-engine-optimization-guide - seo-page -> blog/how-to-run-free-seo-audit - seo-sitemap -> blog/technical-seo-with-claude-code - seo-competitor-pages -> blog/claude-seo-vs-ahrefs-semrush - seo-local, seo-maps, seo-images, seo-hreflang, seo-plan, seo-programmatic -> /blog (generic) ### Cross-linking Map (blog -> skills + blog) - blog/vs-ahrefs -> seo-audit, seo-technical, seo-schema, seo-geo, blog/free-tools, blog/how-to-run - blog/geo-guide -> seo-geo, seo-content, seo-audit, blog/vs-ahrefs - blog/technical-seo -> seo-technical, seo-schema, seo-audit, blog/vs-ahrefs, blog/schema-guide - blog/free-tools -> seo-audit, seo-technical, seo-schema, blog/vs-ahrefs, blog/technical-seo, blog/how-to-run - blog/best-skills -> seo-audit, seo-geo, skills/index, blog/vs-ahrefs, blog/technical-seo - blog/schema-guide -> seo-schema, seo-technical, blog/geo-guide, blog/technical-seo - blog/how-to-run -> seo-audit, seo-technical, seo-geo, blog/vs-ahrefs, blog/free-tools ## Rules - No em dashes anywhere. Use commas or single hyphens only. - No fabricated data. All stats must be real and verifiable. - Keep all CSS and JS inline (single-file architecture, no build step). - All external links must have `target="_blank" rel="noopener noreferrer"`. - Internal links (to /skills/*, /blog/*) do NOT need target="_blank". - Title tags must be under 60 characters. - Meta descriptions must be 120-160 characters. - OG images use .webp format (except og-image.jpg on homepage which exists as both). - Typewriter spans on homepage must contain visible text fallback for non-JS crawlers. - Videos use MP4+WebM dual source with poster frames. MP4 listed first (smaller). - YouTube embed uses privacy mode (youtube-nocookie.com), loads on click only. - Google Fonts use `display=optional` (no FOIT/FOUT, system fallback if slow). - No `` anywhere (Google ignores since 2009, removed from homepage 2026-03-27). - Sitemap: no deprecated `priority` or `changefreq` tags. - Body text in sentence case for readability. UI elements (nav, labels, badges) in uppercase. - Hero images via Banana skill with Gemini API. Generated with 5-component prompt formula. - SVG charts must be dark-mode compatible using explicit dark colors (#0A0A0A bg, #E07850 accent). - FAQ schema question count must match the visible FAQ section exactly. - Blog posts must have article:published_time meta tag. - Blog post dates should be wrapped in `