wydii/leboncoin-mcp

14 stars 7 forks Quality 78 Trend 28MIT

MCP Leboncoin pour connecter un agent avec les annonces leboncoin.

Overview

Serveur MCP (Model Context Protocol) pour rechercher et consulter les annonces Leboncoin depuis un assistant IA. Ce serveur MCP est basé sur la librairie Python par etienne-hd — un client non-officiel pour l'API Leboncoin. Merci à lui pour le travail de reverse-engineering ! un shell.nix est fourni — nix-shell configure le LD_LIBRARY_PATH et active le venv automatiquement. C'est le mode utilisé par les clients MCP comme Cursor, Claude Desktop, etc. Ajoutez ceci dans votre configuration MCP (.cursor/mcp.json) : Une fois le serveur connecté à votre assistant IA, vous pouvez lui demander : - « Cherche des vélos électriques à moins de 800€ en Île-de-France » - « Montre-moi les appartements 3 pièces à Lyon » - « Donne-moi les détails de l'annonce 2345678901 » - « Quelles sont les catégories disponibles sur Leboncoin ? » - lbc >= 1.1.2 — Client Python pour Leboncoin - FastMCP >= 3.2.0 — Framework pour serveurs MCP en Python

README

leboncoin-mcp

Serveur MCP (Model Context Protocol) pour rechercher et consulter les annonces Leboncoin depuis un assistant IA.

Crédits

Ce serveur MCP est basé sur la librairie Python lbc par etienne-hd — un client non-officiel pour l’API Leboncoin. Merci à lui pour le travail de reverse-engineering !

Fonctionnalités

Outil	Description
`search_ads`	Rechercher des annonces (texte, catégorie, localisation, prix, tri…)
`get_ad`	Récupérer les détails complets d’une annonce
`get_user`	Consulter le profil d’un vendeur
`list_categories`	Lister les catégories disponibles
`list_regions`	Lister les régions françaises
`list_departments`	Lister les départements français

Installation

git clone https://github.com/wydii/leboncoin-mcp.git
cd leboncoin-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Utilisateurs Nix : un shell.nix est fourni — nix-shell configure le LD_LIBRARY_PATH et active le venv automatiquement.

Utilisation

Transport stdio (par défaut)

python server.py

C’est le mode utilisé par les clients MCP comme Cursor, Claude Desktop, etc.

Transport SSE (HTTP)

python server.py --sse              # port 3001 par défaut
python server.py --sse --port=8080  # port personnalisé

Configuration dans Cursor

Ajoutez ceci dans votre configuration MCP (.cursor/mcp.json) :

{
  "mcpServers": {
    "leboncoin": {
      "command": "python",
      "args": ["/chemin/vers/leboncoin-mcp/server.py"]
    }
  }
}

Exemples d’utilisation

Une fois le serveur connecté à votre assistant IA, vous pouvez lui demander :

« Cherche des vélos électriques à moins de 800€ en Île-de-France »
« Montre-moi les appartements 3 pièces à Lyon »
« Donne-moi les détails de l’annonce 2345678901 »
« Quelles sont les catégories disponibles sur Leboncoin ? »

Référence des outils

`search_ads`

Paramètre	Type	Description
`text`	string	Texte de recherche
`url`	string	URL Leboncoin complète (remplace text/category/location)
`category`	string	Catégorie (`VEHICULES`, `IMMOBILIER`, `ELECTRONIQUE`, `LOISIRS`, `MODE`…)
`city`	string	Nom de ville (informatif, utilisé avec lat/lng)
`latitude`	float	Latitude
`longitude`	float	Longitude
`radius`	int	Rayon en mètres (défaut : 30 000 = 30 km)
`region`	string	Région (`ILE_DE_FRANCE`, `BRETAGNE`, `PROVENCE_ALPES_COTE_D_AZUR`…)
`department`	string	Département (`PARIS`, `GIRONDE`, `BOUCHES_DU_RHONE`…)
`price_min`	int	Prix minimum en euros
`price_max`	int	Prix maximum en euros
`sort`	string	Tri : `NEWEST`, `OLDEST`, `CHEAPEST`, `EXPENSIVE`, `RELEVANCE`
`ad_type`	string	`OFFER` ou `DEMAND`
`owner_type`	string	`PRO`, `PRIVATE` ou `ALL`
`shippable`	bool	Filtrer les articles livrables uniquement
`page`	int	Numéro de page (à partir de 1)
`limit`	int	Résultats par page (max 35)

`get_ad`

Paramètre	Type	Description
`ad_id`	string	ID numérique de l’annonce (depuis l’URL)

`get_user`

Paramètre	Type	Description
`user_id`	string	ID utilisateur (format UUID)

`list_categories` / `list_regions` / `list_departments`

Aucun paramètre requis.

Dépendances

lbc >= 1.1.2 — Client Python pour Leboncoin
FastMCP >= 3.2.0 — Framework pour serveurs MCP en Python

Licence

MIT

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "leboncoin": {
      "command": "python",
      "args": ["/chemin/vers/leboncoin-mcp/server.py"]
    }
  }
}