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/snitchAusgeliefert 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.
| Befehl | Wofü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 mcp | MCP-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.csvExit-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 tellLLM-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.
| Werkzeug | Unterbefehl | Argumente | Wofür |
|---|---|---|---|
crawl_site | crawl | url, output, max_urls, edges, assets | Website crawlen und als .snitch-Snapshot ablegen; kann je nach Umfang lange dauern. |
write_reports | report | snapshot, output | Benannte Reports (Redirect-Ketten, verwaiste Seiten, Bilder ohne Alt-Text, …) schreiben. |
compare_snapshots | diff | before, after, output | Zwei Snapshots vergleichen und die Redirect-Map erzeugen – das Kernstück. |
generate_sitemap | sitemap | snapshot, output | XML-Sitemap aus einem Snapshot erzeugen. |
snapshot_info | info | snapshot | Kennzahlen eines Snapshots ohne erneuten Crawl. |
edges setzen, wenn danach Reports kommen sollenOhne 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 mcpDer 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.“
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.