seo-geo-audit: A Dependency-Free SEO and GEO Audit Toolkit

Overview

seo-geo-audit is a lightweight toolkit designed to help website owners check their sites for both traditional search engine optimization and Generative Engine Optimization. GEO ensures that websites are readable by AI answer engines like ChatGPT, Claude, and Google AI Overviews. Unlike standard SEO tools that often look at how a site appears after JavaScript runs, this toolkit focuses on the raw HTML that AI crawlers actually see. This helps users find gaps where important information might be hidden from AI systems. The project includes four simple command-line tools that run with a single command and create easy-to-read reports without needing a paid subscription.

Benefits

The main advantage of seo-geo-audit is its ability to spot issues that other tools miss. Many SEO tools render JavaScript, which means they see what a human user sees after a page loads. AI crawlers, however, usually do not run JavaScript. This toolkit detects visibility gaps where data is injected by JavaScript and is therefore invisible to AI. It also checks for client-side JSON-LD, which is structured data that often appears after hydration in modern frameworks like React or Next.js. Another key benefit is its simplicity. The tools are built with plain Node.js and have zero dependencies, making them easy to read, edit, and integrate into automated workflows. Users get detailed reports in Markdown format that are similar to professional tools but without the cost of a subscription.

Use Cases

This toolkit is ideal for developers and SEO specialists who want to optimize their websites for both traditional search engines and AI. It can be used to crawl a website's sitemap and internal links to check for broken links, missing alt text on images, and issues with metadata like titles and descriptions. The tools can also verify that social media cards and localization settings are correct. For performance, one of the tools uses Playwright to measure core web vitals like loading speed and layout stability. It compares the static HTML view with the rendered view to highlight differences. Another tool connects to Google Search Console to find queries that are ranking well but could perform better with small tweaks to titles or content. A final tool analyzes on-site analytics data to understand user behavior after they click through to the site. The entire kit is perfect for solo operators or teams who want a free, flexible solution for auditing their digital presence.

Pricing

seo-geo-audit is completely free to use. It is an open-source project hosted on GitHub, and there are no subscription fees or hidden costs. Users can clone the repository and run the tools on their own servers or local machines without paying anything. While some features like backlink data require an API key from a service like Ahrefs, the core auditing and reporting functions are available at no cost.

Vibes

The project has received positive attention from the developer community for its focus on the emerging field of Generative Engine Optimization. By addressing the specific needs of AI crawlers, it fills a gap that many traditional SEO tools do not cover. Users appreciate the clear, actionable reports that help them improve their site's visibility in AI-generated answers. The dependency-free nature of the toolkit makes it a favorite among developers who prefer simple, maintainable code over complex, bloated software.

Additional Information

The seo-geo-audit project is maintained by lireking and is available on GitHub. It is built using plain Node.js version 18 or higher. The codebase is small, with around 1,500 lines of code, which makes it easy to understand and modify. The project is designed to be static-HTML first, prioritizing the raw server HTML because that is what AI crawlers actually see. It does not require any build steps, which keeps the setup process simple and fast. The toolkit is also designed to work well in CI/CD pipelines, allowing teams to automate their auditing processes.