Die CLI snitch

Jeder Befehl kennt --json; snitch <befehl> --help zeigt alle Optionen.

Installieren

snitch kommt über Homebrew und nicht über die App: Die App aktualisiert sich selbst, die CLI über brew upgrade – der Weg, den man auf einem Build-Server erwartet.

brew install tobias-keller/sitesnitch/snitch

Ausgeliefert wird ein signiertes, notarisiertes Universal-Binary für Apple Silicon und Intel, macOS 14 oder neuer. Es braucht die App nicht – snitch läuft für sich allein, etwa in einer CI ohne Bildschirm. Die Lizenz teilt es sich mit der App: ohne Lizenz 300 URLs je Crawl, sonst nichts.

BefehlWofür
snitch crawl <url>Website crawlen und als .snitch speichern
snitch list <datei>URL-Liste abarbeiten, ohne Links zu folgen
snitch report <snapshot>Benannte Reports schreiben (--list zeigt den Katalog)
snitch diff <alt> <neu>Zwei Snapshots vergleichen, Redirect-Map erzeugen
snitch verify <alt> --map <csv>Nach dem Go-Live prüfen
snitch sitemap <snapshot>XML-Sitemap erzeugen
snitch info <snapshot>Kennzahlen eines Snapshots, ohne erneut zu crawlen
snitch trend <a> <b> …Kennzahlen über die Zeit
snitch graph <snapshot>Interne Verlinkung als GraphML/DOT
snitch integrations <status|fetch>Search-Console- und GA4-Daten anhängen
snitch llm <snapshot>Benannte LLM-Prompts über die Seiten laufen lassen
snitch semantic <snapshot>Seiten nach inhaltlicher Ähnlichkeit durchsuchen
snitch mcpMCP-Server für KI-Assistenten

Der Relaunch-Ablauf auf der Kommandozeile

snitch crawl https://www.example.de/ --out alt.snitch
snitch crawl https://staging.example.de/ --out neu.snitch
snitch diff alt.snitch neu.snitch --host-map staging.example.de=www.example.de --out ./map
snitch verify alt.snitch --map ./map/redirects.csv

Exit-Codes als Schranke

0 = ok, 1 = Bedienfehler, 2 = Befunde oberhalb einer Schwelle. Damit lässt sich ein Go-Live in einer Pipeline abbrechen.

Die App automatisieren

tell application "SiteSnitch"
    set r to crawl "https://www.example.de/" with maximum 50000
    export "/Users/ich/Berichte/example"
end tell

LLM-Prompts & semantische Suche

snitch llm läuft benannte LLM-Prompts über die Seiten eines Snapshots – Anbieter OpenAI, Gemini, Anthropic oder Ollama. Der Prompt verwendet {{content}} als Platzhalter für den Seitentext (Titel, h1, Meta-Description).

snitch semantic vektorisiert Anfrage und Seiten und liefert die ähnlichsten nach Kosinus-Ähnlichkeit – lokal über Ollama oder über OpenAI. Damit findest du inhaltlich umgeschriebene Seiten, die der SimHash-Fingerprint nicht trifft.

Geplante Crawls

Crawls lassen sich zeitlich planen und melden ihr Ergebnis per Benachrichtigung; auf Wunsch startet ein launchd-Agent die App zu den Terminen.

Der MCP-Server

Mit snitch mcp wird SiteSnitch zu einem Werkzeug für KI-Assistenten: Der Server spricht das Model Context Protocol über stdin/stdout und stellt fünf Werkzeuge bereit. Jedes bildet einen CLI-Unterbefehl ab und antwortet als JSON – strukturiert, damit der Assistent die Ausgabe weiterverarbeiten kann.

WerkzeugUnterbefehlArgumenteWofür
crawl_sitecrawlurl, output, max_urls, edges, assetsWebsite crawlen und als .snitch-Snapshot ablegen; kann je nach Umfang lange dauern.
write_reportsreportsnapshot, outputBenannte Reports (Redirect-Ketten, verwaiste Seiten, Bilder ohne Alt-Text, …) schreiben.
compare_snapshotsdiffbefore, after, outputZwei Snapshots vergleichen und die Redirect-Map erzeugen – das Kernstück.
generate_sitemapsitemapsnapshot, outputXML-Sitemap aus einem Snapshot erzeugen.
snapshot_infoinfosnapshotKennzahlen eines Snapshots ohne erneuten Crawl.
edges setzen, wenn danach Reports kommen sollen

Ohne edges: true schreibt der Crawl keine Kantenliste – und dann bleiben die Reports Images Without Alt Text, Internal Link Score, Anchor Texts und Inlinks to Errors leer. Nicht weil nichts gefunden wurde, sondern weil nichts gesucht wurde; einem Assistenten sieht man den Unterschied nicht an. assets: true nimmt zusätzlich Bilder, Skripte und Stylesheets mit. Beide sind aus, solange sie niemand setzt – die Kantenliste kostet bei einer Million Seiten rund 700 MB.

Der Server wird nicht von Hand gestartet, sondern von einem Client. Am Beispiel von Claude Code:

claude mcp add --transport stdio sitesnitch -- /pfad/zu/snitch mcp

Der Doppelstrich -- trennt Claude Codes eigene Optionen von dem Befehl, der den Server startet – alles dahinter wird unverändert durchgereicht. Für ein Team lässt sich derselbe Server in einer .mcp.json im Projekt ablegen und mit einchecken:

{
  "mcpServers": {
    "sitesnitch": {
      "type": "stdio",
      "command": "/pfad/zu/snitch",
      "args": ["mcp"]
    }
  }
}

Ob die Verbindung steht, zeigt claude mcp list. Der mcpServers-Block mit command/args ist kein Claude-Dialekt – er funktioniert ebenso in Claude Desktop, Cursor und anderen Clients.

So sieht die Benutzung aus

Im Gespräch stehen die fünf Werkzeuge als normale Werkzeuge zur Verfügung. Ein Relaunch-Ablauf läuft etwa so ab:

„Crawle https://www.example.de/ und speichere den Snapshot nach /tmp/alt.snitch. Schreibe danach alle Reports nach /tmp/berichte und fasse die drei wichtigsten Befunde zusammen.“

Das wird zu einem crawl_site- und danach zu einem write_reports-Aufruf. Der eigentliche Zweck ist der Vergleich zweier Stände: „Vergleiche /tmp/alt.snitch mit /tmp/neu.snitch und lege die Redirect-Map nach /tmp/map.“

Zwei Dinge für den ersten Einsatz

crawl_site ist der lange Aufruf – Claude Code stuft lange Werkzeugaufrufe in den Hintergrund und meldet sich, wenn sie fertig sind. Ein gescheiterter Befehl kommt als Werkzeugantwort mit Fehlermeldung zurück, nicht als Verbindungsfehler; läuft der Server gar nicht, ist das am Status in claude mcp list zu sehen.