WL

wydii/leboncoin-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

14 stars 7 forks Качество 78 Тренд 28MIT

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 — конфигурация никс-оболочки le LD LIBRARY PATH и активная автоматизация le venv. C'est le mode utilisé par les клиенты MCP comme Cursor, Claude Desktop и др. Ajoutez ceci dans votre конфигурация 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

Обзор (машинный перевод)

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 lbc par etienne-hd — un client non-officiel pour l’API Leboncoin. Merci à lui pour le travail de reverse-engineering!

Фонтональности

Outil | Описание

Rechercher des annonces (текст, категория, локализация, прикс, три…) get_ad | Récupérer les détails complets d’une annonce | [[Т2]] | Консултер ле профил д’юн вендер | list_categories | Lister les catégories disponibles | list_regions | Lister les régions françaises | [5][править править вики-текст]

##Установка

Утилизаторы Nix :** un shell.nix est fourni — nix-shell конфигурируют le LD_LIBRARY_PATH и активную автоматизацию le venv.

Использование

Транспортное сдио (par défaut)

C’est le mode utilisé par les клиенты MCP comme Cursor, Claude Desktop и др.

Транспортный SSE (HTTP)

Конфигурация dans Cursor

Ajoutez ceci dans votre конфигурация MCP.cursor/mcp.json:

Примеры использования

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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
Открыть полный README на GitHub

Установка

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"] } } }