wydii/leboncoin-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

14 stars 7 forks 품질 78 트렌드 28MIT

Repository Install

MCP Leboncoin pour connecter un agent avec les annonces leboncoin.

개요

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

원문 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`

GitHub에서 전체 README 보기

설치

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

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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