SEOmator SEO Audit
A CLI and agent skill for website SEO audits: technical SEO, Core Web Vitals, structured data, security and AI search readiness
Install
npm install -g @seomator/seo-auditWithout a system Chrome, run npx playwright install chromium for Core Web Vitals.
This is third-party code. Review the repository files before installing.
What it does
SEOmator checks a page or a whole site against rules grouped into categories: indexing, links and redirects, images, security headers, structured data, accessibility, content and mobile. Core Web Vitals and raw versus rendered DOM comparison use Chrome via Playwright. Reports go to console, JSON, HTML, Markdown or compact LLM-oriented XML, and every rule comes with a fix suggestion. Audits are stored in local SQLite and can be compared before and after a deploy. The seo-audit skill teaches the agent to run the tool and interpret the report.
Who it is for. For SEO specialists, marketers and developers who want to audit a site from the terminal, CI or straight from an agent.
Good fit when
- You need to find technical SEO issues and prioritize fixes
- You need to see whether a deploy made SEO worse
- You want an SEO gate in CI with exit codes
Not a fit when
- You need rankings, traffic or keyword data from search engines
- You need competitor or backlink analysis
Example request
Run an SEO audit on https://example.com with a 20-page crawl and tell me what to fix firstLimitations
Requires Node.js 20.3+, and Core Web Vitals and JavaScript rendering need Chrome or Chromium. The tool inspects page code and responses and has no search engine data. Checks it cannot measure are reported as not measured.
How to disable. Run npm uninstall -g @seomator/seo-audit and remove the seo-audit folder from the agent's skills directory. Audit history lives in ~/.seomator.
Security check
- Launches a browser and crawls the target site
- Stores audit history on disk
README in short
The README covers three forms of one tool: an npm CLI, an Electron desktop app and a Claude Code skill. It details the audit, crawl, analyze, report, compare and serve commands, seomator.toml configuration with presets and the output formats. It includes GitHub Actions and GitLab CI examples and programmatic usage. MIT licensed.
SKILL.md
--- name: seo-audit description: Audit websites for SEO, technical, content, security, JS rendering, and AI readiness using SEOmator CLI. Returns LLM-optimized reports with health scores across 332 rules and 20 categories, and can diff two audits to show what a deploy changed. Use when analyzing websites, debugging SEO issues, checking site health, or comparing a site before and after a change. license: MIT compatibility: Requires Node.js 20.3+ and npm. Chrome/Chromium optional for Core Web Vitals and JS rendering. metadata: author: seomator version: "5.0.0" allowed-tools: Bash(seomator:*) --- # SEO Audit Skill Audit websites for SEO, technical, content, performance, security, JavaScript rendering, and AI readiness using the SEOmator CLI. SEOmator provides comprehensive website auditing by analyzing website structure and content against **332 rules** across **20 categories**. It provides a list of issues with severity levels, affected URLs, and actionable fix suggestions. ## Links * SEOmator npm package: [npmjs.com/package/@seomator/seo-audit](https://www.npmjs.com/package/@seomator/seo-audit) * GitHub repository: [github.com/seo-skills/seo-audit-skill](https://github.com/seo-skills/seo-audit-skill) * Web UI: [seomator.com/free-seo-audit-tool](https://seomator.com/free-seo-audit-tool) ## What This Skill Does This skill enables AI agents to audit websites for **332 rules** in **20 categories**, including: - **Core SEO** (24 rules): Canonical URLs, indexing directives, title uniqueness, canonical conflicts/loops - **Performance** (26 rules): LCP, CLS, FCP, TTFB, INP, compression, caching, minification, HTTP/2 - **Links** (24 rules): Broken links, redirect chains, anchor text, localhost/fragment links, plus click depth and inbound internal links from the site graph (`--crawl`)
FAQ
How is this different from Lighthouse?
Lighthouse mostly covers performance of a single page. SEOmator adds indexing, redirects, hreflang, structured data and cross-page checks.
Does it send data to a server?
Audits are stored locally in ~/.seomator/audits.db. The local seomator serve dashboard binds to loopback and makes no outbound requests itself.
Related
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents
A Claude Code skill set for auditing sites for AI search: citability, AI crawler access, llms.txt, schema and reports
The experimental official Google Analytics 4 MCP server: reports, funnels and realtime data on request
Google Search Console MCP
Google Search Console MCP Server for SEOs
An MCP server for Google Search Console: queries and pages with clicks and positions, URL indexing checks, sitemaps and ready SEO skills