pseolint

What is pseolint?

pseolint is an MCP server that audits programmatic SEO sites by template rather than by URL. It detects graph-level issues such as doorway clusters, near-duplicates, and entity-swap patterns across thousands of pages, providing per-template verdicts and variance metrics. Designed for developers and SEO professionals, it integrates with Claude and coding agents via its skills suite.

How to use pseolint?

Run npx pseolint http://localhost:3000 to audit a site. Add skills for Claude with npx skills add ouranos-labs/pseolint --skill pseolint aeo. The MCP server provides rule knowledge as resources and supports parameters like authorityScore and --render for advanced checks.

Key features of pseolint

• Graph-level analysis detects issues invisible to per‑page tools.
• Per‑template verdict aggregation with uniformity score.
• 48+ rules across 8 categories including SpamBrain and AI Overview.
• Render‑aware crawl checks for CSR bailout and soft 404s.
• Bring‑your‑own authority score to adjust verdict tiers.
• MCP resources for rule knowledge and skills for coding agents.

Use cases of pseolint

• Audit a large programmatic SEO directory before publishing.
• Gate site quality in CI/CD pipelines using --ci-threshold.
• Fix a broken template to fix hundreds of pages at once.
• Optimize pages to be cited in AI Overviews, ChatGPT, or Perplexity.
• Compare competitive SERP positions with the browser extension.

FAQ from pseolint

How is pseolint different from Screaming Frog or Ahrefs Site Audit?

pseolint works at the graph level, not per page. It detects doorway patterns, near‑duplicate template clusters, and entity‑swap doorways that cross thousands of URLs—issues invisible to editorially‑focused tools.

What runtime does pseolint require?

pseolint is a Node.js package. The CLI requires Node 18+; the MCP server and render‑aware checks (--render) need Playwright installed. It is distributed via npm.

Does pseolint measure domain authority or backlinks?

No. pseolint is authority‑blind by design. It does not fetch Moz, Ahrefs, or Semrush data. You can pass a manual authorityScore (0‑100) via CLI flag or MCP param to adjust verdict leniency.

What blind spots does pseolint currently have?

It does not detect Core Web Vitals, image SEO, Open Graph completeness, title‑tag uniqueness, H1 structure, schema‑content drift, outbound link health, search intent, or parameter crawl‑budget waste. The full list is documented at pseolint.dev/blind‑spots.

How does pseolint handle large sites efficiently?

It uses a two‑phase pipeline: first clusters the sitemap into templates (cheap fetches), then deeply audits K sampled pages per template. Typical budget is ~80 fetches on a 100k‑URL site, covering every template.