screaming-frog-mcp

MCP-Server, mit dem Claude Screaming Frog SEO Spider Headless-Crawls ausführen, Daten exportieren und Crawl-Speicher verwalten kann – ohne dass jemand die GUI öffnen muss.

Geben Sie eine URL in Claude ein. Screaming Frog läuft im Hintergrund. Sie erhalten die Daten zurück. Das ist alles.

Geforkt von bzsasson/screaming-frog-mcp v0.1.0 mit Fehlerbehebungen. Das Original hatte Probleme, die es in der Praxis unbrauchbar machten – Pipe-Deadlocks, die Crawls zum Absturz brachten, falsche GUI-Erkennung, die alles nach dem ersten Durchlauf blockierte, ein Löschbefehl, der die gesamte Crawl-Datenbank löschen konnte. Alles behoben.

Was wurde behoben

Anforderungen

• Screaming Frog SEO Spider mit einer kostenpflichtigen Lizenz – Headless-Crawls erfordern eine Lizenz

• Python 3.10+

• uv (empfohlen) oder pip

Installation

Mac

uvx --from git+https://github.com/marykovziridze/screaming-frog-mcp screaming-frog-mcp

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"]
    }
  }
}

Windows

Installieren Sie zuerst uv:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Fügen Sie dies zu C:\Users\[name]\AppData\Roaming\Claude\claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"],
      "env": {
        "SF_CLI_PATH": "C:\\Program Files (x86)\\Screaming Frog SEO Spider\\ScreamingFrogSEOSpiderCli.exe"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Bearbeiten der Konfiguration neu.

Tools

Konfiguration

Bekannte Einschränkungen

• Windows veralteter Crawl-Pfad – automatische Bereinigung funktioniert auf dem Mac. Wenn Crawls unter Windows nach einer Unterbrechung fehlschlagen, suchen Sie nach einer crawl.seospider-Datei in Ihrem SF-Installationsverzeichnis und löschen Sie diese manuell.

• Kein Crawl-Fortschritt in Prozent – die Headless-CLI von SF meldet keinen Fortschritt während des Crawls. Sie wissen, wann er beginnt und wann er endet.

• Große Websites – getestet auf Websites mit bis zu ca. 160 Seiten. Nicht auf Websites mit mehr als 10.000 Seiten unter Stress getestet.

Lizenz

MIT – siehe LICENSE

Credits

Ursprünglicher MCP-Server von Boaz Sasson.