# Comment connecter ChatGPT aux données Leboncoin — OpenScraper *Page HTML : https://openscraper.ai/fr/chatgpt-leboncoin · Index pour agents : https://openscraper.ai/llms.txt* > Seul, ChatGPT 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`, ChatGPT 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 ChatGPT ne scrape pas directement Leboncoin : il appelle une API de scraping, qui le fait pour lui. ChatGPT → OpenScraper API → Leboncoin → données structurées → ChatGPT ChatGPT 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 à ChatGPT, par exemple : « Récupère les 3 000 derniers appartements à vendre à Bordeaux et mets-les dans un Excel. » 2. ChatGPT lance l'extraction : nos serveurs récupèrent les annonces sur leboncoin.fr (environ 3 500 par recherche ; au-delà, ChatGPT 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. ## Exemple : 1 000 appartements à Bordeaux Demande : « @OpenScraper récupère les 1 000 derniers appartements à vendre à Bordeaux, calcule le prix au m² et donne-moi un fichier Excel. » Les outils du serveur MCP appelés pour cette demande : 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: 1000`), 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 ChatGPT : ```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 à ChatGPT une sortie structurée (une ligne par annonce, colonnes fixes) plutôt qu'un résumé. ## Connecter ChatGPT à Leboncoin URL du serveur MCP : `https://mcp.openscraper.ai/mcp` ### ChatGPT (navigateur), sans code Les libellés des menus de ChatGPT sont cités en anglais, comme dans la documentation d'OpenAI. 1. Dans ChatGPT, ouvrez les **paramètres**, rubrique **« Security and login »**, et activez le **mode développeur** (« Developer mode »). 2. Ouvrez , cliquez sur **+** puis sur **« Add custom MCP server »**. 3. Nommez-le « OpenScraper », collez l'URL `https://mcp.openscraper.ai/mcp` et choisissez l'authentification **OAuth**. 4. Acceptez l'avertissement, cliquez sur **« Create as a plugin »** et identifiez-vous avec votre compte OpenScraper. 5. Dans une nouvelle conversation, tapez `@`, choisissez OpenScraper et posez votre question. Le mode développeur n'est pas proposé sur toutes les offres ChatGPT, et son emplacement dans les paramètres a déjà changé. Dans un espace de travail d'entreprise, un administrateur peut devoir autoriser les serveurs MCP personnalisés. ### API OpenAI (pour les développeurs) Récupérez votre clé API OpenScraper (`sk_live_…`) dans le tableau de bord, puis déclarez notre serveur comme outil `mcp` dans un appel à l'API Responses : ```bash curl https://api.openai.com/v1/responses \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5", "tools": [{ "type": "mcp", "server_label": "openscraper", "server_url": "https://mcp.openscraper.ai/mcp", "headers": { "Authorization": "Bearer sk_live_..." }, "require_approval": "never" }], "input": "Récupère les 500 derniers appartements à vendre à Bordeaux sur Leboncoin et donne-moi le lien du fichier CSV." }' ``` ## 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 donne-moi le prix médian par arrondissement. » - « 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 serveur MCP est gratuit : vous payez seulement les annonces récupérées. Votre abonnement ChatGPT reste à part. | 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 **ChatGPT peut-il lire les annonces Leboncoin tout seul ?** Non. leboncoin.fr est protégé par un anti-bot (DataDome) qui bloque les requêtes automatisées, y compris la navigation web de ChatGPT. Il lui faut un outil externe qui récupère les annonces à sa place. **Comment ChatGPT récupère-t-il les annonces Leboncoin ?** En connectant notre serveur MCP, ChatGPT passe par l'infrastructure OpenScraper, qui gère l'anti-bot et lui renvoie les annonces Leboncoin sous forme de données structurées, prêtes à être exploitées dans ses réponses. **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à, ChatGPT 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). **Faut-il savoir coder ?** Non. Dans ChatGPT, il suffit d'activer le mode développeur, de coller une URL et de vous connecter. Le code n'est utile que si vous passez par l'API OpenAI. **ChatGPT a-t-il accès à mon compte Leboncoin ?** Non. Seules les annonces publiques sont consultées ; vous vous connectez uniquement à votre compte OpenScraper. Avec Claude : . Pour utiliser les annonces sans assistant : (paramètres : ).