Данные
Citoyen для ИИ-агентов и разработчиков
Цифры Citoyen могут читать не только люди на экране, но и ИИ-ассистенты и программы. Публичный сервер, работающий только на чтение, отдаёт им те же ряды, что и карточки, каждый с официальным производителем, периодом и единицей измерения, чтобы ответ мог указать, откуда взялась цифра.
Сервер MCP
Model Context Protocol (MCP) это стандарт, с помощью которого ассистенты вроде Claude или ChatGPT вызывают внешние инструменты. Сервер Citoyen бесплатный, не требует ключа или учётной записи и только читает: он не хранит заданные вопросы, а лишь считает вызовы, чтобы сервис оставался доступным.
Адрес сервера
https://citoyenapp.com/mcpКак подключить
В Claude
На claude.ai или в настольном приложении: Настройки, Коннекторы, Добавить свой коннектор, затем вставьте адрес сервера.
В других ассистентах
ChatGPT в режиме разработчика и другие ассистенты, принимающие удалённые серверы MCP: добавьте HTTP-коннектор с адресом сервера.
В редакторе кода
Cursor, VS Code, Claude Code и похожие инструменты: добавьте сервер в их конфигурацию MCP, как показано ниже.
Конфигурация для клиентов, читающих файл MCP:
{
"mcpServers": {
"citoyen": {
"type": "http",
"url": "https://citoyenapp.com/mcp"
}
}
}Инструменты
- search
- Находит показатели с их кодами, названные в вопросе страны и связанные публикации.
- get_series
- Ряд одного показателя для одной страны, как на его карточке: значения по периодам, единица, производитель и ссылка на источник. По умолчанию последние 10 лет.
- compare_countries
- Один показатель для 2–8 стран из одного гармонизированного источника, чтобы значения были сопоставимы.
- get_ranking
- Все охваченные страны, упорядоченные по одному показателю за последний общий период, от наибольшего значения к наименьшему.
- get_publication
- Ключевые положения аналитической записки, анализа или карточки реформы со ссылкой на полный текст.
- get_release_calendar
- Ближайшие публикации рядов: официальные даты производителя или оценочные интервалы.
Ограничения и правила
- 60 вызовов в минуту с одного адреса. Сверх этого сервер просит повторить попытку чуть позже.
- Ряды по умолчанию охватывают 10 лет (до 80 по запросу, не более 600 точек в ответе); сравнение охватывает от 2 до 8 стран.
- Ряды частных производителей и военные ряды, которые SIPRI публикует через Всемирный банк, дают только последнее значение и ссылку на карточку: их условия не позволяют передавать ряд целиком.
- Публикации дают ключевые положения и ссылку, но никогда полный текст.
- Значения, помеченные как прогнозные, это прогнозы, а не фактические данные.
- Каждый ответ называет производителя: ссылайтесь на него вместе со ссылкой на страницу Citoyen из ответа.
- Вызовы подсчитываются по дням под анонимным ключом, получаемым из IP-адреса и меняющимся каждый день; сам адрес никогда не сохраняется, а счётчики хранятся 30 дней.
Другие способы доступа
- Каждая страница показателя предлагает свой ряд в формате CSV: добавьте /data.csv к её адресу (кроме рядов частных производителей).
- Карта сайта в виде простого текста для ИИ-краулеров: /llms.txt
- Любую карточку можно встроить на другой сайт кнопкой « Встроить ».
Как ссылаться
Указывайте официального производителя, названного рядом с каждой цифрой, и Citoyen как место, где она прочитана, со ссылкой на страницу.
Подборки, проверки и тексты Citoyen защищены, систематическое извлечение его базы не допускается. Подробнее: Правовая информация
