Amazon MCP

Serveur MCP (Model Context Protocol) qui scrape amazon.fr pour donner à Claude accès aux prix des articles : recherche, fiche produit, suivi de prix avec historique.

Outils exposés à Claude

Outil	Description
search_products(query, max_results=10)	Recherche : titre, prix, ASIN, URL, note, Prime
get_product(url_or_asin)	Fiche produit : prix, disponibilité, note, avis, vendeur
track_product(url_or_asin, label=None)	Ajoute un produit au suivi de prix automatique
untrack_product(asin)	Retire un produit du suivi
list_tracked()	Produits suivis + dernier prix + variation
get_price_history(asin, days=30)	Historique de prix (série datée, min/max/actuel)

Le suivi relève les prix automatiquement toutes les 6 h (jitter aléatoire).

Architecture

• Cascade de scraping : requests → curl_cffi (empreinte TLS Chrome) → Playwright (Chromium headless). Escalade automatique si captcha/blocage détecté. Ajouter un backend = une sous-classe de ScraperBackend + une entrée dans default_backends() (engine.py).
• Parsers modulaires par type de page (parsers/) — ajouter un pattern de recherche = un parser + un outil MCP.
• SQLite (data/amazon.db) pour le suivi et l'historique.
• Rate-limit interne (≥ 3 s entre requêtes Amazon) + cache 15 min.

Développement local

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/playwright install chromium   # optionnel : uniquement pour le backend Playwright
.venv/bin/pytest                        # aucun test ne touche le réseau
cp .env.example .env
.venv/bin/python -m amazon_mcp.server   # écoute sur http://0.0.0.0:8321<MCP_SECRET_PATH>

Déploiement sur le VPS (amazon.mcp.mawena.cloud)

Prérequis (déjà en place) : Docker, Nginx, DNS amazon.mcp.mawena.cloud → VPS.

1. Cloner et configurer

git clone <repo> /opt/amazon-mcp && cd /opt/amazon-mcp
cp .env.example .env
# Générer le chemin secret et le mettre dans .env :
python3 -c "import secrets; print('/mcp-'+secrets.token_urlsafe(12))"
nano .env   # MCP_SECRET_PATH=/mcp-<le-token-généré>

⚠️ Le chemin secret est la seule protection d'accès : ne le partage jamais et ne le commite pas.

2. Lancer le conteneur

docker compose up -d --build
# Vérifier :
docker compose logs -f amazon-mcp

3. Nginx + HTTPS

sudo cp deploy/nginx.conf /etc/nginx/sites-available/amazon-mcp
sudo ln -s /etc/nginx/sites-available/amazon-mcp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d amazon.mcp.mawena.cloud

4. Tester

curl -i -X POST https://amazon.mcp.mawena.cloud<MCP_SECRET_PATH> \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Réponse attendue : un événement SSE contenant "serverInfo":{"name":"Amazon FR"...}.

Connecter les clients Claude

L'URL complète du serveur est : https://amazon.mcp.mawena.cloud<MCP_SECRET_PATH>

• claude.ai / app Claude : Paramètres → Connecteurs → Ajouter un connecteur personnalisé → coller l'URL.
• Claude Code :

  claude mcp add --transport http amazon https://amazon.mcp.mawena.cloud<MCP_SECRET_PATH>
  

• Claude Desktop : Paramètres → Connecteurs → Ajouter un connecteur personnalisé → coller l'URL.

Ensuite, demande simplement à Claude : « Cherche-moi le prix d'un clavier mécanique sur Amazon » ou « Suis le prix de https://www.amazon.fr/dp/B08N5WRWNW ».

Maintenance

docker compose logs -f          # logs (scraping, scheduler, erreurs)
docker compose up -d --build    # redéployer après un git pull
sqlite3 data/amazon.db 'SELECT * FROM price_history ORDER BY scraped_at DESC LIMIT 10;'

Améliorer le taux de succès du scraping (cookies de session)

Depuis une IP datacenter (VPS), Amazon bloque agressivement. Le backend Playwright applique déjà des techniques stealth (masquage des signaux d'automatisation, viewport et fuseau réalistes), mais le levier le plus efficace est d'injecter les cookies d'une session amazon.fr réelle :

1. Sur ton navigateur, connecte-toi sur amazon.fr.
2. Installe une extension d'export de cookies (ex. Cookie-Editor).
3. Sur amazon.fr, ouvre l'extension → Export → Export as JSON.
4. Colle le contenu dans data/cookies.json sur le VPS (le format d'export est normalisé automatiquement).

Le fichier est optionnel : absent, le scraping continue sans (best-effort). Les cookies expirent au bout de quelques semaines — à réexporter si le taux de succès chute. data/ est dans .gitignore : ces cookies ne partent jamais sur GitHub.

⚠️ Même avec cookies + stealth, une IP datacenter reste souvent bloquée par Amazon. Pour un fonctionnement fiable, la seule solution robuste est de sortir via une IP résidentielle (proxy résidentiel ou tunnel).

Note légale

Le scraping automatisé est contraire aux CGU d'Amazon. Ce projet est prévu pour un usage personnel à très faible volume (rate-limit, cache, horaires avec jitter). À utiliser en connaissance de cause.