Servidor MCP

CarHunt

fr.carhunt/carhunt
Comercio y retail Público y accesible MCP 2026-07-28

Qué hace este MCP

Searches French used-car listings, estimates vehicle prices, provides market statistics, and supports professional deal monitoring and watchlists.

car_market_stats
Statistiques marché d'un modèle (gratuit)
Market statistics for a used car model in France (median price, volume). Médiane de prix du segment (année ±1, tranche de km) et volume d'annonces actives pour un modèle sur le marché français.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['make', 'model'], 'properties': {'make': {'type': 'string'}, 'year': {'type': 'integer', 'description': 'Année du segment (optionnel, ±1 an)'}, 'model': {'type': 'string'}, 'mileage': {'type': 'integer', 'description': 'Kilométrage du segment (optionnel, tranche ±20k)'}}}
estimate_car_price
Estimer le prix d'une voiture (gratuit)
Estimate the market price of a used car in France. Estimation de prix basée sur les annonces comparables réelles du marché français : bon prix (Q1), valeur juste (médiane), prix haut (Q3), indice de confiance et annonces similaires. Le kilométrage est facultatif : sans lui, l'estimation part du kilométrage médian des annonces comparables et le signale dans `note`. Sans compte : 3 estimations/jour par IP. Avec clé personnelle Premium/Pro/Expert : quota du plan (15/jour, 30/jour ou illimité).
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['make', 'model', 'year'], 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. RENAULT'}, 'year': {'type': 'integer', 'description': 'Année-modèle'}, 'model': {'type': 'string', 'description': 'Modèle, ex. CLIO'}, 'energy': {'type': 'string', 'description': 'Essence, Diesel, Électrique, Hybride (optionnel)'}, 'gearbox': {'type': 'string', 'description': 'Manuelle ou Automatique (optionnel)'}, 'mileage': {'type': 'integer', 'description': "Kilométrage en km. Second facteur de prix après l'âge : le donner quand on le connaît. Si l'utilisateur ne l'a pas précisé, OMETTEZ ce paramètre plutôt que d'inventer une valeur — l'estimation utilisera alors le kilométrage médian des annonces comparables et le signalera dans `note` (à répercuter à l'utilisateur)."}}}
pro_deals
Flux d'annonces sous-cotées (clé API)
Underpriced car deals feed, sorted by deal-score. Les meilleures affaires du marché : annonces dont le prix est nettement sous la médiane de leur segment, triées des plus sous-cotées aux moins sous-cotées (min_deal_score 60 par défaut). L'outil de pige des négociants. Clé API Business requise.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'page': {'type': 'integer', 'description': 'Page de résultats (défaut 1)'}, 'limit': {'type': 'integer', 'description': 'Résultats par page, max 50 (défaut 25)'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'since': {'type': 'string', 'description': 'Timestamp ISO — ne renvoyer que les annonces découvertes après (polling incrémental)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'finition': {'type': 'string', 'description': 'Finition normalisée, ex. R-Line, GT Line'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'mileage_min': {'type': 'integer'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string', 'description': 'Vendeur professionnel ou particulier (couverture partielle)'}, 'motorization': {'type': 'string', 'description': 'Code moteur, ex. « 2.0 TDI » — match souple'}, 'min_deal_score': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Plancher de score (défaut 60 = nettement sous la cote)'}, 'seen_within_days': {'type': 'integer', 'description': 'Ne renvoyer que les annonces re-vues par les scrapers dans les N derniers jours (anti-annonces retirées ; recommandé 7)'}}}
pro_market_position
Position marché d'une annonce (clé API)
Market position of a specific listing: segment median, savings vs market. Médiane de prix du segment comparable d'une annonce + écart € / % vs marché (argument de négociation). listing_id = champ `id` d'un résultat pro_search/pro_deals.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['listing_id'], 'properties': {'listing_id': {'type': 'string'}}}
pro_search
Recherche pro complète (clé API)
Full professional search with deal-score, 50 results/page, incremental polling. Recherche complète pour les professionnels : deal-score de sous-cote sur chaque annonce, tri deal_score, filtres finition/motorisation/fraîcheur, pagination, polling incrémental (since). Requiert une clé API CarHunt Pro (plan Business). Consomme le quota mensuel de véhicules de l'organisation.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'page': {'type': 'integer', 'description': 'Page de résultats (défaut 1)'}, 'sort': {'enum': ['date', 'created_at', 'updated_at', 'price_asc', 'price_desc', 'deal_score'], 'type': 'string'}, 'limit': {'type': 'integer', 'description': 'Résultats par page, max 50 (défaut 25)'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'since': {'type': 'string', 'description': 'Timestamp ISO — ne renvoyer que les annonces découvertes après (polling incrémental)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'finition': {'type': 'string', 'description': 'Finition normalisée, ex. R-Line, GT Line'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'mileage_min': {'type': 'integer'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string', 'description': 'Vendeur professionnel ou particulier (couverture partielle)'}, 'motorization': {'type': 'string', 'description': 'Code moteur, ex. « 2.0 TDI » — match souple'}, 'min_deal_score': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Plancher de score de sous-cote (50 = prix médian marché)'}, 'seen_within_days': {'type': 'integer', 'description': 'Ne renvoyer que les annonces re-vues par les scrapers dans les N derniers jours (anti-annonces retirées ; recommandé 7)'}}}
pro_usage
Consommation API du mois (clé API)
Current month API usage: quota, vehicles consumed, remaining, extra credits. Quota mensuel de véhicules du plan, consommé, restant et crédits achetés.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}}
pro_watchlist_create
Créer une watchlist (clé API, scope write)
Create a watchlist: criteria are evaluated every 10 minutes against the already collected catalog, then matching listings are pushed to a webhook. Crée une alerte : chaque nouvelle annonce détectée qui matche les critères est poussée en POST JSON sur webhook_url (véhicules livrés décomptés du quota mensuel). Clé API avec scope write requise.
Esquema de entrada
{'type': 'object', 'required': ['name'], 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'name': {'type': 'string'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'finition': {'type': 'string'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string'}, 'webhook_url': {'type': 'string', 'description': 'URL http(s) POST JSON appelée à chaque nouvelle annonce matchante'}, 'motorization': {'type': 'string'}, 'min_deal_score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}
pro_watchlist_delete
Supprimer une watchlist (clé API, scope write)
Delete a watchlist by id. Supprime une watchlist (cf. pro_watchlist_list).
Esquema de entrada
{'type': 'object', 'required': ['watchlist_id'], 'properties': {'watchlist_id': {'type': 'string'}}}
pro_watchlist_list
Lister les watchlists (clé API)
List the organization's watchlists (automatic alerts). Critères évalués toutes les 10 minutes sur le catalogue déjà collecté, puis notification par email, Discord ou webhook JSON.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}}
search_used_cars
Rechercher des voitures d'occasion (gratuit)
Search used cars for sale in France across all major marketplaces. Recherche multi-critères dans les annonces françaises agrégées par CarHunt (LeBonCoin, LaCentrale, L'Argus, Autosphere, ParuVendu…). Sans compte : 10 résultats max, sans deal-score. Avec une clé personnelle Premium/Pro/Expert (Bearer chu_live_…) : 25 résultats, deal-score visible et tri deal_score. Chaque annonce inclut source_url (lien direct vers l'annonce d'origine) — à toujours citer.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'sort': {'enum': ['date', 'price_asc', 'price_desc', 'updated_at', 'deal_score'], 'type': 'string', 'description': 'date = découverte la plus récente (défaut) ; updated_at = fraîcheur scraper ; deal_score = sous-cote (clé Premium/Pro/Expert ou Business requise)'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Nombre de résultats (max 10 sans clé, 25 avec clé Premium/Pro/Expert)'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string', 'description': 'Vendeur professionnel ou particulier (couverture partielle)'}}}
Modificado
estimate_car_price
29 de September de 2026 a las 02:51
Modificado
search_used_cars
29 de September de 2026 a las 02:51
Añadido
pro_usage
17 de September de 2026 a las 12:39
Añadido
pro_watchlist_delete
17 de September de 2026 a las 12:39
Añadido
pro_watchlist_create
17 de September de 2026 a las 12:39
Añadido
pro_watchlist_list
17 de September de 2026 a las 12:39
Añadido
pro_market_position
17 de September de 2026 a las 12:39
Añadido
pro_deals
17 de September de 2026 a las 12:39
Añadido
pro_search
17 de September de 2026 a las 12:39
Añadido
car_market_stats
17 de September de 2026 a las 12:39
Añadido
estimate_car_price
17 de September de 2026 a las 12:39
Añadido
search_used_cars
17 de September de 2026 a las 12:39