Машинный слой

без ключей · read-only вашему агенту — сюда

Всё, что есть на сайте, читается программно и без скрейпинга. Ответы приходят со ссылкой на источник: каждое утверждение можно открыть и проверить глазами.

Адреса

machine-readablePOST shkrbkv.ru/api/mcp
# MCP поверх HTTP, JSON-RPC. Семь инструментов, ниже.

GET shkrbkv.ru/api/index.json
# индекс корпуса: статьи, разобранные на абзацы,
# у каждого — адрес, по которому его видно на странице.

GET shkrbkv.ru/llms-full.txt
# то же самое прозой, если агенту проще так.

POST shkrbkv.ru/api/a2a
# A2A 1.0 — поговорить с агентом, а не прочитать данные.

GET shkrbkv.ru/.well-known/agent-card.json
# карточка агента: с неё начинает клиент A2A.

Инструменты

Инструмент	Что возвращает
`list_texts`	реестр статей: slug, заголовок, дата, адрес, минуты, теги
`get_text`	полный текст статьи по slug и её абзацы с адресами
`search`	поиск по абзацам, каждый результат с `source_url`
`now`	состояние корпуса: дата сборки, число текстов
`contact`	каналы связи и правила обращения
`speaker_kit`	био, темы, ассеты, границы использования
`shelf`	полка книг с оценками и вердиктами

Как позвать

examplecurl -s https://shkrbkv.ru/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search",
                 "arguments":{"query":"маркетплейс","limit":3}}}'

Поговорить с агентом: A2A

Инструменты выше отдают данные — читать их и складывать ответ придётся вашему агенту. Если нужен разговор, а не выгрузка, есть A2A 1.0: мой агент отвечает сам, своим голосом, и там, где сведений в материалах нет, отказывается отвечать вместо того, чтобы додумать.

Начните с карточки — /.well-known/agent-card.json. Биндинг JSON-RPC, ответ приходит задачей (TASK_STATE_COMPLETED) с текстом в артефакте.

examplecurl -s https://shkrbkv.ru/api/a2a \
  -H 'content-type: application/json' \
  -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage",
       "params":{"message":{"messageId":"1","role":"ROLE_USER",
                 "parts":[{"text":"когда он работал в 1С?"}]}}}'

Чего нет намеренно: потока (SendStreamingMessage), push-уведомлений и продолжения разговора — каждый вызов самостоятелен. Нет и ListTasks: ручка работает без ключей, а значит список задач раздавал бы чужие вопросы всякому спросившему. Заголовок A2A-Version обязателен: без него спецификация велит считать запрос версией 0.3, на которой я не говорю, и вы получите честный -32009, а не ответ не на том языке.

Что обещано и что нет

Инструменты только читают: побочных эффектов нет ни у одного, ключи не нужны. В каждом ответе есть schema_version — если он изменится, изменится и он.

Частота ограничена шестьюдесятью запросами в минуту на адрес. Превышение получает честный 429, а не молчание.

Наружу отдаётся только то, что и так открыто на страницах. Черновиков, личных заметок и контактов сверх заявленных здесь нет — и не появится: разграничение стоит в загрузчике данных, а не в каждом инструменте.

отвечает сервер · данные автора

Людям обычно интереснее тексты или о себе. Спросить голосом — у агента в правом поле любой страницы.