API und KI-Assistenten

Wofür das gut ist

Eine App, die mit offenem Schlüssel live geht, ist ab der ersten Minute angreifbar. Deshalb lässt sich derselbe Check auch ohne Browser starten: aus eigenem Code, vor jeder Veröffentlichung in einer automatischen Pipeline oder über einen KI-Assistenten, der zum Ergebnis gleich die Änderung vorschlägt. Geprüft wird dasselbe wie auf der Website. Jeder Befund trägt eine feste Kennung wie header.csp.missing, auf die Programme reagieren können. Eine Pipeline kann zum Beispiel stoppen, sobald ein Befund mit code.secret auftaucht.

Hier steht die Kurzfassung. Alles Weitere für Entwickler finden Sie in der Entwickler-Doku.

KI-Assistenten

KI-Assistenten wie Claude, ChatGPT oder Cursor können Werkzeuge über einen offenen Standard anbinden. Er heißt Model Context Protocol, kurz MCP. Sie tragen einmal die Adresse von Hullwise in Ihrem Assistenten ein. Danach schreiben Sie zum Beispiel:

Prüfe ihre-firma.de mit Hullwise und sag mir, welche Header ich in vercel.json ergänzen muss.

Der Assistent startet den Check, liest das Ergebnis und erklärt es Ihnen. Dafür bietet Hullwise zwei Werkzeuge. scan_website prüft eine Seite, list_checks zählt auf, was ein Check ansieht und was er nie tut. Beide lesen nur und ändern nichts. Ein Konto brauchen Sie dafür nicht. Mit einem API-Schlüssel gilt Ihr höheres Limit. Wie Sie Hullwise in Ihrem Assistenten eintragen, steht Schritt für Schritt in MCP-Server.

REST-API

Für eigene Programme gibt es eine Schnittstelle über HTTP. Dafür brauchen Sie einen API-Schlüssel aus Ihrem Konto. Wir speichern nur einen Fingerabdruck des Schlüssels, nicht ihn selbst. Verlieren Sie ihn, können wir ihn Ihnen nicht noch einmal zeigen. Legen Sie ihn deshalb in den geschützten Einstellungen Ihrer Pipeline ab, nie im Code.

curl "https://hullwise.co/api/v1/scan?url=ihre-firma.de" \
  -H "Authorization: Bearer sc_live_…"

Die Antwort enthält Note, Punktzahl und alle Befunde. Alle Felder erklärt die Entwickler-Doku.

Limits

Die REST-API braucht immer einen Schlüssel, also mindestens ein kostenloses Konto. Ist Ihr Limit erreicht, warten Sie bis zur nächsten Stunde.

Noch Fragen? Schreiben Sie uns.