API русского языка и MCP для агентов

Сведения базы можно получать программой: ударение, формы, значения, синонимы и антонимы русского слова — по одному слову за запрос, тем же ответом, что видит читатель на карточке. Для людей есть сайт, для программ — HTTP API, для ИИ-агентов — MCP-сервер с теми же данными и теми же лимитами.

Что даёт API и MCP

Адрес API — api.slovofond.ru, ключ передаётся заголовком X-Api-Key. MCP-сервер (Streamable HTTP, JSON-RPC) — api.slovofond.ru/mcp, ключ тот же. В MCP методы называются инструментами; ресурс lex://spravka/ogranicheniya показывает лимиты вашего ключа, lex://spravka/licenzii — лицензии источников.

Инструмент MCP	HTTP	Что отвечает
`udarenie`	`GET /v1/udarenie?slovo=`	ударение слова или формы: все варианты, основной, есть ли расхождение источников
`kartochka`	`GET /v1/kartochka?slovo=`	карточка: значения с пометами и примерами, происхождение, часть речи, частотность, источник каждого сведения
`formy`	`GET /v1/formy?slovo=`	все формы слова с грамматикой и ударением
`sinonimy, antonimy`	`GET /v1/sinonimy?slovo=, /v1/antonimy?slovo=`	синонимы и антонимы по значениям
`paronimy`	`GET /v1/paronimy?slovo=`	паронимы: «надеть» — «одеть», «адресат» — «адресант»
`pochemu_rashozhdenie`	`—`	почему словари расходятся в ударении и какое правило выбрало ответ (только MCP)
`lemma`	`—`	начальная форма и грамматика формы (только MCP)

Слова, которого в базе нет, API отвечает кодом 404 с подсказкой написания. Ответ содержит версию сборки базы: она обновляется по мере проверки сведений редакцией.

Пример запроса и ответа

Ударение слова «замок» — у омографа два варианта, и ответ говорит, какому значению какой принадлежит (ответ сокращён: толкования обрезаны, у «замо́к» опущено значение «замкомвзвода»):

curl -H 'X-Api-Key: ваш_ключ' 'https://api.slovofond.ru/v1/udarenie?slovo=замок'

{
  "slovo": "замок",
  "varianty": ["за́мок", "замо́к"],
  "osnovnoy": "за́мок",
  "rashozhdenie": false,
  "po_slovam": [
    {"udarenie": "за́мок", "slova": [{"slovo": "замок", "chast_rechi": "существительное",
                                     "smysl": "здание, обычно обнесённое стеной…"}]},
    {"udarenie": "замо́к", "slova": [{"slovo": "замок", "chast_rechi": "существительное",
                                     "smysl": "устройство для запирания чего-либо ключом"}]}
  ],
  "istochniki": "Викисловарь (CC BY-SA 4.0), RUAccent (MIT), ФИПИ",
  "versiya": "2026.10.29-101801"
}

Лимиты пробного ключа

Доступ рассчитан на приложение, которое спрашивает слова по мере надобности — проверка текста, подсказка ударения, словарная справка в чат-боте. Выгрузить базу целиком через API нельзя, и лимиты подобраны так, чтобы это было заметно дольше, чем имеет смысл.

Запросов в минуту	20
Разных слов в сутки (UTC)	200; повтор уже спрошенного слова не расходуется
Разных слов за 30 дней	2 000
Объём ответов за 24 часа	2 000 связанных объектов (значения, формы, сведения) и 2 МБ
Пакет MCP udarenie_paket	до 10 слов, каждое — в тех же квотах
Выгрузки, снимки, полный словник	недоступны
Срок ключа	90 дней, продление — по письму

Кроме лимитов ключа есть общий суточный предел на все внешние ключи вместе. Когда лимит исчерпан, API отвечает кодом 429 с заголовком Retry-After и полем kod, по которому видно, что именно кончилось. Обход словника по алфавиту или подряд без повторов приостанавливает ключ до разговора с редакцией.

Условия и лицензии

Сведения собраны из открытых источников и распространяются на условиях их лицензий. Большая часть — Викисловарь, OpenCorpora и YARN под лицензией CC BY-SA: указывайте источник и распространяйте производные данные под той же лицензией. Источник и лицензия каждого сведения карточки приходят в ответе, в поле atribuciya. Общий список источников — на странице «Откуда данные», остальные условия — в условиях пользования. Пробный ключ бесплатен; база не обещает доступности без перерывов и может менять лимиты, предупреждая владельцев ключей письмом.

Как получить ключ

Опишите, для чего нужен доступ. Заявку читает редакция; ключ приходит на почту, обычно в течение нескольких дней. Один ключ — на один проект. Вопросы об условиях — на почту редакции info@slovofond.ru.