Для розробників і ШІ

Відкриті інтерфейси: llms.txt, /ask, стрічки, карти сайту та файли для роботів

Читання
9 min
Кроків
3
Знімків
5
Оновлено
18 лист. 2026

Окрім MCP-сервера, портал пропонує й інші відкриті інтерфейси для мовних моделей, пошукових систем, читачів новин і розробників. Усі вони публічні, працюють без входу й надають ті самі дані, які бачить відвідувач сайту. Вміст — словацькою мовою.

llms.txt і llms-full.txt

Огляд і повний вміст порталу для мовних моделей
llms.txt

Файл https://rybarstvo.sk/llms.txt за пропозицією llmstxt.org: короткий опис порталу словацькою та англійською, примітки для агентів (вміст словацькою, обов’язковими є правила рибальства, умови біля води — модельна оцінка) і посилання в розділах «Карта та ділянки», «Басейни», «Риби та природа», «Посібники», «Довідка до порталу», «Змагання та спільнота», «Види риб», «Куди на риболовлю: районні центри» та Optional (правові сторінки, MCP-сервер, llms-full.txt, /ask, ARD, реєстр ділянок і карта сайту).

llms-full.txt

Файл https://rybarstvo.sk/llms-full.txt містить увесь основний вміст як чистий текст: риби та їх охорону, ділянки за басейнами й водотоками, організації SRZ, посібники, довідку до порталу та статті з блогу. Оновлюється після зміни даних або раз на день. Якщо файл саме генерується, а старішої версії ще немає, сервер поверне помилку 503 із проханням спробувати через хвилину.

Формат і доступ

Звичайний текст у UTF-8, вільно доступний і для скриптів на інших сайтах (CORS), з перевіркою змін через ETag.

Початок файлу llms.txt: опис порталу, примітки для агентів і перші посилання
Початок файлу llms.txt: опис порталу, примітки для агентів і перші посилання

Запитання звичайною мовою: /ask

Інтерфейс NLWeb: на вході запитання, на виході список сторінок

Адреса https://rybarstvo.sk/ask приймає запитання звичайною мовою й повертає список сторінок порталу, які на нього відповідають. Приклад: https://rybarstvo.sk/ask?query=pstruhové revíry pri Жиліна. Якщо в запитанні є районний центр, першими йдуть ділянки в радіусі 30 км від нього (словацькі слова pstruh, lipeň або kapor, тобто форель, харіус або короп, звужують тип води); якщо в ньому є назва риби, серед перших результатів буде сторінка виду.

Параметри інтерфейсу /ask
ПараметрЗначення
queryзапитання, не більше 300 знаків (обов’язковий параметр; якщо його немає, сервер поверне помилку з прикладом)
num_resultsкількість результатів 1–50, типово 10
streamingtrue повертає відповідь як потік подій (text/event-stream), false — як один JSON
query_idнеобов’язковий ідентифікатор запитання, повертається у відповіді
modeпідтримується лише список (list); інші режими повертають список із приміткою
Результат

Кожен результат має адресу, назву, короткий опис, рейтинг (score) та об’єкт schema.org: ділянка або водотік — як BodyOfWater з координатами та властивостями (тип ділянки, водотік, район, регіон, користувач, довжина, площа, глибина), решта — як WebPage.

Методи

GET і POST (параметри в адресі або в тілі JSON). Потік подій можна отримати й через заголовок Accept: text/event-stream.

Ліміт

60 запитань на хвилину з однієї IP-адреси; після цього сервер повертає помилку 429 і пропонує спробувати через хвилину.

Відповідь /ask на запитання «форелеві ділянки біля Жиліна»: ділянка з об’єктом BodyOfWater
Відповідь /ask на запитання «форелеві ділянки біля Жиліна»: ділянка з об’єктом BodyOfWater

Пошук з адресного рядка (OpenSearch)

Портал як пошукова система в браузері

Кожна сторінка посилається на опис https://rybarstvo.sk/opensearch.xml. Браузери, які підтримують цей стандарт, після відвідування запропонують портал серед пошукових систем (у налаштуваннях пошуку браузера), і тоді можна шукати прямо з адресного рядка. Результати відкриються на сторінці результатів пошуку порталу.

Підказки під час введення

Адреса /opensearch-suggest?q=… повертає не більше 8 підказок (назва, опис і адреса) з того самого пошуку, що й лупа на сайті; підказки з’являються від 2 знаків.

Шаблон пошуку

https://rybarstvo.sk/?s={searchTerms}; працює й без скриптів.

Стрічки, WebSub і підписка у федиверсі

RSS, Atom, JSON Feed і обліковий запис @rybarstvo@rybarstvo.sk
RSS та Атом

Статті з блогу за адресами https://rybarstvo.sk/feed/ (RSS 2,0) і https://rybarstvo.sk/feed/atom/ (Atom). Їх можна додати до будь-якого читача новин.

JSON Feed

https://rybarstvo.sk/feed.json у форматі JSON Feed 1,1: останні 30 статей із повним текстом, анотацією, датою, зображенням і рубриками. Кожна сторінка посилається на нього в заголовку.

WebSub

У стрічках зазначено хаб WebSub. Невдовзі після публікації статті портал сповіщає хаб, тож читачі новин і пошукові системи отримують статтю одразу, без повторного завантаження стрічки.

ActivityPub (федиверс)

За обліковим записом @rybarstvo@rybarstvo.sk можна стежити з Mastodon та інших мереж федиверсу. Нові статті з блогу надходять підписникам як дописи з посиланням на сайт; підписка приймається автоматично, і скасувати її можна будь-коли. У профілі є посилання на сайт і карту ділянок.

Bluesky

На Bluesky портал має доменне ім’я @rybarstvo.sk, підтверджене файлом на сайті.

Як стежити за Rybárstvo.sk із MastodonКроків: 3

  1. Відкрийте пошук у Mastodon

    Або в іншому застосунку федиверсу, яким ви користуєтеся.

  2. Введіть повне ім’я облікового запису

    @rybarstvo@rybarstvo.sk і відкрийте знайдений профіль Rybárstvo.sk.

  3. Торкніться «Стежити»

    Підписку буде прийнято автоматично. Відтепер нові статті з блогу з’являтимуться у вашій стрічці.

Початок JSON Feed: назва, адреса, мова, хаб WebSub і перша стаття
Початок JSON Feed: назва, адреса, мова, хаб WebSub і перша стаття

Карти сайту та правила для роботів

Де роботи знайдуть усі сторінки і що їм не слід обходити
Головна карта сайту

https://rybarstvo.sk/wp-sitemap.xml — це індекс усіх карт сайту.

Карти сайту за мовами

Кожна мова має власний індекс /wp-sitemap-ryb-{jazyk}.xml (наприклад, wp-sitemap-ryb-en.xml), який можна окремо надіслати в інструменти пошукових систем. У ньому є карти сайту за типом: головні сторінки, ділянки, водотоки, басейни, водосховища, організації, міста, області, риби, посібники, довідка, природа, відкриття, забруднення, блог та інше.

Улови, рибалки та змагання

Схвалені улови, публічні профілі рибалок і змагання мають власні карти сайту; улови та профілі рибалок — також іншими мовами.

ІндексНов

Про нові та змінені сторінки (стаття, зміна ділянки, опубліковане змагання, схвалений улов) портал невдовзі після зміни, зазвичай протягом хвилини, повідомляє пошуковим системам, підключеним до протоколу IndexNow, наприклад Bing і Seznam. Про сторінки з вказівкою не індексувати портал не повідомляє.

Інші мови

Словацька карта сайту містить усі публічні сторінки. Іншими мовами в них є лише типи сторінок, уже готові цією мовою, і немає сторінок із низькою часткою перекладу (вони мають вказівку не індексувати).

robots.txt

Дозволяє весь сайт, крім адмінпанелі WordPress, сторінки входу та форми улову з параметрами в адресі. Містить сигнал щодо вмісту search=yes, ai-input=yes, ai-train=yes, усі індекси карт сайту, а для пошукової системи Yandex — список параметрів відстеження, які слід ігнорувати.

Машинні файли

Файли для роботів і агентів (картки, стрічка JSON, підказки пошуку) мають вказівку не індексувати, щоб вони не з’являлися в результатах пошуку замість сторінок. llms.txt і llms-full.txt індексувати можна.

Файл robots.txt: правила, сигнал щодо вмісту й карти сайту всіма мовами
Файл robots.txt: правила, сигнал щодо вмісту й карти сайту всіма мовами

Файли за загальновідомими адресами

Безпека, паролі, приватність, ідентичність і автори
Файли за загальновідомими адресами
АдресаДля чого це потрібно
/.well-known/security.txtконтакт для повідомлення про вразливість (RFC 9116); /security.txt переспрямовує на нього
/.well-known/change-passwordменеджер паролів відкриє зміну пароля в профілі
/.well-known/passkey-endpointsменеджер паролів знайде, де додавати ключі доступу й керувати ними
/.well-known/gpc.jsonсайт дотримується сигналу Global Privacy Control
/.well-known/traffic-adviceдозвіл на приватне попереднє завантаження сторінок у Chrome
/.well-known/tdmrep.jsonбез застереження щодо інтелектуального аналізу тексту й даних (TDMRep)
/.well-known/did.jsonідентичність сайту did:web:rybarstvo.sk з відкритим ключем і сервісами (сайт, MCP-сервер)
/.well-known/atproto-didпідтвердження доменного імені @rybarstvo.sk у Bluesky
/.well-known/webfinger, host-meta, nodeinfoпошук облікового запису @rybarstvo@rybarstvo.sk у федиверсі
/.well-known/ard.json, ai-catalog.json, mcp/server-card.jsonсписок ресурсів для агентів і картка MCP-сервера
/humans.txtхто керує порталом і розробляє його та які відкриті дані він використовує
/ads.txtавторизовані продавці реклами

Вразливості безпеки

Якщо ви знайшли вразливість, напишіть на контакт із файлу security.txt ще до її оприлюднення й дайте розумний час на виправлення (зазвичай до 30 днів). Не тестуйте чужі облікові записи чи дані й не запускайте навантажувальні тести.

Файл humans.txt: оператор, подяки, джерела даних і мови
Файл humans.txt: оператор, подяки, джерела даних і мови

Дані та ліцензії

Реєстр ділянок у форматі JSON і що можна робити з даними
Реєстр ділянок (JSON)

https://rybarstvo.sk/wp-json/rybar/v1/index повертає всі басейни, водотоки та ділянки з розташуванням і властивостями в одному файлі JSON. Це той самий список, з яким працює карта.

Вбудовування посилання (oEmbed)

Сторінки порталу підтримують oEmbed, тож застосунки, які його розпізнають, показують попередній перегляд за посиланням; це працює й для адрес іншими мовами.

Дані з відкритих джерел

Використовуються відповідно до ліцензій своїх джерел, наприклад набір даних «Rybárske revíry» з data.slovensko.sk (CC BY 4.0) або карта OpenStreetMap (ODbL). Повний список джерел наведено на сторінці Методологія та джерела даних.

Вміст порталу

Тексти, розрахунки та база даних порталу захищені авторським правом. Для особистих некомерційних цілей їх можна використовувати й цитувати у звичайному обсязі із зазначенням джерела та посиланням на портал; масове запозичення чи комерційне використання потребує згоди оператора, крім даних, які їхні джерела надають за вільною ліцензією. Докладніше — в Умовах користування.

Інтелектуальний аналіз тексту та ШІ

У файлі tdmrep.json і в заголовках сторінок портал не зазначає застереження щодо інтелектуального аналізу тексту й даних; robots.txt містить сигнал search=yes, ai-input=yes, ai-train=yes.

Часті запитання

Запитань із короткою відповіддю: 6
Запитань6
Яка різниця між llms.txt і MCP-сервером?

llms.txt — це статичний огляд із посиланнями, який модель просто читає. MCP-сервер відповідає на конкретні запитання за допомогою інструментів (ділянки поблизу, період заборони, умови). Див. MCP-сервер.

Чи можна використовувати дані порталу у своєму застосунку?

Дані з відкритих джерел — відповідно до їхніх ліцензій. Для особистих і некомерційних цілей вміст можна цитувати із зазначенням джерела та посиланням; масове чи комерційне використання погодьте з оператором порталу.

Як часто оновлюється llms-full.txt?

Після зміни даних або версії порталу, а в іншому разі — раз на день.

Чи відповідає /ask повним реченням?

Ні. Він повертає список сторінок із коротким описом і даними schema.org, а відповідь із них складає ваш асистент.

Де знайти RSS?

За адресою https://rybarstvo.sk/feed/ (Atom — /feed/atom/, JSON Feed — /feed.json).

Чому в карті сайту іншою мовою є не всі сторінки?

До карт сайту іншими мовами потрапляють лише сторінки, достатньо перекладені відповідною мовою. Решта має вказівку не індексувати.

Пов’язані посібники

Що читати далі

Довідку оновлено 18 лист. 2026.