301→302301→302
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 →
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.

MCP server for SEO with AI agents

Profiles

--profile full exposes every tool; audit, infra, quick-check and router expose smaller sets for focused sessions.

MCP server for SEO with AI agents

Agents with memory

Projects keep scope, crawl policy, scans and history, so the next agent continues from the saved project instead of the chat.

How it works

Three steps, one saved scan

  1. 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.

  2. 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.

  3. 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

CheckWhat it meansSeverityEvidence
REDIRECT_LOOPA redirect chain returns to a URL it already visited, so it never settlesCriticalLoop path from the redirect chain (SF Redirect Chains export, or hop records from a native crawl)
BROKEN_INTERNAL_LINKAn internal link points to a URL that returns 4xxCriticalClient Error (4xx) inlinks: source page and link position
REDIRECT_CHAINMore than one hop before the final URLImportantEvery hop with its status code and location
INTERNAL_LINK_TO_REDIRECTAn internal link points to a 3xx URL instead of the final pageImportantRedirection (3xx) inlinks: source page and DOM position
BAD_REDIRECT_TYPEA 302, 303 or 307 is used where a permanent move is meantTipStatus code per hop
How to run it

One command

bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcp

Install first: installation guide. Every command also runs as an MCP tool for AI agents.

FAQ

Questions

MCP server for SEO with AI agents
Not in preview. --dry-run writes nothing and shows the file it would change (for Claude Code, ~/.claude.json), a backup path and a sha256. The change happens only with --yes.
Claude Code, Claude Desktop, Codex and Cursor, selected with --client. Any other MCP client can use the same stdio server command.
The full profile exposes 183 tools. The audit and quick-check profiles expose 8 each, and infra exposes 10. Pick a smaller profile for a focused session.
No. It is a local stdio process. Network requests go out only for the checks you trigger, such as a URL or a crawl. A crawl writes its scan under ./scans/ by default.

Check your redirects locally