301→302301→302
A temporary redirect where a permanent one belongs.
Found by Redirect checker →
A temporary redirect where a permanent one belongs.
Found by Redirect checker →
redirect loopredirect loop
The URL redirects back to itself and never settles.
Found by Redirect checker →
The URL redirects back to itself and never settles.
Found by Redirect checker →
Interfaces
MCP server for SEO with AI agents
A local stdio MCP server exposes the same tools to Claude Code, Claude Desktop, Codex, Cursor and other MCP clients. Registration is shown before any file is changed.
How it works
Three steps, one saved scan
Preview the registration
Run the install with --dry-run first. It prints the exact config block, the file it would change, a backup path and a sha256, and writes nothing.
Install with --yes
Once you have read the plan, add --yes. The previous config is backed up next to it, and --expected-sha256 refuses the install if the file changed after the preview.
Agents continue the saved project
Projects keep scope, crawl policy, scans and history. The next agent picks up the saved project instead of starting from the chat.
What it checks
Checks in this feature
| Check | What it means | Severity | Evidence |
|---|---|---|---|
REDIRECT_LOOP | A redirect chain returns to a URL it already visited, so it never settles | Critical | Loop path from the redirect chain (SF Redirect Chains export, or hop records from a native crawl) |
BROKEN_INTERNAL_LINK | An internal link points to a URL that returns 4xx | Critical | Client Error (4xx) inlinks: source page and link position |
REDIRECT_CHAIN | More than one hop before the final URL | Important | Every hop with its status code and location |
INTERNAL_LINK_TO_REDIRECT | An internal link points to a 3xx URL instead of the final page | Important | Redirection (3xx) inlinks: source page and DOM position |
BAD_REDIRECT_TYPE | A 302, 303 or 307 is used where a permanent move is meant | Tip | Status code per hop |
How to run it
One command
bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcpInstall first: installation guide. Every command also runs as an MCP tool for AI agents.
FAQ

