TRX Spearguns API e MCP
TRX Spearguns espone in sola lettura i dati del sito: catalogo di fucili subacquei in carbonio e accessori con prezzi in euro, specifiche tecniche, articoli del blog e dati aziendali. I dati sono gli stessi mostrati nelle pagine del sito. Gli ordini non si fanno via API: si inviano dal checkout e si pagano con bonifico.
Autenticazione
Nessuna. Tutti gli endpoint sono pubblici, in HTTPS, con CORS aperto.
Endpoint
Specifica completa OpenAPI 3.1: /openapi.json. Catalogo API (RFC 9727): /.well-known/api-catalog.
| Metodo | Path | Contenuto |
|---|---|---|
| GET | /api/v1/info | Restituisce nome, contatti, indirizzo, P.IVA, modalita' d'ordine e pagine principali di TRX Spearguns. |
| GET | /api/v1/products | Restituisce il catalogo completo (fucili e accessori) con prezzo in euro, specifiche e link alla scheda. Filtrabile per categoria. |
| GET | /api/v1/products/{id} | Restituisce un singolo prodotto dato il suo id (es. trx-carbon-80). |
| GET | /api/v1/blog | Restituisce gli articoli del blog (guide sulla pesca in apnea e sulla scelta del fucile) con titolo, estratto, data e URL. |
Esempi
curl -s https://trxspearguns.com/api/v1/products?category=Arbalete
curl -s https://trxspearguns.com/api/v1/products/trx-carbon-100?lang=en
curl -s https://trxspearguns.com/api/v1/infoLimiti di frequenza
60 richieste ogni 60 secondi per indirizzo IP, contate per singola istanza edge. Ogni risposta include gli header IETF RateLimit-Policy e RateLimit (richieste rimanenti r, secondi al reset t). Oltre il limite la risposta è 429 con Retry-After.
Errori
Gli errori sotto /api/ sono in application/problem+json (RFC 9457) con i campi type, title, status, detail, code e resolution.
{"type":"https://trxspearguns.com/docs#errori","title":"Not Found","status":404,
"detail":"Nessun prodotto con id 'xyz'.","code":"product_not_found",
"resolution":"Recupera gli id validi da GET /api/v1/products."}Server MCP
Server Model Context Protocol su https://trxspearguns.com/mcp (Streamable HTTP, JSON-RPC 2.0 via POST, senza autenticazione). Tool in sola lettura: get_business_info, list_products, get_product, list_blog_posts. Risorse: trx://info, trx://products, trx://blog. Server card: /.well-known/mcp/server-card.json.
curl -s -X POST https://trxspearguns.com/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_product","arguments":{"id":"trx-carbon-80"}}}'Markdown per agenti
Ogni pagina pubblica si può chiedere in Markdown con l'header Accept: text/markdown oppure aggiungendo ?format=mdall'URL. Indice per LLM: /llms.txt. Mappa del sito: /sitemap.xml.
curl -s -H 'Accept: text/markdown' https://trxspearguns.com/productsContatti tecnici
Per segnalazioni sull'API scrivi a info@gibarsub.it o usa la pagina contatti.