apify-avis-clients-maps

name	apify-avis-clients-maps
description	Use when you want all the Google Maps reviews of one place in one shot - to read the verbatim, spot recurring complaints, or mine testimonials. Place URL -> CSV of reviews.

Récupérer les avis clients d'un lieu

Objectif & quand

One-shot : tu veux tous les avis Google Maps d'un lieu d'un coup - le tien, celui d'un client à auditer, ou d'un concurrent à décortiquer. Pour lire le verbatim en entier, repérer ce qui revient (les points forts à mettre en avant, les reproches récurrents à corriger), ou piocher des témoignages. Cet Actor lit les avis publics du lieu et te sort un tableau exploitable.

Prérequis

• Compte Apify + APIFY_TOKEN (gratuit pour démarrer).
• MCP Apify configuré (CONNECTING-MCP.md).

Actor utilisé

compass/Google-Maps-Reviews-Scraper (https://apify.com/compass/Google-Maps-Reviews-Scraper) - extrait les avis d'un lieu Google Maps à partir de son URL (note, texte, date, réponse du gérant).

Config (config.example.yaml)

Champ	Rôle
startUrls	URL(s) du/des lieu(x) Google Maps (contient /maps/place/)
maxReviews	nombre max d'avis à récupérer par lieu (borne le coût)
reviewsSort	ordre : newest, mostRelevant, highestRanking, lowestRanking
language	langue des résultats (fr)

Procédure (via MCP)

1. Récupérer l'URL du lieu : le chercher sur Google Maps, ouvrir sa fiche, copier l'URL (elle contient /maps/place/).
2. Demander au MCP Apify de lancer l'Actor compass/Google-Maps-Reviews-Scraper avec l'input de config.example.yaml (tool call-actor).
3. Récupérer les items du dataset (get-dataset-items).
4. Mettre en forme : une ligne par avis (colonnes ci-dessous).

Variantes utiles

Trois champs de l'Actor permettent de cibler la lecture sans changer de skill :

• Filtrer par note : reviewsSort: lowestRanking fait remonter d'abord les avis négatifs (les reproches à corriger). highestRanking fait ressortir les meilleurs (témoignages à recycler).
• Filtrer par période : reviewsStartDate (ex 3 months, ou 2026-01-01) ne garde que les avis récents - utile pour juger la période post-changement (nouveau gérant, nouveau menu).
• Filtrer par mot-clé : reviewsFilterString (ex accueil, livraison) ne remonte que les avis contenant ce mot - pour isoler un sujet précis (le service, un produit, un délai).

Si le MCP ne fait pas l'action

Fallback via lib/apify_helpers.py :

from lib import apify_helpers as a
reviews = a.run_actor("compass/Google-Maps-Reviews-Scraper", {
    "startUrls": [{"url": "https://www.google.com/maps/place/?q=place_id:ChIJb2000001"}],
    "maxReviews": 100,
    "reviewsSort": "newest",
    "language": "fr",
})

Ou lancer l'Actor depuis la console Apify (bouton Start) avec le même input.

Livrable

CSV : reviewer, rating, date, review_text, owner_response, likes.

Coût & limites

Pay-per-result : ~$0.0005 / avis. 200 avis ≈ $0.10. Le champ maxReviews borne la dépense. Données publiques ; les noms d'auteurs sont des données personnelles (RGPD), à n'exploiter qu'avec un motif légitime. Pour surveiller les nouveaux avis dans le temps (cron), voir le script veille_avis_maps.

Exemple

examples/avis-clients-maps.csv (données fictives, schéma réel).