Ospitario per partner, sviluppatori e agenti IA

Descrizione breve

Ospitario aiuta i gestori indipendenti di case vacanza a offrire una scheda pubblica della struttura, a dimostrare la propria identità o il proprio diritto nei limiti previsti e a rendere accessibili i contatti diretti che scelgono di pubblicare. Senza commissioni.

Descrizione estesa

Ospitario è un registro di case vacanza in Italia, Germania, Spagna, Francia e Portogallo, oggi in fase pilota in Puglia. Ogni struttura ha una scheda: una pagina pubblica con i dati essenziali, il livello di verifica raggiunto e la data da cui vale. Il gestore dimostra ciò che può dimostrare, per esempio il controllo del proprio annuncio o il diritto di gestire la struttura; la pagina indica esattamente quel livello. Gli ospiti scrivono direttamente al gestore attraverso i contatti che lui sceglie di pubblicare. Ospitario non prende commissioni e non gestisce prenotazioni né pagamenti. La scheda è leggibile anche da motori di ricerca e assistenti IA, tramite dati strutturati, un’interfaccia REST e MCP. Registrarsi è gratis durante il pilota.

Testo per i social

Affitti una casa vacanza e vuoi che gli ospiti ti scrivano direttamente, senza commissioni? Ospitario dà alla tua struttura una scheda pubblica con il livello verificato e i tuoi contatti. Gratis durante il pilota. https://ospitario.com/

Testo per la newsletter

Novità per chi gestisce case vacanza: Ospitario. Ogni struttura riceve una scheda pubblica con i dati essenziali, il livello che il gestore ha dimostrato e i suoi contatti diretti. Gli ospiti scrivono direttamente, senza piattaforme in mezzo e senza commissioni. Ospitario non gestisce prenotazioni né pagamenti. La registrazione è gratuita durante il pilota: https://ospitario.com/

Esempio di post per una community di host

Ciao a tutti, qualcuno conosce Ospitario? È un registro di case vacanza senza commissioni. Si crea una scheda per la propria struttura e si dimostra ciò che si può, per esempio di controllare il proprio annuncio; la pagina mostra esattamente quel livello. Gli ospiti scrivono direttamente. Gratis durante il pilota: https://ospitario.com/

Screenshot

La pagina iniziale (in italiano, 8 novembre 2026). Nessuna pagina di un gestore, nessun logo di piattaforme di prenotazione.

Pagina iniziale su schermo, PNGPagina iniziale su smartphone, PNG

Livelli nella risposta

Il campo verification.tier indica il livello più alto raggiunto, verification.date da quando. I testi sono gli stessi delle schede:

L0

Scheda non rivendicata dal gestore. Informazioni ricavate da fonti pubbliche; identità del gestore non verificata.

L2 · Annuncio verificato

Il gestore ha dimostrato di controllare l’annuncio sulla piattaforma (link del calendario, email della piattaforma o channel manager). Per le verifiche dal 7 novembre 2026 una persona ha controllato anche i documenti sul diritto di gestire la struttura.

L2c · Calendario verificato

Il gestore ha bloccato entro 48 ore, nel calendario della piattaforma, una data scelta a caso da Ospitario: gestisce quel calendario. Metodo non più usato per nuove verifiche dal 7 novembre 2026.

LA · Diritto di gestione verificato (revisione dei documenti)

Ospitario ha controllato documenti che collegano il gestore a questa struttura (registrazione, atto, contratto, mandato o visura). Una persona li ha trovati coerenti; senza SPID/CIE non prova chi usa l’account.

L3 · Titolare verificato

L’identità SPID/CIE del gestore corrisponde al titolare del CIN nel registro nazionale.

L4 · Documento verificato (controllo automatico)

Un documento di proprietà, locazione o mandato è coerente con l’identità del gestore e con la struttura (controllo automatico della coerenza, non dell’autenticità).

L5 · Verifica manuale

Una persona di Ospitario ha controllato il documento che autorizza il gestore ad affittare questa casa.

L1 non è un livello a sé nella risposta: se il numero di registrazione (in Italia il CIN) ha il formato giusto e compare nel registro ufficiale lo dice il campo registration.

Quali dati

• Pubblici: nome, comune, tipo, capienza, camere, dotazioni, lingue, numero di registrazione con lo stato del controllo, prezzo indicativo e, dove collegato, i giorni del calendario.
• Contatti solo se il gestore li pubblica (telefono, WhatsApp, email, sito). Per una scheda non rivendicata (L0) solo il sito e la richiesta tramite Ospitario.
• Prezzi e calendario sono indicativi; si prenota presso il gestore.

REST

MCP

Le stesse funzioni come strumenti MCP su https://ospitario.com/mcp (Streamable HTTP): search_properties, lookup_by_url, lookup_by_name, get_passport, send_inquiry.

Una sessione inizia con initialize; la risposta porta l’header Mcp-Session-Id, da inviare in ogni chiamata successiva.

Nessun risultato ed errori

Nessun risultato non è un errore: la risposta ha stato 200 e lo dice esplicitamente. Un input non valido riceve 400 con i campi interessati. Ospitario non indovina e non completa nulla.

Esempi

curl "https://ospitario.com/api/v1/lookup/name?name=Casa%20Esempio&municipality=Lecce"

Estratto di una risposta con dati di esempio; tutti i campi: /openapi.json

{
  "results": [
    {
      "slug": "casa-esempio-lecce",
      "name": "Casa Esempio",
      "municipality": "Lecce",
      "type": "casa vacanza",
      "verification": {
        "tier": "L2",
        "label": "Listing verified",
        "date": "2026-11-01"
      },
      "contactPageUrl": "https://ospitario.com/p/casa-esempio-lecce?s=agent:unknown"
    }
  ]
}

curl "https://ospitario.com/api/v1/passport/not-a-passport"

{
  "found": false,
  "reason": "not_found"
}

curl "https://ospitario.com/api/v1/search?guests=0"

400 {
  "error": "invalid",
  "issues": [
    {
      "path": "guests",
      "message": "Invalid input"
    },
    {
      "path": "municipality",
      "message": "municipality or province required"
    }
  ]
}

curl -i -X POST https://ospitario.com/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1"}}}'

# then, with the Mcp-Session-Id header of that answer:
#   {"jsonrpc":"2.0","method":"notifications/initialized"}
#   {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"lookup_by_name","arguments":{"name":"Casa Esempio"}}}

Dove gli agenti trovano Ospitario

• /openapi.json · descrizione OpenAPI, il contratto vincolante
• /.well-known/ospitario.json · descrizione breve con indirizzo MCP, strumenti e limiti
• /llms.txt · introduzione in testo; integra, ma non sostituisce OpenAPI né MCP
• https://ospitario.com/mcp · MCP (Streamable HTTP)

I livelli

Annuncio verificato

Il gestore ha dimostrato di controllare l’annuncio sulla piattaforma (link del calendario, email della piattaforma o channel manager). Per le verifiche dal 7 novembre 2026 una persona ha controllato anche i documenti sul diritto di gestire la struttura.

Calendario verificato

Il gestore ha bloccato entro 48 ore, nel calendario della piattaforma, una data scelta a caso da Ospitario: gestisce quel calendario. Metodo non più usato per nuove verifiche dal 7 novembre 2026.

Diritto di gestione verificato (revisione dei documenti)

Ospitario ha controllato documenti che collegano il gestore a questa struttura (registrazione, atto, contratto, mandato o visura). Una persona li ha trovati coerenti; senza SPID/CIE non prova chi usa l’account.

Titolare verificato

L’identità SPID/CIE del gestore corrisponde al titolare del CIN nel registro nazionale.

Documento verificato (controllo automatico)

Un documento di proprietà, locazione o mandato è coerente con l’identità del gestore e con la struttura (controllo automatico della coerenza, non dell’autenticità).

Verifica manuale

Una persona di Ospitario ha controllato il documento che autorizza il gestore ad affittare questa casa.

Cosa non viene verificato

• qualità, pulizia e dotazioni sul posto
• che prezzi e calendario siano esatti
• che una prenotazione vada a buon fine
• le assicurazioni indicate dal gestore (compaiono come «dichiarate» sulla pagina)
• per L0, l’identità del gestore