auchan-drive-mcp
Provides tools for interacting with Auchan Drive (auchan.fr) via a browser-driven session: product search with prices, price-per-kg/litre, promotions and loyalty cagnotte, plus cart management (adding single or multiple items, updating quantities, removing lines, viewing cart contents, availability, estimated total and cagnotte total, and retrieving a checkout link). Checkout and payment remain manual on the Auchan site.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@auchan-drive-mcp cherche du lait bio en promo et ajoute 2 bouteilles au panier"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
auchan-drive-mcp
Serveur MCP non officiel pour Auchan Drive : recherche produits, prix promo, cagnotte fidélité et gestion du panier depuis Claude Code, Claude Desktop ou tout client MCP.
Aucun paiement : créneau et paiement restent manuels sur auchan.fr.
Projet indépendant, sans lien avec Auchan. Repose sur l'API interne non documentée du site, susceptible de changer à tout moment. L'automatisation n'est probablement pas conforme aux CGU d'Auchan : usage personnel et à faible volume uniquement.
Fonctionnement
Chromium piloté par Playwright, avec un profil persistant (session et magasin Drive).
Token et consentement récupérés sur les requêtes du site lui-même, aucun identifiant en dur.
Panier via l'API du site, recherche via la page de résultats (avec pagination).
Délai minimum entre deux requêtes (
AUCHAN_MIN_INTERVAL).
Related MCP server: mon-marche-mcp
Installation
Python 3.11+.
git clone https://github.com/Spaghetih/auchan-drive-mcp.git
cd auchan-drive-mcp
python -m venv .venv
source .venv/bin/activate # Windows : .\.venv\Scripts\Activate.ps1
pip install -e .
playwright install chromiumConnexion
auchan-mcp loginDans la fenêtre ouverte : connexion par email et mot de passe (la connexion Google est refusée dans un navigateur automatisé), choix du magasin Drive, puis Entrée dans le terminal.
Le profil est stocké dans ~/.local/share/auchan-mcp/profile. Il contient la session : à protéger, ne pas partager.
Configuration du client MCP
Claude Code :
claude mcp add -s user auchan -- /chemin/vers/auchan-mcp/.venv/bin/auchan-mcp serveSous Windows : .venv\Scripts\auchan-mcp.exe.
Claude Desktop (claude_desktop_config.json) :
{
"mcpServers": {
"auchan": {
"command": "/chemin/vers/auchan-mcp/.venv/bin/auchan-mcp",
"args": ["serve"]
}
}
}Tools
Tool | Description |
| État de la session et des identifiants API |
| Recherche (jusqu'à 100 résultats) : prix, prix au kilo/litre, promo, |
| Ajout au panier (quantité cumulée) |
| Lignes, prix, disponibilité, total estimé, |
| Modification de quantité / suppression |
| Lien du panier |
Promos reconnues : N+M offert, N achetés = M payés, -X % sur le Nème, le Nème offert, N pour X €, remise immédiate.
Variables d'environnement
Variable | Défaut | Description |
|
|
|
|
| Délai minimum entre requêtes (s) |
|
| Quantité max par ligne |
|
| Profil Chromium |
Exemple de skill
examples/skills/panier-hebdo : panier hebdomadaire selon un budget et des objectifs nutritionnels, avec validation avant ajout. À copier dans ~/.claude/skills/.
Limites
Un seul process à la fois sur le profil Chromium.
Recherche et noms du panier dépendants du HTML du site.
Noms des lignes du panier associés par prix (absents de l'API) : erreur possible si deux lignes ont le même total.
Session expirée (« Token API non intercepté ») : relancer
auchan-mcp login.Captcha : relancer avec
AUCHAN_HEADLESS=0et le résoudre dans la fenêtre.
Debug
auchan-mcp capture -o capture.jsonl enregistre les appels réseau du site pendant la navigation. Secrets masqués, mais les réponses peuvent contenir des données de compte : ne pas publier ce fichier (exclu par .gitignore).
Licence
MIT
Available Tools
8 toolsadd_many_to_cartC
Ajout groupé. items = [{product_id, offer_id, seller_id, quantity}]. Continue si une ligne échoue.
Inputs: items (required). Returns: result
add_to_cartB
Ajoute quantity unités (s'additionne à ce qui est déjà au panier). IDs issus de search_products.
Inputs: offer_id (required), seller_id (required), product_id (required), quantity.
checkout_linkB
Lien du panier. Créneau et paiement se font à la main par l'utilisateur.
Inputs: no named parameters. Returns: result
remove_from_cartC
Supprime une ligne du panier.
Inputs: line_id (required).
search_productsB
Cherche des produits (prix du Drive sélectionné), en parcourant plusieurs pages si limit > ~34. Champs : price_eur, unit_price_eur + unit, promo {type, label, min_qty, effective_price_eur}, effective_unit_price_eur (prix au kilo/litre une fois la promo appliquée, si on prend promo.min_qty), cagnotte_pct / cagnotte_promo, sponsored, et product_id/offer_id/seller_id pour add_to_cart.
Inputs: query (required), limit. Returns: result
statusB
État de la session : connecté, consentId et headers API interceptés.
Inputs: no named parameters.
update_cart_lineA
Fixe la quantité d'une ligne (line_id issu de view_cart). 0 supprime la ligne.
Inputs: line_id (required), quantity (required).
view_cartB
Contenu du panier : lignes (line_id, nom, quantité, prix unitaire, dispo, cagnotte_eur), total estimé et cagnotte_total_eur (montant gagné sur la carte fidélité Auchan).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools target distinct operations (search, view, add, bulk add, status, checkout link), but remove_from_cart is fully redundant with update_cart_line when quantity is set to 0, creating a blurred boundary for deletion. Descriptions do clarify the intent, which keeps the overlap from being harmful, but two paths to the same outcome remain.
Nearly all names follow a snake_case verb_noun or verb_object pattern (add_to_cart, add_many_to_cart, update_cart_line, remove_from_cart, view_cart, search_products), with checkout_link as a noun-ish compound and status as a bare noun outlier. The pattern is predictable and readable despite those two deviations.
Eight tools map cleanly onto the cart workflow: discover, inspect, mutate (single/bulk/update/remove), finalize, and check session state. Nothing feels bloated, and each tool except the redundant remove_from_cart earns its place.
The core lifecycle is covered end-to-end: search products, add single or many, view cart, adjust quantity, remove lines, and obtain a checkout link for manual payment. Minor gaps exist (no clear-cart operation, no product-detail endpoint beyond search, no order history), but agents can work around them by removing lines individually.
Maintenance
Related MCP Connectors
E-commerce MCP gateway: live product deals, attributed buy links, order tracking, flights.
Search multi-merchant supply, checkout, and track orders via MCP.
Remote MCP for Living Stack offer discovery and buyer-authorized checkout preparation.
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that connects Carrefour Drive to Claude and other MCP clients, enabling product search with real prices, nutriscore, availability, and natural language cart management.MIT
- AlicenseAqualityDmaintenanceEnables an AI assistant to search the mon-marche.fr grocery catalog and build a basket, stopping at the cart without automating payment.10MIT
- AlicenseAqualityDmaintenanceMCP server for Carrefour Drive (carrefour.fr) that lets AI agents search the French grocery catalog, manage a shopping cart, book pickup/delivery slots, and access account data like loyalty points and receipts.2483MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search the catalog, manage a cart and usual orders, find delivery slots, and handle favorites, shopping lists, past orders, and item remarks through the store's API, with login and payment left to the user on the website.MIT