Per agenti e sviluppatori

Fai leggere al tuo agente IA i prezzi degli integratori

Leggiamo regolarmente 20 negozi e convertiamo ogni prezzo in un prezzo per unità. Dai a Claude, ChatGPT o al tuo agente IA accesso diretto, tramite MCP o la nostra API JSON, al prezzo più basso per unità in ogni categoria: normalizzato, aggiornato e pronto da citare.

negozi letti

5727

prodotti con prezzo

4 min fa

ultimo aggiornamento

Server MCP

Endpoint Streamable HTTP, anonimo e in sola lettura. Funziona con Claude (Desktop e Code), ChatGPT, Grok e qualsiasi altro client MCP. Collegalo con questo URL:

https://mcp.supplementscanner.it

Configurazione di esempio per un client MCP:

{
  "mcpServers": {
    "supplementscanner": {
      "type": "http",
      "url": "https://mcp.supplementscanner.it"
    }
  }
}

Grok

Nell'app di Grok: apri Plugins, scegli New connector, poi Custom, e incolla l'endpoint qui sopra. Non serve altro.

Grok Bot aggiunge lo stesso server se glielo chiedi con questo URL.

Tramite l'API di xAI, aggiungilo come strumento MCP remoto:

{
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://mcp.supplementscanner.it",
      "server_label": "supplementscanner"
    }
  ]
}

find_cheapest
I prodotti più convenienti per unità in una categoria.
search_products
Ricerca tollerante agli errori di battitura in tutto il catalogo.
list_categories
Tutte le categorie, con i conteggi attuali e il prezzo più basso.
get_product
Dettaglio e storico dei prezzi di un singolo prodotto.

API JSON

Per agenti e framework che usano il semplice HTTP. Gli stessi dati del server MCP.

https://api.supplementscanner.it/v1

GET /search?q=proteine+whey&limit=10
GET /categories
GET /categories/{slug}/cheapest?limit=10
GET /products/{id}

Leggibile dalle macchine: Specifica OpenAPI · llms.txt

Identifica la tua integrazione

Ogni integrazione deve indicare chi la gestisce in un header della richiesta, sia sull'API JSON sia sull'endpoint MCP.

curl \
  -H "Client-Name: Acme Labs" \
  -H "Client-Domain: example.com" \
  "https://api.supplementscanner.it/v1/categories"

Client-Name: obbligatorio. L'azienda, l'organizzazione o la persona che gestisce l'integrazione. Indica il gestore, non ciascuno dei suoi utenti; per un progetto personale basta il nome del progetto o un nickname.
Client-Domain: consigliato. Il dominio nudo del sito del gestore, per esempio example.com: senza https://, percorso o porta.

Condizioni d'uso dell'API e del server MCP

Invia Client-Name con ogni richiesta, indicando il gestore in modo veritiero. Client-Domain è consigliato.
Usa ASCII semplice, sotto i 100 caratteri per header. Entrambi sono autodichiarati e non sono credenziali: non danno accesso e non alzano i limiti di richieste. Non inserirvi mai chiavi, token, indirizzi email o dati dei tuoi utenti.
Possiamo rallentare o bloccare, senza preavviso, le richieste che non inviano Client-Name, che identificano il gestore in modo falso o che superano i limiti di richieste.
Un client che non permette di impostare header personalizzati, come il connettore di un assistente di chat che una persona aggiunge per uso proprio, è esentato. I client MCP che accettano header HTTP aggiuntivi e le chiamate dal browser devono inviarli.

Buono a sapersi

Gli importi sono in centesimi interi (*_cents) più un testo in formato it-IT che puoi mostrare così com'è, per esempio «12,48 € al kg».
Confronta i prodotti su unit_price_cents per il prezzo normalizzato per unità.
Ogni prodotto include un buy_url: mostralo come link di acquisto. È un link di affiliazione, quindi includi anche il affiliate_disclosure che lo accompagna.
Entrambi i canali hanno un limite di richieste per IP; non serve nessuna chiave.

Preferisci dare prima un'occhiata? Sfoglia le categorie.