Clarity dans vos IA et vos agents

Outils et tarifs

Tarifs en temps réel, déduits des crédits prépayés (1 crédit = 1 €).

Modèles disponibles: ChatGPT (chatgpt), Google Gemini (gemini)

Démarrage rapide

Deux appels d'exemple. Remplacez clr_YOUR_API_KEY par votre clé.

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

Connecteur pour Claude, ChatGPT et d'autres IA

Clarity est un serveur MCP distant avec connexion OAuth : chaque utilisateur se connecte avec son compte et ses crédits. URL du serveur :

Claude (web, bureau, mobile)

1. Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
2. Nom : Clarity. URL : celle ci-dessus.
3. Connecter → connectez-vous à Clarity → Autoriser.
4. Demandez par exemple : « Utilise Clarity pour voir si ChatGPT recommande ma boutique de vélos électriques à Milan ».

ChatGPT

1. Paramètres → Apps et connecteurs → paramètres avancés : activez le mode développeur.
2. Créez un connecteur : nom Clarity, l'URL ci-dessus, authentification OAuth.
3. Connectez-vous à Clarity et autorisez l'accès.
4. Activez le connecteur dans une conversation et demandez un audit ou un contrôle de visibilité.

Claude Code, Cursor, agents et autres clients MCP (avec clé API)

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

Ou, dans les clients qui utilisent un fichier de configuration JSON :

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

Crédits et facturation

• •Recharges disponibles : €10, €25, €50, €100. Paiement via Stripe et facture automatique.
• •Le prix est déduit avant l'appel : si le crédit ne suffit pas, l'appel ne démarre pas (erreur 402).
• •Si un appel ou un modèle échoue, cette partie est remboursée automatiquement.
• •Les crédits n'expirent pas. Chaque réponse indique le montant débité et le solde restant.

Sécurité

• •Les clés API sont stockées uniquement sous forme d'empreinte cryptographique (SHA-256) : même nous ne pouvons pas les lire. Révocation en un clic.
• •Les connecteurs utilisent OAuth 2.1 avec PKCE : votre mot de passe ne passe jamais par l'app IA. Les jetons d'accès durent une heure et tournent au renouvellement.
• •Un connecteur ne voit que les crédits et les outils : ni vos marques, ni vos analyses, ni vos données de paiement.
• •Les adresses analysées sont contrôlées : pas de réseaux privés, serveurs internes ni métadonnées cloud. Limites de fréquence, de taille et de durée sur chaque appel.
• •Les questions envoyées sont transmises aux modèles IA (OpenAI, Google, Perplexity et autres) comme le ferait un utilisateur : n'y mettez pas de données personnelles ou confidentielles.

Erreurs et limites

Limites actuelles : 20 appels par minute et par clé, 3 appels simultanés par compte, réponse sous 2 minutes.