SEOmator SEO Audit
332-rule SEO audit as a CLI, desktop app, and Claude Code skill, tuned by a seomator.toml.
SEOmator's open-source auditor scans a page or crawls a site against 332 rules in 20 categories (technical SEO, Core Web Vitals with Playwright, structured data, security headers, AI and GEO readiness) and emits console, JSON, HTML, Markdown, or LLM-optimized XML. It installs from npm as a CLI, runs as an Electron dashboard, and registers as a Claude Code skill. Project settings live in seomator.toml.
Alternative to Screaming Frog, Semrush
- I want my agent to audit a site and hand me a prioritized fix list before I publish
- I want an SEO check in CI that fails the build when a page regresses
- Core Web Vitals need a system Chrome, Chromium, or Edge; use --no-cwv on headless boxes without one
- Desktop app needs electron-rebuild for the native SQLite module
- Vertical fit is SEO tooling rather than publishing; it audits pages, it does not publish them
Last activity Sep 2, 2026. Fit: adaptable 3, operable 3.
Editions
Free · Free open source
- Clone
git clone https://github.com/seo-skills/seo-audit-skill - Install
npm install -g @seomator/seo-audit
SEOmator hosted · Free closed source
- HostedOpen the hosted app
Adaptable: what is yours to change
Make it yours
Config only4 things to edit
Run seomator init to write seomator.toml: [project] domains, [crawler] max_pages, concurrency, include and exclude globs, query-param stripping, [rules] enable and disable lists with wildcards, [output] format. Configs cascade from CLI flags to ./seomator.toml to parent directories to ~/.seomator/config.toml. Adding your own rules means editing src/, for which there is no owner guide.
- Env vars
- none
- Config files
seomator.toml~/.seomator/config.tomlSKILL.md- Prompt files
SKILL.md- Accounts you need
- none
Source
- github.com/seo-skills/seo-audit-skill
- MIT license
- Last commit Sep 2, 2026
- 413 stars
Operable: what an agent can drive
Interface
NativeCLIpublished by the builderlocal
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
Reach
Partial coverage. 8 of 10 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Audit a single URL against all rules | Reachable | seomator audit <url> |
| Crawl and audit many pages | Reachable | --crawl --max-pages with concurrency; cross-page checks |
| Measure Core Web Vitals | Reachable | LCP, CLS, FCP, TTFB, INP with Playwright; needs a local Chrome |
| Compare raw vs rendered DOM | Reachable | JavaScript rendering analysis feature |
| Emit machine-readable reports | Reachable | --format json, html, markdown, llm |
| Gate CI on SEO regressions | Reachable | exit codes plus GitHub Actions and GitLab CI examples |
| Restrict or extend the rule set | Reachable | [rules] enable and disable with wildcards in seomator.toml; -c categories flag |
| Run from inside Claude Code | Reachable | npx skills add seo-skills/seo-audit-skill; SKILL.md at repo root |
| Track score history over time | Not reachable | score history and trend charts are desktop-app only |
| Use the hosted SEOmator web audit | Not reachable | separate browser product at seomator.com |
Code stack
- Languages
- TypeScript
- Frameworks
- Node.jsPlaywrightElectronbetter-sqlite3
- Package manager
- npm
- Database
- SQLite (crawl store)
- Hosting target
- local machineCI runners
- Built
- Unknown (recorded, never ranked)
Skills
CLI and desktop app are the product; the skill wraps the CLI for coding agents.
- Kind
- bundled
- Paths
SKILL.mdskill/SKILL.md
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | README: ships as a command-line tool, an Electron desktop app, and a Claude Code skill | 95% |
| executionModel | rule engine with no model calls; the llm format is output for a model, not a call to one | 90% |
| operability | CLI built for agents (llm output format, exit codes) and a SKILL.md, both from the Builder's repo | 90% |
| effort | README Configuration section documents seomator.toml and the config cascade | 90% |
| editions | README: MIT, npm package; seomator.com hosted audit tool linked from README | 70% |
| active | pushedAt 2026-09-02; 1 open issue | – |
| provenance | AGENTS.md and claude.md in repo; no authorship statement | 40% |
| reach | 90% |
Open questions
- SEOmator hosted pricing
- Should the Curator route this to an SEO or marketing vertical?
Sources
- github.com/seo-skills/seo-audit-skill sourcing:content-publishing:github
- www.npmjs.com/package/@seomator/seo-audit analysis:content-publishing