Vai al contenuto
Locly
AccediRichiedi accesso
ClaudeChatGPTClaude CodeCLIAltri

Cerca i locali giusti in ogni client MCP con Locly

La configurazione per ogni client MCP

{
  "mcpServers": {
    "locly": {
      "type": "http",
      "url": "https://rabdo.io/api/mcp"
    }
  }
}
Cursor

Un clic aggiunge Locly ai server MCP di Cursor.

Aggiungi a Cursor
VS Code

Con VS Code installato, nel terminale:

code --add-mcp '{"name":"locly","type":"http","url":"https://rabdo.io/api/mcp"}'
  • 18strumenti
  • OAuthnessuna chiave
  • 4permessi, li scegli tu
  • UEdati a Francoforte
Claude

Prova in Claude

Domande vere di una rete, pronte da aprire. Serve Locly già collegato a Claude.

  • Candidati search_candidates

    Mostrami i 5 candidati migliori sotto i 2.000 € al mese e dimmi che cosa resta da verificare per ognuno.

    Apri in Claude
  • Analisi request_analysis

    Prepara l’analisi geomarketing di Pisa e riassumimi il giudizio in cinque righe.

    Apri in Claude
  • Avvisi list_alerts

    Che cosa è cambiato negli avvisi questa settimana? Prima i ribassi sui locali in rosa.

    Apri in Claude
  • Candidati get_candidate

    Confronta i primi due locali della rosa e dimmi che cosa chiedere ai proprietari.

    Apri in Claude
  • Rosa save_shortlist

    Segna come visitato il primo candidato di Roma e aggiungi la nota «visto giovedì».

    Apri in Claude
  • Calibrazione get_calibration

    Quanto pesano flusso pedonale e parcheggi nel nostro punteggio, e qual è la soglia della rosa?

    Apri in Claude
  • Mercato get_market_around

    Quanti compro oro ci sono attorno al candidato 12?

    Apri in Claude
MCP

Gli strumenti

Diciotto strumenti, gli stessi per MCP, API e CLI. Quelli che leggono non cambiano niente; quelli che scrivono chiedono il permesso che hai dato all’app e il ruolo giusto nella rete.

StrumentoChe cosa faTipoRuolo minimo
list_networksLe tue reti, il tuo ruolo e le ricerche attive.leggelettore
search_candidatesI candidati dell’ultima lettura in ordine di punteggio, con filtri e pagine.leggelettore
get_candidateLa scheda di un annuncio: punteggio e perché, testo, dati del portale, contatti scritti nel testo.leggelettore
get_market_aroundI concorrenti, le gioiellerie e i punti della rete attorno a un candidato, dai dati aperti: quanti entro 300 m, 500 m e 1 km, i più vicini, con sito e distanza. Senza telefoni né email.leggelettore
list_alertsNuovi annunci, ribassi, rincari, locali spariti o entrati in rosa.leggelettore
mark_alerts_readSegna gli avvisi come letti per tutta la rete.scrivelettore
list_perimetersI comuni e le zone in cui la rete cerca.leggelettore
get_calibrationPesi, soglia e vincoli del profilo, in sola lettura.leggelettore
engine_statusQuando sono stati letti i portali e se c’è una lettura in corso.leggelettore
request_refreshMette in coda una nuova lettura dei portali.scriveeditor
save_shortlistStato di lavoro e nota di un candidato, condivisi con il team.scriveeditor
request_analysisChiede l’analisi geomarketing di un comune o di una zona disegnata. Non manda email.scriveeditor
get_analysisStato, riepilogo e versioni di un’analisi.leggelettore
wait_for_jobAspetta fino a 50 secondi che un’analisi o una lettura finisca.leggelettore
download_analysisIl collegamento al PDF, valido cinque minuti.leggelettore
edit_analysisUna versione nuova del PDF con le correzioni della rete.scriveeditor
rename_analysis_versionDà, cambia o toglie il nome di una versione, per ritrovarla. Il PDF non cambia.scriveeditor
decide_analysisDopo l’analisi: cerca i locali nella zona oppure rifiutala.scriveeditor
OAuth 2.1

Sicurezza e permessi

  • Il tuo account, nessuna chiave

    L’accesso è OAuth 2.1 con il server di autenticazione di Locly. Non ci sono chiavi da copiare in un file o da perdere in una chat.

  • Gli stessi permessi del sito

    Ogni chiamata passa dalle stesse regole del database: vedi solo le tue reti, e un lettore resta un lettore anche dentro Claude.

  • Scegli tu che cosa può fare

    La lettura c’è sempre. Rosa e note, analisi e nuove letture si accendono una per una sulla pagina di consenso, e si cambiano dopo.

  • Revoca in un clic

    Impostazioni → App collegate: l’elenco delle app, le loro ultime chiamate e il pulsante per revocarle. Da quel momento Locly rifiuta i loro token, anche quelli non ancora scaduti.

  • Un registro delle chiamate

    Ogni chiamata è registrata con app, strumento ed esito, mai con il testo delle note. Il proprietario della rete vede quelle della rete.

  • I testi degli annunci sono dati

    Titoli, descrizioni e contatti arrivano da terzi e tornano all’assistente marcati come dati, non come istruzioni. I contatti solo nella scheda di un annuncio alla volta.

REST · CLI

API e CLI

Le stesse funzioni anche come REST, per le integrazioni della rete, e come comando nel terminale. Stesso accesso OAuth, stessi permessi, errori e limiti uguali.

Limiti: 60 chiamate al minuto per app, 100 schede di annunci al giorno per persona, 20 analisi al giorno per rete (anche quelle del sito).

Specifica OpenAPI

REST
curl -H "Authorization: Bearer $LOCLY_TOKEN" \
  https://rabdo.io/api/v1/networks
CLI
npm i -g https://rabdo.io/cli/locly-cli.tgz
locly auth login
locly candidates --city Roma --max-price 2000
locly analysis request "Pisa" --wait
FAQ

Domande

Costa qualcosa in più?

No. Il server MCP, l’API e la CLI sono compresi in Locly. Il tuo assistente (Claude, ChatGPT, Cursor) lo paghi a lui, come sempre.

Che cosa vede il modello?

Solo quello che gli strumenti restituiscono alla domanda che fai: le reti, i candidati, gli avvisi, le analisi. Quei dati passano al fornitore dell’assistente che usi, con le sue regole: scegli tu se collegarlo.

Posso dargli solo la lettura?

Sì, ed è la scelta di partenza. Sulla pagina di consenso le caselle di scrittura sono spente, e Locly rifiuta le scritture che l’app non ha ricevuto: accendi solo quelle che ti servono.

Come lo scollego?

In Locly: Impostazioni → App collegate → Revoca. Oppure dal tuo assistente, fra i connettori. La revoca in Locly vale subito, anche per i token non ancora scaduti.

Un’app può mandare email a mio nome?

No. Chiedere un’analisi da un assistente non manda niente a nessuno: il PDF lo scarichi tu. L’invio per email resta una scelta del sito.

Funziona con ChatGPT?

Sì, con i connettori personalizzati di ChatGPT, che dipendono dal piano. Claude, Claude Code, Cursor e VS Code funzionano con qualsiasi account.

I locali migliori, chiesti alla chat che usi già

Un indirizzo, il tuo account, i permessi che scegli tu. E si scollega da Impostazioni in un clic.

Collega Locly a Claude