Introduction

Klozeo est la base de leads où vos automatisations écrivent et que votre équipe et vos assistants IA consultent.

Si vous avez déjà jonglé avec des données de leads entre des tableurs, des CRM et des scripts maison, Klozeo vous offre un endroit unique et structuré pour stocker ces données, et une API puissante pour les exploiter.

Quel problème Klozeo résout-il ?

La plupart des outils qui stockent des données de leads ont été conçus pour des humains : formulaires, tableaux, imports manuels. Ils sont difficiles à automatiser, difficiles à interroger avec précision et impossibles à connecter à des workflows IA sans un important code d’intégration.

Klozeo est conçu pour un autre monde :

Votre pipeline envoie les leads via l’API, depuis des scrapers, des webhooks ou des intégrations
Vos règles les scorent automatiquement, selon des critères que vous définissez en expressions simples
Votre assistant IA les interroge en langage naturel, grâce à l’intégration MCP intégrée

Vous gardez le contrôle. Klozeo s’occupe du stockage, du dédoublonnage, du scoring et de l’exposition.

Concepts de base

Avant de plonger dans l’API, voici les cinq concepts que vous croiserez partout :

Leads

Un lead est une entreprise ou une personne que vous voulez suivre. Chaque lead a des champs standard (name, email, phone, website, city…) ainsi que les champs personnalisés que vous ajoutez via les attributs.

Les leads sont identifiés par un ID préfixé : cl_<uuid>.

Attributs

Les attributs sont des champs personnalisés que vous attachez à un lead. Ils vous permettent d’étendre le schéma par défaut sans aucune migration : ajoutez cuisine, employee_count, last_meeting_date ou tout champ dont votre workflow a besoin.

Règles de scoring

Une règle de scoring est une expression qui attribue un poids numérique à une propriété du lead. Klozeo évalue toutes vos règles et calcule un score de 0 à 100 pour chaque lead.

Exemple : « Ajoutez 20 points si le lead a un site web. Ajoutez 30 points de plus si sa ville est Paris. »

Dédoublonnage

Quand vous envoyez un nouveau lead, Klozeo vérifie automatiquement s’il existe déjà (même email, même SIREN, même source_id, ou même téléphone avec un nom proche) et le fusionne au lieu de créer un doublon. Vous obtenez des données propres sans logique supplémentaire de votre côté.

Intégration MCP

MCP (Model Context Protocol) permet à des clients IA comme Claude ou Cursor de se connecter directement à Klozeo et d’interroger vos leads en langage naturel. Au lieu d’écrire des appels API, vous demandez : « Montre-moi les 10 meilleurs leads à Berlin avec un score supérieur à 70. »

Comment la documentation est organisée

Section	Ce que vous y trouverez
Premiers pas	Authentification, votre première requête API, limites de débit
Référence API	Chaque endpoint, paramètre et format de réponse
Guides	Analyses approfondies : filtrage, pagination, dédoublonnage, opérations par lot, scoring
Intégration MCP	Comment connecter Claude, Cursor, Cline et d’autres clients IA
SDKs	Bibliothèques clientes officielles TypeScript, Python, Go et Rust
Ressources	FAQ et journal des modifications

Par où commencer

Je veux faire mon premier appel API → Authentification, puis Votre première requête

Je veux connecter Claude ou Cursor → Vue d’ensemble MCP

Je veux comprendre le fonctionnement du scoring → Guide du scoring des leads

Je veux envoyer des leads en masse → Opérations par lot

J’ai une question précise → FAQ

L’API en bref

Base URL: https://api.klozeo.com/api/v1
Auth:     X-API-Key: <your-key>
Format:   JSON

Tous les endpoints suivent les conventions REST. Les erreurs renvoient toujours la même forme { "error": "code", "message": "..." }. Les ID de leads sont préfixés (cl_), les ID de notes sont préfixés (note_), tout le reste est un UUID simple.