charlesjones-dev/ai-seo
Audits a site's code for search rankings (SEO), direct answers in featured snippets and voice assistants (AEO), and citations in AI answers from ChatGPT, Perplexity, Copilot and Google AI Overviews (GEO). Catches SEO patterns LLMs still generate, applies framework-specific fixes, generates and validates JSON-LD, builds FAQ sections and question maps, and writes llms.txt
Audit a site's code through three lenses: SEO (rankings, deprecated tags LLMs still generate, meta tags, structured data, performance signals), AEO (being the direct answer in featured snippets, voice replies and answer boxes) and GEO (being cited in AI answers: crawler access, topical authority, evidence, authorship, entities). Optional live URL check and brand web search. Writes one timestamped report with a score per lens to docs/seo-audit/.
Build, update or validate visible FAQ sections and, if you want it, their FAQPage or QAPage JSON-LD. Drafts questions and answers from a page's own content, the latest question map or answers you supply, renders the FAQ and any markup from one data source, and checks existing markup against the visible text. Supports --dry-run.
Apply fixes from the newest /seo-audit report, for whichever lenses it covers. SEO: removes deprecated tags and adds missing meta. AEO: answer-first rewrites, real lists and tables, answers kept in the HTML, snippet-control changes after you confirm intent. GEO: robots.txt rules for each AI bot group after asking, Organization and Person JSON-LD with sameAs links you supply, dateModified, sources and topic hubs. Shows a diff for each change and supports --dry-run.
Generate, update and validate llms.txt and llms-full.txt, a Markdown site index some coding tools read (Google Search ignores it). Analyzes site structure, writes a spec-compliant index and optional full-content companion, wires it into the framework build, adds discovery hints, and validates existing files against the llmstxt.org spec. Supports --dry-run.
Build a question map for Answer Engine Optimization: the questions a site should answer, the page that answers each one, and the gaps. Starts from the questions the site already asks, adds your target questions, question-shaped queries from a Search Console or Bing Webmaster Tools export, web-search suggestions or an earlier map, then flags missing answers, buried answers and pages that compete for the same question. Writes the map to docs/seo-audit/.
Generate and validate JSON-LD structured data (Schema.org) for pages and routes: Article, Product, Organization and Person with sameAs links you supply, LocalBusiness, FAQPage and QAPage for visible Q&A, BreadcrumbList and more. Detects the content type, writes framework-idiomatic injection code, and checks existing JSON-LD against Schema.org and Google's structured data policies.