# Comment connecter Claude aux données Leboncoin — OpenScraper *Page HTML : https://openscraper.ai/fr/claude-leboncoin_connecteur · Index pour agents : https://openscraper.ai/llms.txt* > Seul, Claude ne peut pas lire leboncoin.fr (le site est protégé par DataDome). En ajoutant le serveur MCP d'OpenScraper, `https://mcp.openscraper.ai/mcp`, Claude récupère les annonces Leboncoin à votre demande, en français et sans code. Dès 0,79 $ les 1 000 annonces (avec abonnement ; 0,93 $ sans), 5 $ offerts à l'inscription. ## Architecture Claude ne scrape pas directement Leboncoin. Il peut générer/exécuter une logique qui appelle une API de scraping. Voici l'architecture : Claude → OpenScraper API → Leboncoin → données structurées → Claude Claude choisit les outils et les paramètres ; les requêtes vers leboncoin.fr partent des serveurs OpenScraper (proxys, anti-bot, pagination), jamais de la conversation. ## Comment ça marche 1. Vous demandez à Claude, par exemple : « Récupère les 3 000 derniers appartements à vendre à Bordeaux et mets-les dans un Excel. » 2. Claude lance l'extraction : nos serveurs récupèrent les annonces sur leboncoin.fr (environ 3 500 par recherche ; au-delà, Claude découpe la recherche). 3. Vous récupérez le fichier : prix, surface, pièces, ville… dans un Excel ou un CSV (lien de téléchargement valable 24 h), prêt à importer dans votre base de données. Avec Claude Code, l'import peut se faire directement. ## Démonstration : 3 000 appartements à Bordeaux Demande : « Avec le connecteur OpenScraper, récupère les 3 000 derniers appartements à vendre à Bordeaux, calcule le prix au m² et donne-moi un fichier Excel. » Ce que fait Claude, avec les outils du serveur MCP : 1. `build_leboncoin_url` : traduit la demande en URL de recherche Leboncoin (Ventes immobilières, Appartement, Bordeaux, tri par date). 2. `run_scrape` : lance l'extraction sur nos serveurs (`module: "leboncoin_matrix"`, `max_results: 3000`), qui parcourent les pages de résultats (35 annonces par page) et transforment chaque annonce en une ligne de données. 3. `get_run` : suit la progression et lit un aperçu de 5 annonces. 4. `export_results` : génère un lien de téléchargement Excel ou CSV, valable 24 h. Une annonce en JSON (extrait, valeurs d'exemple) : ```json { "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/2846517203", "list_id": 2846517203, "subject": "Appartement T3 68 m² - Chartrons", "description": "Au cœur des Chartrons, T3 de 68 m² au 2e étage avec ascenseur : séjour lumineux, cuisine équipée, deux chambres, balcon et cave…", "category_name": "Ventes immobilières", "ad_type": "offer", "price": 329000, "currency": "EUR", "attributes": { "real_estate_type": "Appartement", "square": "68 m²", "rooms": "3", "bedrooms": "2", "floor_number": "2", "elevator": "Oui", "energy_rate": "D", "ges": "B" }, "annual_charges": 1440, "is_exclusive_mandate": false, "owner_type": "pro", "owner_name": "Cabinet Exemple Immobilier", "has_phone": true, "city": "Bordeaux", "zipcode": "33300", "district": "Chartrons", "department_name": "Gironde", "region_name": "Nouvelle-Aquitaine", "lat": 44.8576, "lng": -0.5703, "geo_precision": "area", "image": "https://img.leboncoin.fr/api/v1/lbcpb1/images/…/ad-large.jpg", "nb_images": 12, "first_publication_date": "2026-10-02 18:41:07", "last_publication_date": "2026-10-03 09:12:44", "urgent": false, "is_boosted": true, "counters_favorites": 17, "product_count": 2271, "scraped_at": "2026-10-04T12:20:31Z" } ``` Le fichier livré, avec une colonne calculée par Claude : ```csv list_id;subject;price;square;rooms;bedrooms;energy_rate;prix_m2;city;zipcode;district;owner_type;first_publication_date;url 2846517203;Appartement T3 68 m² - Chartrons;329000;68;3;2;D;4838;Bordeaux;33300;Chartrons;pro;2026-10-02;https://www.leboncoin.fr/ad/ventes_immobilieres/2846517203 2846498811;T2 lumineux proche tram;214000;45;2;1;C;4756;Bordeaux;33800;Saint-Jean;private;2026-10-02;https://www.leboncoin.fr/ad/ventes_immobilieres/2846498811 2846470129;Appartement 4 pièces avec balcon;398000;87;4;3;D;4575;Bordeaux;33000;Saint-Augustin;pro;2026-10-01;https://www.leboncoin.fr/ad/ventes_immobilieres/2846470129 2846455307;Studio rénové hypercentre;139000;24;1;0;E;5792;Bordeaux;33000;Saint-Pierre;private;2026-10-01;https://www.leboncoin.fr/ad/ventes_immobilieres/2846455307 2846431986;T3 avec parking, Bastide;276000;64;3;2;C;4313;Bordeaux;33100;La Bastide;pro;2026-10-01;https://www.leboncoin.fr/ad/ventes_immobilieres/2846431986 ``` À retenir : demandez à Claude une sortie structurée (une ligne par annonce, colonnes fixes) plutôt qu'un résumé. ## Connecter Claude à Leboncoin URL du serveur MCP : `https://mcp.openscraper.ai/mcp` ### claude.ai et app Claude (le plus simple) 1. Ouvrez **Paramètres → Connecteurs**. 2. Cliquez sur **« Ajouter un connecteur personnalisé »**, nommez-le « OpenScraper » et collez l'URL `https://mcp.openscraper.ai/mcp`. 3. Cliquez sur **« Se connecter »** et identifiez-vous avec votre compte OpenScraper. Le connecteur est aussi disponible dans l'application Claude Desktop et sur mobile. ### Claude Code Récupérez votre clé API (`sk_live_…`) dans le tableau de bord, puis : ```bash claude mcp add --transport http openscraper https://mcp.openscraper.ai/mcp \ -H "Authorization: Bearer sk_live_..." ``` ### Claude Desktop, avec une clé API Nécessite Node.js. Dans **Paramètres → Développeur → Modifier la config**, ajoutez puis redémarrez Claude : ```json { "mcpServers": { "openscraper": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.openscraper.ai/mcp", "--header", "Authorization:${OPENSCRAPER_AUTH}"], "env": { "OPENSCRAPER_AUTH": "Bearer sk_live_..." } } } } ``` ## Exemples de demandes - « Récupère toutes les maisons à vendre en Gironde sous 400 000 € et donne-moi un fichier Excel avec le prix au m². » - « Scrape les 2 000 dernières locations d'appartements à Lyon et importe-les dans ma base de données. » - « Récupère les 500 dernières Peugeot 208 diesel à moins de 10 000 € en Île-de-France, en CSV. » ## Limites et contraintes de Leboncoin - **Anti-bot** : leboncoin.fr est protégé par DataDome ; les requêtes de serveurs ou de navigateurs automatisés finissent en captcha puis en blocage d'IP. - **HTML qui change** : classes CSS générées, structure qui évolue ; des sélecteurs peuvent casser sans erreur visible. - **Pagination** : environ 35 annonces par page, arrêt vers 100 pages (environ 3 500 annonces) ; au-delà, il faut découper la recherche et dédoublonner. - **Fréquence des requêtes** : espacer les appels et ne pas recharger une annonce déjà lue (OpenScraper réutilise une description pendant 24 h). - **Conditions d'utilisation** : les CGU de Leboncoin interdisent l'extraction automatisée sans autorisation (risque contractuel). Se limiter aux annonces publiques, sans compte Leboncoin. ## Le scraping de Leboncoin est-il légal ? Le scraping n'est pas illégal en soi ; c'est l'usage de la base qui est encadré. Leboncoin est reconnu producteur d'une base de données (droit *sui generis*, [analyse de l'arrêt](https://cms.law/fr/fra/news-information/arret-leboncoin-web-scraping-droit-sui-generis-sur-les-bases-de-donnees)) et peut interdire l'extraction ou la réutilisation d'une partie substantielle de son contenu ([article L342-1 du CPI](https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000006279247)). Une extraction non substantielle et non systématique reste permise. La limite est la republication : en 2021, la cour d'appel de Paris a condamné un site concurrent qui republiait en masse les annonces immobilières de Leboncoin à 70 000 € de dommages-intérêts ([arrêt du 2 février 2021](https://www.legalis.net/jurisprudences/cour-dappel-de-paris-pole-5-ch-1-arret-du-2-fevrier-2021/)). Le nom d'un vendeur particulier est une donnée personnelle (RGPD). Section informative, pas un avis juridique. ## Tarifs Le connecteur est gratuit : vous payez seulement les annonces récupérées. | Offre | Prix | | --- | --- | | Sans abonnement | 0,93 $ / 1 000 annonces | | Abonnement Super Utilisateur (-15 %, dès 70 $/mois en crédits) | 0,79 $ / 1 000 annonces | 5 $ offerts à l'inscription, soit plus de 5 000 annonces. Une extraction de 3 000 annonces coûte environ 2,79 $. Détail des offres : . ## Questions fréquentes **Claude peut-il accéder à Leboncoin tout seul ?** Non. leboncoin.fr est protégé par DataDome, qui bloque les robots. Avec notre serveur MCP, Claude passe par l'infrastructure OpenScraper, qui gère l'anti-bot et lui renvoie les annonces en données structurées. **Peut-on récupérer des milliers d'annonces ?** Oui. Le scraping tourne sur nos serveurs. Une recherche Leboncoin va jusqu'à environ 3 500 annonces ; au-delà, Claude découpe la recherche (par département, par tranche de prix…). Il vous donne ensuite un lien vers un fichier Excel ou CSV avec toutes les annonces (valable 24 h). Avec Claude Code, il peut aussi les importer directement dans votre base de données. **Faut-il savoir coder ?** Non. Sur claude.ai, il suffit de coller une URL et de vous connecter. **Claude a-t-il accès à mon compte Leboncoin ?** Non. Seules les annonces publiques sont consultées ; vous vous connectez uniquement à votre compte OpenScraper. Pour utiliser les annonces sans Claude : .