Головна / Дані та інтерфейси

Дані та інтерфейси

Усе, що є на schwur.ch, можуть використовувати й машини – для досліджень, аналізу та власних інструментів. За цим стоїть той самий індекс, яким користується пошук.

Підключити до Claude або ChatGPT (MCP)

Через Model Context Protocol (MCP) ШІ-асистент може сам шукати на schwur.ch і читати знайдені сторінки. Адреса сервера:

https://schwur.ch/mcp

Streamable HTTP · без входу · лише читання

У Claude

Відкрийте Settings → Connectors.
Виберіть «Add custom connector».
Вставте адресу вище й збережіть.

У ChatGPT

Відкрийте Settings → Connectors і ввімкніть режим розробника (developer mode).
Додайте конектор з адресою вище.

Залежно від мови застосунку меню можуть називатися трохи інакше.

Два інструменти

search шукає на всіх публічних сторінках. Приймає пошуковий запит, за бажанням – список типів і мову, і повертає ідентифікатори, заголовки та посилання.
fetch читає сторінку за її ідентифікатором із пошуку, наприклад business:24.073 або canton:ge, і повертає текст сторінки, її джерело та посилання.

Запитайте, наприклад: Як Національна рада голосувала щодо фінансування 13-ї пенсії AHV?

Пошуковий API

Відкритий JSON-інтерфейс, без входу й без ключа.

GET /api/v1/search

Пошук. Кожен результат має заголовок, уривок, дату, посилання на сторінку (url), походження мови тексту (origin) і джерело (source).

q – пошуковий запит, до 200 символів
lang – мова: de, fr, it, en або uk (типово: de)
kind – тип результатів, можна кілька разів
group – розділ замість типу: proposals, parliament, federal, news або places
limit – кількість результатів, не більше 50
cursor – для наступних результатів: next_cursor з попередньої відповіді

/api/v1/search/suggest

до 8 заголовків як підказки, від 2 символів

/api/v1/search/kinds

усі типи результатів, з назвою та описом

/api/v1/openapi.json

повний опис інтерфейсу (OpenAPI)

Приклад: перший результат для «AHV» французькою

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

Для мовних моделей

/llms.txt коротко пояснює мовним моделям, що таке schwur.ch, як у ньому шукати і як його цитувати – англійською, за конвенцією llms.txt.

Умови повторного використання

Повторне використання вільне за умови, що зазначено schwur.ch і першоджерело.

Посилайтеся в кожному твердженні на сторінку, з якої воно походить, – поле url результату.
Зазначайте schwur.ch і першоджерело, вказане в полі source.
Поле origin показує, чи текст є оригіналом, офіційним перекладом, перекладом, зробленим для schwur.ch, чи німецьким текстом замість відсутнього перекладу. Цитуючи переклад, зазначайте це.
Резюме думок із подкасту «Bern einfach» доступні лише із заголовком і посиланням: Nebelspalter погодився на їх показ на schwur.ch, а не на їх подальше поширення.

В іншому діють Правила користування.

Обмеження

Не більше 60 пошуків на хвилину з одного клієнта; понад це інтерфейс відповідає кодом 429 із заголовком Retry-After.
Будь ласка, кешуйте відповіді. Індекс перебудовується кожні дві години; кожна відповідь вказує, коли саме (index_built_at).
Недоступні записи в реєстрі інтересів і перепусток (їх бачать лише облікові записи, які увійшли в систему), дописи в обговореннях, чернетки й затримані повідомлення.
Пошукові запити не зберігаються.