Данные для ИИ-агента

Коннектор MCP предоставляет агенту доступ к данным Rustata. Инструкция для агента описывает выбор рядов и работу с кодами и единицами измерения.

Коннектор MCP

Подключается одним адресом https://rustata.ru/mcp: клиент сам регистрируется, вы входите по ссылке из письма и разрешаете доступ. Дальше помощник выбирает набор, находит код товара и забирает ряды без вашего участия. Подробно - на странице про коннектор: как подключить в чате, на телефоне и в редакторе, что он умеет, как отключить и что делать, если не работает.

Правила, изложенные ниже, коннектор отдаёт сам, ресурсами rustata://skill и rustata://reference. Ставить их отдельно не нужно: у подключившегося помощника они уже есть.

Ответы коннектора рассчитаны на то, что их читает модель, а не скрипт: одинаковое во всех строках вынесено в общий блок, и в строке остаются период и значение. Разница не косметическая - у дневного курса это 40 байт на точку вместо 96. Помощник берёт нужный период, а не историю целиком: достаточно сказать «с 2020 года», и лишнее не поедет ни в ответ, ни в вашу квоту. Когда данных всё равно больше, чем влезает в один ответ, коннектор говорит об этом прямо, а не выдаёт хвост за весь ряд.

Скилл: правила разбора

Набор правил и готовых команд, который агент читает перед тем, как обращаться к данным. Ставится в проект одной папкой и работает с Claude Code, Cursor и любым агентом, умеющим читать файлы проекта. Нужен там, где коннектор не подключить, и полезен рядом с ним: в нём есть разбор ловушек, а не только описание методов.

Схемы OpenAPI агенту мало

Схема говорит, какие параметры принимает метод. Она не говорит, что RU-77 это Чукотка, а не Москва; что «промышленность в целом» лежит отдельным рядом, а не собирается сложением разделов; что делить индекс на индекс нельзя.

Эти ошибки тихие: запрос проходит, ответ приходит, цифры выглядят правдоподобно. Скилл и есть те знания, которых в схеме нет.

Что меняется

Вопрос один и тот же: «что происходило с промышленным производством в июле, лучше или хуже июня?»

Без скилла

агент не нашёл сводный ряд и написал, что «сводного индекса в наборе нет»;
собрал вывод сложением четырёх разделов - у Росстата так не считают;
смешал в одном рейтинге годовые, месячные и накопленные показатели;
посчитал изменение индекса в процентах от индекса: «+141%» там, где было плюс полтора пункта;
шестнадцать запусков скрипта, около четырёх минут.

Со скиллом

головной ряд найден сразу: «Собирательная группировка "Промышленность"»;
ответ от общего к частному: итог, затем разделы, затем виды деятельности;
снятые с наблюдения ряды отброшены до расчётов;
индексы сравниваются в пунктах, показатели между собой не смешиваются;
одна команда, меньше секунды.

Со скиллом типовой разбор - одна команда

python .claude/skills/rustata-api/rustata.py movers fedstat/indicator_57806 geo=643 measure=YOY

fedstat/indicator_57806 | территория 643 | периодов 4 (2026-04-01..2026-07-01)
рядов 128 | выросло 47, снизилось 80 | медиана -1.90 п.п.
набор: fresh
ВНИМАНИЕ: значения - индексы (уже проценты), изменения показаны в пунктах

Что внутри

Файл	Что в нём
`SKILL.md`	правила разбора: от общего к частному, что из чего можно пересчитать, где тихие ошибки в кодах территорий, почему ровная линия не всегда поломка
`reference.md`	справочник: параметры методов, поля ответа, колонки CSV, лимиты, коды ошибок
`rustata.py`	клиент на стандартной библиотеке: токен, страницы, ошибки, готовые сводки `movers` и `regions`

Поставить скилл

Положите три файла в .claude/skills/rustata-api/ своего проекта и выдайте агенту токен через переменную окружения:

mkdir -p .claude/skills/rustata-api
cd .claude/skills/rustata-api
curl -O https://rustata.ru/api/agent/SKILL.md
curl -O https://rustata.ru/api/agent/reference.md
curl -O https://rustata.ru/api/agent/rustata.py

export RUSTATA_TOKEN=rst_ваш_токен

Токен берётся в личном кабинете и в код не попадает: клиент читает его из окружения. Дальше агенту достаточно сказать, что нужен разбор по нашим данным - правила он прочитает сам.

Скилл описывает наш API и ничего не знает о ваших данных. Он не отправляет никуда ничего, кроме запросов к rustata.ru/api/v1 с вашим токеном, и подчиняется тем же лимитам.

Скилл нужен и рядом с коннектором: он объясняет, как читать ответы и в каком порядке идти. Сами оговорки методики, связи наборов, лента обновлений и сетка классификаторов у коннектора теперь есть - инструментами methodology, related, classifier, units и updates, а единица и запрет сшивки приходят прямо в ответе со значениями.