goplaces

• Hai bisogno di un agente per trovare attività o punti di interesse nelle vicinanze — es. "caffetterie aperte entro 1 km, con valutazione 4+ stelle"
• Vuoi risolvere il nome di una posizione in linguaggio naturale (come "Soho, Londra") in un Google Place ID per chiamate API successive
• Hai bisogno di dettagli strutturati sui luoghi (orari, indirizzo, recensioni) trasmessi in uno script o flusso di lavoro tramite output JSON
• Il tuo agente deve filtrare i risultati per stato di apertura, fascia di prezzo, tipo o raggio geografico

• Non hai una chiave API di Google Places o non riesci a ottenerne una — la skill non funzionerà senza di essa
• Hai bisogno del rendering di mappe, indicazioni stradali o instradamento — questa skill è solo per ricerche, non è un Maps SDK completo
• Hai bisogno di dati su luoghi in grandi volumi o in blocco; si applicano le quote e la fatturazione standard dell'API Google Places

Esegui ricerche di luoghi in linguaggio naturale con filtri per stato aperto-ora, valutazione minima, fascia di prezzo, tipo e limite di risultati. Esempio: goplaces search "coffee" --open-now --min-rating 4 --limit 5.

Orienta i risultati di ricerca verso una specifica latitudine/longitudine e limitali a un raggio configurabile in metri, rendendo le ricerche basate sulla posizione precise e pertinenti.

Converti un nome di luogo in formato leggibile (ad es. "Soho, Londra") in uno o più Google Place ID utilizzando il comando resolve, consentendo ricerche di dettagli successive senza dover cercare manualmente gli ID.

Recupera dettagli completi per qualsiasi ID luogo, incluse le recensioni, tramite goplaces details <place_id> --reviews. Ideale per arricchire le risposte degli agenti con dati autorevoli sui luoghi.

Produce testo leggibile con colori ANSI per impostazione predefinita, oppure passa a JSON pulito con --json per un'analisi affidabile in script e pipeline di automazione. I colori possono essere disabilitati tramite --no-color o la variabile d'ambiente NO_COLOR.

Supporta set di risultati su più pagine tramite --page-token, consentendo agli agenti di scorrere grandi elenchi di risultati oltre la dimensione di pagina predefinita.

Un agente che aiuta un utente a pianificare una serata fuori può cercare ristoranti molto apprezzati e aperti in un quartiere specifico, filtrando per tipo di cucina e fascia di prezzo, per poi presentare i migliori risultati in un formato leggibile.

Un agente di pipeline dati risolve stringhe di posizione ambigue (ad es. quartieri cittadini, luoghi di interesse) in Google Place ID autorevoli, che vengono poi passati ad altre chiamate API o memorizzati in un database.

Un agente che ricerca un luogo recupera le sue recensioni di Google Places direttamente tramite goplaces details <id> --reviews, riassumendo il sentiment o estraendo feedback specifici senza richiedere un browser.

Uno script di automazione batch utilizza l'output --json per arricchire un elenco di nomi di attività commerciali con dati strutturati sui luoghi (indirizzi, valutazioni, orari), fornendo i risultati agli strumenti di elaborazione a valle.