Accueil / Données et interfaces

Données et interfaces

Tout ce qui figure sur schwur.ch peut aussi être utilisé par des machines – pour des recherches, des analyses et vos propres outils. Derrière se trouve le même index que celui de la recherche.

Intégrer dans Claude ou ChatGPT (MCP)

Grâce au Model Context Protocol (MCP), un assistant d’IA peut chercher lui-même sur schwur.ch et lire les pages trouvées. L’adresse du serveur :

https://schwur.ch/mcp

Streamable HTTP · sans connexion · lecture seule

Dans Claude

1. Ouvrez Settings → Connectors.
2. Choisissez « Add custom connector ».
3. Collez l’adresse ci-dessus et enregistrez.

Dans ChatGPT

1. Ouvrez Settings → Connectors et activez le mode développeur (developer mode).
2. Ajoutez un connecteur avec l’adresse ci-dessus.

Selon la langue de l’application, les menus peuvent porter des noms légèrement différents.

Les deux outils

• search cherche dans toutes les pages publiques. Il reçoit une requête, au choix une liste de types et une langue, et renvoie des identifiants, des titres et des liens.
• fetch lit une page à partir de son identifiant tiré de la recherche, par exemple business:24.073 ou canton:ge, et renvoie le texte de la page, sa source et le lien.

Demandez par exemple : Comment le Conseil national a-t-il voté sur le financement de la 13e rente AVS ?

API de recherche

Une interface JSON ouverte, sans connexion ni clé.

GET /api/v1/search

La recherche. Chaque résultat comporte un titre, un extrait, une date, le lien vers la page (url), l’origine de sa langue (origin) et sa source (source).

• q – la requête, jusqu’à 200 caractères
• lang – la langue : de, fr, it, en ou uk (par défaut : de)
• kind – le type de résultats, répétable
• group – un domaine au lieu d’un type : proposals, parliament, federal, news ou places
• limit – le nombre de résultats, 50 au plus
• cursor – pour les résultats suivants : next_cursor de la réponse précédente

/api/v1/search/suggest

jusqu’à 8 titres proposés, dès 2 caractères

/api/v1/search/kinds

tous les types de résultats, avec leur nom et une description

/api/v1/openapi.json

la description complète de l’interface (OpenAPI)

Exemple : le premier résultat pour « AHV », en français

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

Pour les modèles de langage

/llms.txt résume pour les modèles de langage ce qu’est schwur.ch, comment y chercher et comment le citer – en anglais, selon la convention llms.txt.

Conditions de réutilisation

La réutilisation est libre, à condition de citer schwur.ch et la source originale.

• Liez chaque affirmation à la page dont elle provient – le champ url d’un résultat.
• Citez schwur.ch et la source originale indiquée dans le champ source.
• Le champ origin indique si un texte est l’original, une traduction officielle, une traduction faite pour schwur.ch ou le texte allemand qui remplace une traduction manquante. Signalez-le lorsque vous citez une traduction.
• Les résumés d’opinion du podcast « Bern einfach » ne sont disponibles qu’avec titre et lien : le Nebelspalter a accepté qu’ils paraissent sur schwur.ch – pas qu’ils soient transmis.

Pour le reste, les Règles d’utilisation s’appliquent.

Limites

• 60 recherches par minute et par client au plus ; au-delà, l’interface répond par 429 avec Retry-After.
• Merci de mettre les réponses en cache. L’index est reconstruit toutes les deux heures ; chaque réponse en indique le moment (index_built_at).
• Ne sont pas disponibles : les liens d’intérêts et les badges d’accès (visibles seulement pour les comptes connectés), les contributions aux discussions, les brouillons et les nouvelles retenues.
• Les recherches ne sont pas enregistrées.