Start / Daten & Schnittstellen

Daten & Schnittstellen

Alles, was auf schwur.ch steht, lässt sich auch maschinell nutzen – für Recherchen, Auswertungen und eigene Werkzeuge. Dahinter steht derselbe Index, den auch die Suche verwendet.

In Claude oder ChatGPT einbinden (MCP)

Über das Model Context Protocol (MCP) kann ein KI-Assistent schwur.ch selbst durchsuchen und die gefundenen Seiten lesen. Die Adresse des Servers:

https://schwur.ch/mcp

Streamable HTTP · ohne Anmeldung · nur lesend

In Claude

Öffne Settings → Connectors.
Wähle «Add custom connector».
Füge die Adresse oben ein und speichere.

In ChatGPT

Öffne Settings → Connectors und schalte den Entwicklermodus (developer mode) ein.
Füge einen Connector mit der Adresse oben hinzu.

Je nach Sprache der App heissen die Menüs etwas anders.

Die zwei Werkzeuge

search durchsucht alle öffentlichen Seiten. Es nimmt eine Suchanfrage, wahlweise eine Liste von Arten und eine Sprache, und liefert Kennungen, Titel und Links.
fetch liest eine Seite anhand ihrer Kennung aus der Suche, etwa business:24.073 oder canton:ge, und liefert den Text der Seite, ihre Quelle und den Link.

Frag zum Beispiel: Wie hat der Nationalrat zur Finanzierung der 13. AHV-Rente abgestimmt?

Such-API

Eine offene JSON-Schnittstelle, ohne Anmeldung und ohne Schlüssel.

GET /api/v1/search

Die Suche. Jeder Treffer hat Titel, Auszug, Datum, den Link zur Seite (url), die Herkunft seiner Sprache (origin) und seine Quelle (source).

q – die Suchanfrage, bis 200 Zeichen
lang – die Sprache: de, fr, it, en oder uk (Standard: de)
kind – die Art der Treffer, auch mehrfach
group – statt der Art ein Bereich: proposals, parliament, federal, news oder places
limit – die Anzahl Treffer, höchstens 50
cursor – für die nächsten Treffer: next_cursor aus der vorherigen Antwort

/api/v1/search/suggest

bis zu 8 Titel als Vorschläge, ab 2 Zeichen

/api/v1/search/kinds

alle Arten von Treffern, mit Namen und Beschreibung

/api/v1/openapi.json

die vollständige Beschreibung der Schnittstelle (OpenAPI)

Beispiel: der erste Treffer für «AHV», auf Französisch

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

Für Sprachmodelle

/llms.txt fasst für Sprachmodelle zusammen, was schwur.ch ist, wie man es durchsucht und wie man es zitiert – auf Englisch, nach der llms.txt-Konvention.

Nutzungsbedingungen

Die Weiterverwendung ist frei, sofern schwur.ch und die ursprüngliche Quelle genannt werden.

Verlinke jede Aussage auf die Seite, von der sie stammt – das Feld url eines Treffers.
Nenne schwur.ch und die ursprüngliche Quelle, die im Feld source steht.
Das Feld origin sagt, ob ein Text im Original steht, amtlich übersetzt ist, für schwur.ch übersetzt wurde oder auf Deutsch steht, weil die Übersetzung fehlt. Sag es dazu, wenn du eine Übersetzung zitierst.
Meinungszusammenfassungen des Podcasts «Bern einfach» gibt es nur mit Titel und Link: Der Nebelspalter hat zugestimmt, dass sie auf schwur.ch erscheinen – nicht, dass sie weitergegeben werden.

Im Übrigen gelten die Nutzungsregeln.

Grenzen

Höchstens 60 Suchen pro Minute und Client; darüber antwortet die Schnittstelle mit 429 und Retry-After.
Bitte speichere Antworten zwischen. Der Index wird alle zwei Stunden neu aufgebaut; jede Antwort nennt den Zeitpunkt (index_built_at).
Nicht verfügbar sind Interessenbindungen und Zutrittsausweise (nur für angemeldete Konten sichtbar), Diskussionsbeiträge, Entwürfe und zurückgehaltene Meldungen.
Suchanfragen werden nicht gespeichert.