Inizio / Dati e interfacce

Dati e interfacce

Tutto ciò che si trova su schwur.ch è utilizzabile anche dalle macchine – per ricerche, analisi e strumenti propri. Dietro c’è lo stesso indice usato dalla ricerca.

Integrare in Claude o ChatGPT (MCP)

Tramite il Model Context Protocol (MCP) un assistente IA può cercare direttamente su schwur.ch e leggere le pagine trovate. L’indirizzo del server:

https://schwur.ch/mcp

Streamable HTTP · senza accesso · solo lettura

In Claude

1. Aprire Settings → Connectors.
2. Scegliere «Add custom connector».
3. Incollare l’indirizzo qui sopra e salvare.

In ChatGPT

1. Aprire Settings → Connectors e attivare la modalità sviluppatore (developer mode).
2. Aggiungere un connettore con l’indirizzo qui sopra.

A seconda della lingua dell’app, i menu possono chiamarsi in modo leggermente diverso.

I due strumenti

• search cerca in tutte le pagine pubbliche. Riceve una richiesta di ricerca, facoltativamente un elenco di tipi e una lingua, e restituisce identificativi, titoli e link.
• fetch legge una pagina tramite il suo identificativo ottenuto dalla ricerca, ad esempio business:24.073 o canton:ge, e restituisce il testo della pagina, la sua fonte e il link.

Una domanda di esempio: Come ha votato il Consiglio nazionale sul finanziamento della 13a rendita AVS?

API di ricerca

Un’interfaccia JSON aperta, senza accesso e senza chiave.

GET /api/v1/search

La ricerca. Ogni risultato ha titolo, estratto, data, il link alla pagina (url), la provenienza della sua lingua (origin) e la sua fonte (source).

• q – la richiesta di ricerca, fino a 200 caratteri
• lang – la lingua: de, fr, it, en o uk (predefinita: de)
• kind – il tipo di risultati, anche più volte
• group – un ambito invece del tipo: proposals, parliament, federal, news o places
• limit – il numero di risultati, al massimo 50
• cursor – per i risultati successivi: next_cursor della risposta precedente

/api/v1/search/suggest

fino a 8 titoli come suggerimenti, da 2 caratteri

/api/v1/search/kinds

tutti i tipi di risultati, con nome e descrizione

/api/v1/openapi.json

la descrizione completa dell’interfaccia (OpenAPI)

Esempio: il primo risultato per «AHV», in francese

curl 'https://schwur.ch/api/v1/search?q=AHV&lang=fr&limit=1'

Per i modelli linguistici

/llms.txt riassume per i modelli linguistici che cos’è schwur.ch, come effettuarvi ricerche e come citarlo – in inglese, secondo la convenzione llms.txt.

Condizioni di riutilizzo

Il riutilizzo è libero, a condizione di citare schwur.ch e la fonte originale.

• Collegare ogni affermazione alla pagina da cui proviene – il campo url di un risultato.
• Citare schwur.ch e la fonte originale indicata nel campo source.
• Il campo origin indica se un testo è l’originale, una traduzione ufficiale, una traduzione fatta per schwur.ch o il testo tedesco che sostituisce una traduzione mancante. Quando si cita una traduzione, va segnalato.
• I riassunti d’opinione del podcast «Bern einfach» sono disponibili solo con titolo e link: il Nebelspalter ha acconsentito alla loro pubblicazione su schwur.ch – non alla loro trasmissione a terzi.

Per il resto valgono le Regole d’uso.

Limiti

• Al massimo 60 ricerche al minuto per client; oltre, l’interfaccia risponde con 429 e Retry-After.
• Si prega di memorizzare le risposte nella cache. L’indice viene ricostruito ogni due ore; ogni risposta ne indica il momento (index_built_at).
• Non sono disponibili le relazioni d’interesse e i badge d’accesso (visibili solo agli account connessi), i contributi alle discussioni, le bozze e le notizie trattenute.
• Le ricerche non vengono salvate.