нишка_

ЗА РАЗРАБОТЧИЦИ

ОТКРИТ СЛОЙ · MCP · OPENAPI

Проверени граждански данни, готови за агенти.

Откритият слой на Нишка дава на системите с изкуствен интелект същото, на което стъпва и асистентът: проверени факти за обществените услуги, законови срокове и официални документи. Всеки отговор носи официален източник и дата, за да може агентът да го цитира, вместо да предполага. Без регистрация и без ключ.

Свържете агент

Добавете адреса като отдалечен MCP сървър (Streamable HTTP) в асистент или среда, които поддържат MCP.

https://nishka.app/mcp

Например в Claude Code:

claude mcp add --transport http nishka https://nishka.app/mcp

В конфигурационен файл:

{ "mcpServers": { "nishka": { "type": "http", "url": "https://nishka.app/mcp" } } }

Сървърът е без състояние: всяка заявка е отделен POST и получава един JSON отговор. Поддържа MCP 2026-07-28 (без начално ръкостискане) и 2025-11-25, 2025-06-18, 2025-03-26 (с initialize).

Инструменти

  • search_osnovaТърсене в Основа: институции, услуги, процедури и такси, с източник и дата на проверка.
  • get_osnova_entryЕдин запис от Основа по идентификатор, с всички факти.
  • about_osnovaКакво обхваща Основа: градове, брой записи, лиценз, последна проверка.
  • srok_deadlineПоследният ден на срок и всяка стъпка от изчислението, с правилото.
  • srok_dayРаботен ли е денят в България и ако не е, защо.
  • srok_yearПочивните делнични дни и работните съботи за година, с основанието.
  • search_izvorТърсене в официалните източници: заглавие, издател, номер, дата и официален адрес.
  • get_izvor_documentЕдин документ от Извор с началото на текста.
  • about_izvorКои източници обхваща Извор и кога са събирани за последно.

Всички инструменти само четат и връщат едно и също за една и съща заявка. Отговорът е текст за цитиране и същите данни структурирано (structuredContent, описано с outputSchema).

Ресурси и готови заявки

  • osnova://entry/{id} – запис от Основа с всички факти, източници и дати на проверка.
  • izvor://document/{id} – документ от Извор с официалния адрес и началото на текста.
  • civic_question – граждански въпрос с отговор от проверени източници.
  • deadline_from_letter – последният ден за действие след получено писмо.

REST API

Същите данни и без MCP. Описанието е в OpenAPI 3.1; отговорите са JSON.

  • /openapi.jsonВсички адреси, параметри и схеми.
  • ОсноваПроверени факти за институции, услуги, процедури и такси в Пловдив, София, Варна и Бургас.
  • СрокРаботни и почивни дни в България и изчисляване на срокове по ГПК чл. 60, с основание за всяка стъпка.
  • ИзворИндекс на първични официални източници: Държавен вестник, решения на общински съвети, обществени поръчки.
GET https://nishka.app/osnova/v0/entries?q=лична карта&city=plovdiv
GET https://nishka.app/srok/v0/deadline?from=2026-10-27&amount=14&unit=days
GET https://nishka.app/izvor/v0/search?q=бюджет&from=2026-01-01

Как да цитирате

Всеки успешен отговор има списък citations. Цитирайте адреса на официалния източник (url) и датата: на проверка (checkedOn) или на документа (publishedOn). Когато няма намерен запис, агентът трябва да го каже и да насочи към институцията, а не да предполага контакти, такси или срокове.

{
  "id": "izvor:dv:…",
  "title": "…",
  "url": "https://…",
  "publisher": "…",
  "publishedOn": "2026-10-15",
  "checkedOn": "2026-10-27",
  "licence": "official-record",
  "record": "https://nishka.app/izvor/v0/documents/…"
}

Лицензи

  • Основа: CC BY 4.0. Посочете „Основа, проверени данни на Нишка (nishka.app), CC BY 4.0“ и източника на всеки факт.
  • Извор и Срок сочат официални документи и закони; меродавен е официалният текст на посочения адрес. Актовете на държавните органи не са обект на авторско право (ЗАПСП, чл. 4, т. 1).

Ограничения

  • Засега няма ключове и квоти. Моля, пазете отговорите в кеш: данните се обновяват най-много веднъж дневно, а отговорите казват колко дълго са валидни.
  • Данните са предимно на български. Търсете на български.
  • Извор понякога е временно недостъпен; тогава инструментите му казват това, а Основа и Срок продължават да работят.
  • Нищо тук не е правен съвет. Преди важна стъпка проверете официалния източник.

За откриване от агенти