Данные

Citoyen для ИИ-агентов и разработчиков

Цифры Citoyen могут читать не только люди на экране, но и ИИ-ассистенты и программы. Публичный сервер, работающий только на чтение, отдаёт им те же ряды, что и карточки, каждый с официальным производителем, периодом и единицей измерения, чтобы ответ мог указать, откуда взялась цифра.

Сервер MCP

Model Context Protocol (MCP) это стандарт, с помощью которого ассистенты вроде Claude или ChatGPT вызывают внешние инструменты. Сервер Citoyen бесплатный, не требует ключа или учётной записи и только читает: он не хранит заданные вопросы, а лишь считает вызовы, чтобы сервис оставался доступным.

Адрес сервера

https://citoyenapp.com/mcp

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

  1. В Claude

    На claude.ai или в настольном приложении: Настройки, Коннекторы, Добавить свой коннектор, затем вставьте адрес сервера.

  2. В других ассистентах

    ChatGPT в режиме разработчика и другие ассистенты, принимающие удалённые серверы MCP: добавьте HTTP-коннектор с адресом сервера.

  3. В редакторе кода

    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 защищены, систематическое извлечение его базы не допускается. Подробнее: Правовая информация