Clarity dentro le tue AI e i tuoi agenti

Strumenti e prezzi

Prezzi aggiornati in tempo reale, scalati dai crediti prepagati (1 credito = 1 €).

Modelli disponibili ora: ChatGPT (chatgpt), Google Gemini (gemini)

Avvio rapido

Due chiamate di esempio. Sostituisci clr_YOUR_API_KEY con la tua chiave.

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": "…"
    }]
  }
}

Connettore per Claude, ChatGPT e altre AI

Clarity è un server MCP remoto con accesso OAuth: ogni utente si collega con il proprio account e i propri crediti. URL del server:

Claude (web, desktop, mobile)

1. Impostazioni → Connettori → Aggiungi connettore personalizzato.
2. Nome: Clarity. URL: quello qui sopra.
3. Connetti → accedi a Clarity → Consenti.
4. Chiedi ad esempio: "Usa Clarity per vedere se ChatGPT consiglia il mio negozio per le bici elettriche a Milano".

ChatGPT

1. Impostazioni → App e connettori → impostazioni avanzate: attiva la modalità sviluppatore.
2. Crea un connettore: nome Clarity, URL quello qui sopra, autenticazione OAuth.
3. Accedi a Clarity e consenti l'accesso.
4. Attiva il connettore in una chat e chiedi un audit o un controllo di visibilità.

Claude Code, Cursor, agenti e altri client MCP (con chiave API)

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

Oppure, nei client che usano un file di configurazione JSON:

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

Crediti e fatturazione

• •Ricariche disponibili: €10, €25, €50, €100. Pagamento con Stripe e fattura automatica.
• •Il prezzo viene scalato prima della chiamata: se il credito non basta la chiamata non parte (errore 402).
• •Se una chiamata o un singolo modello non risponde, quella parte viene rimborsata automaticamente.
• •I crediti non scadono. Ogni risposta indica quanto è stato addebitato e il saldo residuo.

Sicurezza

• •Le chiavi API sono salvate solo come impronta crittografica (SHA-256): nemmeno noi possiamo leggerle. Puoi revocarle in un clic.
• •I connettori usano OAuth 2.1 con PKCE: la tua password non passa mai dall'app AI. I token di accesso durano un'ora e si rinnovano a rotazione.
• •Un connettore vede solo crediti e strumenti: non i tuoi brand, le analisi o i dati di pagamento.
• •Gli indirizzi analizzati vengono controllati: niente reti private, server interni o metadati cloud. Limiti di frequenza, dimensione e tempo su ogni chiamata.
• •Le domande che invii vengono passate ai modelli AI (OpenAI, Google, Perplexity e altri) come farebbe un utente: non inserire dati personali o riservati.

Errori e limiti

Limiti attuali: 20 chiamate al minuto per chiave, 3 chiamate contemporanee per account, risposta entro 2 minuti.