# SEOLint
> SEO agent for Claude. Connects via MCP in 2 minutes. Scans any site, remembers every issue, understands your content structure, and tells Claude exactly what to fix or create next.

## What it does
SEOLint is an MCP server and REST API that gives Claude a persistent SEO memory for your sites. On first scan it builds a base understanding of the site — goal, audience, sitemap structure, and what pages are missing. Every scan after that deepens the picture: issues tracked as NEW, PERSISTING, or REGRESSED, recurring problems flagged, and content gaps surfaced with ready-to-use page creation briefs.

## Who it's for
Solo founders and developers who use Claude Code or Claude Desktop daily. Not a dashboard — SEO infrastructure that lives inside your AI workflow.

## Core tools (8 MCP tools)
- `scan_website(url)` — scan any page, get structured issues with broken HTML + fix prompt
- `get_site_intelligence(domain)` — full picture: goal, ICP, sitemap, cross-page patterns
- `get_page_suggestions(domain)` — missing pages from sitemap analysis, with copy-paste creation briefs
- `get_open_issues(domain)` — all unresolved issues across every scanned page
- `get_site_status(url)` — trend and rescan recommendation
- `list_my_sites()` — all tracked domains with health summary
- `get_site_history(url)` — full scan history with NEW/FIXED/PERSISTING diffs
- `mark_issues_fixed(scanId, issueIds[])` — mark resolved, track for recurrence

## Recommended Claude workflow
1. `get_site_intelligence("example.com")` — start here every session
2. `get_page_suggestions("example.com")` — what pages are missing, with briefs to create them
3. `get_open_issues("example.com")` — what still needs fixing
4. `scan_website("https://example.com/page")` — scan a specific page
5. Fix issues using the `fix` field (LLM-ready) and `element` field (actual broken HTML)
6. `mark_issues_fixed(scanId, ["issue-id"])` — mark resolved

## MCP setup (Claude Code)
```bash
claude mcp add seolint --env SEOLINT_API_KEY=sl_your_key -- npx -y seolint-mcp
```

## MCP setup (Claude Desktop)
Add to claude_desktop_config.json:
```json
{ "mcpServers": { "seolint": { "command": "npx", "args": ["-y", "seolint-mcp"], "env": { "SEOLINT_API_KEY": "sl_your_key" } } } }
```

## REST API base URL
https://www.seolint.dev/api/v1
Auth: Authorization: Bearer sl_your_key

## Pricing
- Pro: $19/month — 50 scans, MCP server, CLI, AI fix instructions
- Team: $49/month — 250 scans, REST API, GitHub Actions

## Agent Skills (coming soon)
SKILL.md package for Claude Code, Cursor, Codex, Windsurf, Copilot, Gemini.
https://seolint.dev/agent-skills

## Full reference
https://seolint.dev/skills.md