Leboncoin MCP Server

Give your AI assistant live access to leboncoin.fr, France's largest classifieds marketplace. This Actor runs as a Model Context Protocol (MCP) server, so Claude, Cursor, ChatGPT, n8n and other MCP clients can search listings, open a listing in full, find similar ads and list a seller's other ads in real time. It also runs as a classic scraper when you just want a dataset.

It reads the leboncoin mobile API (no account or login needed) through Apify RESIDENTIAL proxies in France, and handles leboncoin's anti-bot checks for you by switching to a new proxy exit when one is challenged.

MCP tools

Tool	What it does
search_listings	Search any category with filters (location, price, surface, rooms, seller type, sort) and get normalized rows
get_listing	Full detail for one listing id: complete description, all images, seller, location, attributes
similar_listings	Ads similar to a given listing
ads_by_seller	Other active ads from the same seller
search_around_me	Latest listings within a radius around a lat/lng point

Search-style tools return up to 100 listings per call (default 20), with a 400-character description preview and the first 3 image URLs per listing to keep responses compact. Use get_listing for the full text and every image. Sponsored ads are excluded, so price sorting is exact.

A tool call that fails (for example because leboncoin kept challenging every proxy exit) or returns no data is not charged.

Output fields (per listing)

Field	Description
list_id, url, subject, body	Identity, title, description
category_id, category_name, ad_type, status	Category and state
first_publication_date, index_date	Publication timestamps
price, price_cents, currency	Price in euros
owner_name, owner_type, owner_store_id, owner_user_id, owner_siren	Seller
city, zipcode, district, department_id/name, region_id/name, lat, lng	Location
real_estate_type, square, rooms, bedrooms, energy_rate, ges, furnished	Real-estate attributes
nb_images, thumbnail, images, has_phone	Media and contact flag
attributes, attribute_labels	Every attribute of the ad (key/value)

Attributes differ by category (cars have brand, model, mileage, fuel...), so the attributes map is the place to look for category-specific fields.

Connect it

1. Open the Actor in the Apify Console and enable Standby (or call its Standby URL directly).
2. Point your MCP client at https://<your-actor-standby-url>/mcp (Streamable HTTP) with your Apify token as a bearer token.
3. The five tools appear in your assistant.

Example MCP client config:

{
    "mcpServers": {
        "leboncoin": {
            "url": "https://<your-actor-standby-url>/mcp",
            "headers": { "Authorization": "Bearer <APIFY_TOKEN>" }
        }
    }
}

Classic run (dataset)

Prefer a plain dataset? Run the Actor normally with an input like:

{
    "category": "9",
    "departmentIds": ["75"],
    "priceMax": 600000,
    "roomsMin": 2,
    "sortBy": "time",
    "sortOrder": "desc",
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR" }
}

It pushes the same normalized listing rows as the search tool to the dataset. Set fetchDetails to also fetch each ad's detail payload (slower). Schedule it from the Console to track new inventory, or add a webhook to push results to your own system.

Use cases

• Conversational market research: "find 3-room apartments under 500k in Lyon, newest first" answered live.
• Lead enrichment: an agent pulls every active ad from a seller before outreach.
• Monitoring agents: a workflow polls new inventory around a point and alerts you.
• Price checks: sort by price and compare similar ads for any category (cars, motorbikes, rentals...).

Input (classic run)

Field	Description
category	Category id: 9 sales, 10 rentals, 11 flat-shares, 13 offices, 12 seasonal, 8 all real estate, 2 cars, 3 motorbikes, 1 vehicles, 0 all
keywords	Optional free-text query
departmentIds, regionIds, geo	Location filters (departments, regions or a radius around lat/lng)
realEstateTypes	maison / appartement / terrain / parking / autre
priceMin/Max, squareMin/Max, roomsMin/Max	Ranges
ownerType, sortBy, sortOrder	Seller type and sorting
fetchDetails, maxItems	Per-ad detail enrichment and result cap
proxyConfiguration	Defaults to Apify RESIDENTIAL, France

FAQ

Do I need an account or cookies? No. The Actor mints the anonymous device token the mobile app uses.

Why a proxy? leboncoin blocks datacenter IPs. The Actor uses Apify RESIDENTIAL proxies from France (proxy traffic is part of your Apify usage) and rotates to a new exit when one is challenged. leboncoin's anti-bot is strict, so an occasional tool call can fail after several exits; it is not charged and a retry normally works.

How fresh is the data? Live on every tool call.

Which categories? All of them. Real estate is the default; set category for cars, motorbikes and others.

Is scraping legal? You are responsible for complying with leboncoin's terms and applicable law. Query only public data, respect rate limits and privacy rules, and do not use personal data of private sellers for unsolicited marketing.