# pseolint

pseolint audits programmatic SEO sites by template, returning a verdict, risk score, and proposed fixes. Use it on a URL or a local directory.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: ouranos-labs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ouranos-labs/pseolint/tree/HEAD/packages/mcp
- Updated: 2026-09-22
- HTML: https://affpapa.org/en/nevibecode/mcp/pseolint

## What it does

pseolint gives AI coding clients a template-aware audit for programmatic SEO sites. It can inspect a URL or directory and report an overall verdict, risk score, categories, template-level results, and findings for individual pages. Template results include variance data and the rule driving the most failures.

The server exposes namespaced tools such as `pseolint_audit_site` and `pseolint_orchestrate_audit`. The orchestration tool runs 25 deterministic audit tools and builds a fix manifest with patches for copy, JSON-LD, and `robots.txt`. Results are available as a short summary or as JSON with validation and diffs.

SSRF checks, `robots.txt` handling, fetch limits, and crawl limits are enabled by default. The content-quality signal requires `ANTHROPIC_API_KEY`; without that key, `contentEffort` does not activate. That requirement matters when you want the audit to judge originality and effort from sampled page text.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ANTHROPIC_API_KEY`, `PSEOLINT_MCP_SAMPLE_CAP` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env PSEOLINT_MCP_SAMPLE_CAP=<PSEOLINT_MCP_SAMPLE_CAP> --transport stdio mcp -- npx -y @pseolint/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env PSEOLINT_MCP_SAMPLE_CAP=<PSEOLINT_MCP_SAMPLE_CAP> -- npx -y @pseolint/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@pseolint/mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "PSEOLINT_MCP_SAMPLE_CAP": "<PSEOLINT_MCP_SAMPLE_CAP>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pseolint/mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "PSEOLINT_MCP_SAMPLE_CAP": "<PSEOLINT_MCP_SAMPLE_CAP>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e PSEOLINT_MCP_SAMPLE_CAP=<PSEOLINT_MCP_SAMPLE_CAP> mcp npx -y @pseolint/mcp
```
Replace <…> with your own values

## When to use it
- audit a programmatic SEO site by URL template
- spot pages with elevated spam risk
- compare risk across page templates
- generate copy and JSON-LD patches
- explain what drives the risk score

## Example prompts
- Audit `https://example.com` with `pseolint_audit_site` and show the results grouped by template.
- Run `pseolint_orchestrate_audit` on `https://example.com` and return a concise report with concrete fixes.
- Use `pseolint_explain_score` to explain the issues behind the site's risk score.

## Similar
- [New-Term Radar](https://affpapa.org/en/nevibecode/mcp/new-term-radar.md) — MCP server · ★ 1823
- [NotFair](https://affpapa.org/en/nevibecode/mcp/notfair.md) — MCP server · ★ 4064
- [seo-monster](https://affpapa.org/en/nevibecode/mcp/seo-monster.md) — MCP server · ★ 555
- [Google Maps MCP Server](https://affpapa.org/en/nevibecode/mcp/google-maps-mcp-server.md) — MCP server · ★ 484
- [Search Console MCP](https://affpapa.org/en/nevibecode/mcp/search-console-mcp.md) — MCP server · ★ 310
- [squirrelscan](https://affpapa.org/en/nevibecode/mcp/squirrelscan.md) — MCP server · ★ 298

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md