Clarity in deinen KIs und Agenten

Werkzeuge und Preise

Live-Preise, abgezogen vom Prepaid-Guthaben (1 Credit = 1 €).

Derzeit verfügbare Modelle: ChatGPT (chatgpt), Google Gemini (gemini)

Schnellstart

Zwei Beispielaufrufe. Ersetze clr_YOUR_API_KEY durch deinen Schlüssel.

curl -X POST https://clarity.whooho.it/api/v1/visibility \
  -H "Authorization: Bearer clr_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": "Acme Bikes",
    "question": "What are the best e-bike shops in Milan?",
    "models": ["chatgpt", "perplexity"],
    "competitors": ["BikeLand", "Velo Milano"],
    "brand_domain": "acmebikes.it"
  }'

curl -X POST https://clarity.whooho.it/api/v1/geo-audit \
  -H "Authorization: Bearer clr_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "acmebikes.it" }'

{
  "request_id": "req_9f2c…",
  "tool": "visibility_check",
  "charged_cents": 70,
  "refunded_cents": 0,
  "balance_cents": 1930,
  "result": {
    "summary": { "models_asked": 2, "models_answered": 2, "mentioned_in": 1, "visibility_percent": 50 },
    "models": [{
      "model": "chatgpt",
      "brand": { "mentioned": true, "mention_count": 2, "list_rank": 3, "excerpt": "…Acme Bikes in Navigli offers…" },
      "competitors": [{ "name": "BikeLand", "mentioned": true, "list_rank": 1 }],
      "brand_domain_cited": true,
      "sources": [{ "url": "https://…", "title": "…", "domain": "…" }],
      "answer": "…"
    }]
  }
}

Konnektor für Claude, ChatGPT und andere KIs

Clarity ist ein entfernter MCP-Server mit OAuth-Anmeldung: Jeder Nutzer verbindet sich mit eigenem Konto und Guthaben. Server-URL:

Claude (Web, Desktop, Mobil)

1. Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen.
2. Name: Clarity. URL: die obige.
3. Verbinden → bei Clarity anmelden → Erlauben.
4. Frag zum Beispiel: "Nutze Clarity, um zu sehen, ob ChatGPT meinen E-Bike-Laden in Mailand empfiehlt".

ChatGPT

1. Einstellungen → Apps & Konnektoren → erweiterte Einstellungen: Entwicklermodus aktivieren.
2. Erstelle einen Konnektor: Name Clarity, die obige URL, OAuth-Authentifizierung.
3. Melde dich bei Clarity an und erlaube den Zugriff.
4. Aktiviere den Konnektor in einem Chat und fordere ein Audit oder einen Sichtbarkeitscheck an.

Claude Code, Cursor, Agenten und andere MCP-Clients (mit API-Schlüssel)

claude mcp add --transport http clarity https://clarity.whooho.it/api/mcp \
  --header "Authorization: Bearer clr_YOUR_API_KEY"

Oder in Clients mit JSON-Konfigurationsdatei:

{
  "mcpServers": {
    "clarity": {
      "type": "http",
      "url": "https://clarity.whooho.it/api/mcp",
      "headers": {
        "Authorization": "Bearer clr_YOUR_API_KEY"
      }
    }
  }
}

Guthaben und Abrechnung

• •Verfügbare Aufladungen: €10, €25, €50, €100. Zahlung über Stripe mit automatischer Rechnung.
• •Der Preis wird vor dem Aufruf abgezogen: Reicht das Guthaben nicht, startet der Aufruf nicht (Fehler 402).
• •Schlägt ein Aufruf oder ein einzelnes Modell fehl, wird dieser Teil automatisch erstattet.
• •Guthaben verfällt nicht. Jede Antwort zeigt den abgebuchten Betrag und das Restguthaben.

Sicherheit

• •API-Schlüssel werden nur als kryptografischer Hash (SHA-256) gespeichert: Selbst wir können sie nicht lesen. Widerruf mit einem Klick.
• •Konnektoren nutzen OAuth 2.1 mit PKCE: Dein Passwort läuft nie über die KI-App. Zugriffstoken gelten eine Stunde und rotieren bei der Erneuerung.
• •Ein Konnektor sieht nur Guthaben und Werkzeuge: nicht deine Marken, Analysen oder Zahlungsdaten.
• •Geprüfte Adressen werden kontrolliert: keine privaten Netze, internen Server oder Cloud-Metadaten. Frequenz-, Größen- und Zeitlimits bei jedem Aufruf.
• •Deine Fragen werden wie von einem Nutzer an KI-Modelle (OpenAI, Google, Perplexity und andere) weitergegeben: Gib keine personenbezogenen oder vertraulichen Daten ein.

Fehler und Limits

Aktuelle Limits: 20 Aufrufe pro Minute und Schlüssel, 3 gleichzeitige Aufrufe pro Konto, Antwort innerhalb von 2 Minuten.