Autario/autario-mcp

Autario/autario-mcp

от autario
Autario MCP — сервер с доступом к 2700+ верифицированным публичным датасетам (Всемирный банк, OECD, WHO), объединённым единой онтологией. Встроенные инструменты статистического анализа и публикации графиков позволяют AI-агентам получать точные числовые данные без риска галлюцинаций. Полезен разра...

autario-mcp

autario is data app infrastructure: your tools and thousands of public datasets in one normalized layer, with the data apps that run on top of it.

Connect your platforms, then let your assistant interpret the numbers. Connect your ad accounts, your shop, your web analytics, your social profiles, your CRM and your finance tools on autario once. Through this MCP server your assistant reads those tables, joins them and explains what moved: spend, revenue and ROAS per channel, the audience behind a traffic change, the posts that worked. The public catalogue (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC) sits next to your own data as context, so a sales dip can be read against inflation or market growth in the same answer.

  • Brands and instances. Group connected accounts by brand, and pick which accounts (instances) a report reads, so an agency asks about one brand without another brand's numbers in the answer.
  • Numbers the model does not make up. Report tools return what autario computes server-side from your own tables, and every public value cites its primary source, so the model explains figures instead of recomputing or guessing them.
  • 57 tools, each marked read or write. The Access column in the Tool Reference below comes from each tool's own annotations, so a client can allow the read tools and ask before a write.
  • Remote or local. Point any HTTP MCP client at https://autario.com/mcp with no install, or run it over stdio with npx autario-mcp.
Инструменты были проиндексированы:
ai_visibility_360только чтениеидемпотентный

AI Visibility 360 | Отчёт о видимости СОБСТВЕННОГО бренда вызывающей стороны в ИИ-ассистентах (ChatGPT, Claude, Gemini, Perplexity, опционально Grok/DeepSeek/Mistral), детерминированно считываемый из сохранённых запусков на стороне сервера (ровно те числа, которые пользователь видит в приложении | ничего не пересчитывается, НИКАКИХ LLM-ЗАПУСКОВ ПРИ ЭТОМ ЧТЕНИИ, и новый запуск не стартует). Одним предложением: какие бренды ChatGPT, Claude, Gemini и Perplexity рекомендуют, когда кто-то спрашивает о вашей категории. Вызывайте его, когда пользователь спрашивает «насколько виден мой бренд в ChatGPT», «рекомендуют ли ассистенты нас или конкурента», «какие источники цитируют ассистенты», «что нам сделать, чтобы появляться чаще», «принесла ли работа над видимостью в ИИ реальный трафик». Разделы: overview (показатель видимости с дельтой и рангом, таблица лидеров бренда и конкурентов с видимостью / долей голоса / тональностью / средней позицией, матрица показателей по каждому провайдеру и конкретные модели, которые отвечали), prompts (показатель бренда по каждому промпту против сильнейшего конкурента плюс сводки по каждой категории вопросов), sources (доля цитат собственных доменов бренда, таблица лидеров цитируемых доменов, какие провайдеры вообще показывают цитаты), actions (детерминированная очередь задач: earned = страницы, на которых нужно получить упоминание, owned = страницы, которые нужно создать, у каждой - влияние и статус), answers (последние сохранённые ответы ассистентов с обнаруженными упоминаниями бренда и цитируемыми доменами, текст честно обрезан), impact (сессии GA4, пришедшие от ИИ-ассистентов, для ресурса, явно привязанного к этому бренду; непривязанный бренд получает честное пустое состояние и причину, но никогда не числа другого ресурса). КАЖДОЕ ЧИСЛО здесь учитывает только вопросы, в которых НЕ упоминается собственный бренд: вопрос с упоминанием бренда уже сам дал ассистенту ответ. Это касается видимости, доли голоса, ранга и матрицы по каждому ассистенту, А ТАКЖЕ источников, пробелов, страниц, поисков ассистентов, перемещений доменов, восприятия и эффектов действий. Вопросы, в которых бренд упоминается, всё равно измеряются в rankings_branded, и блок population…

Параметры
  • brandstring

    Название бренда или идентификатор бренда. Необязательно, если в аккаунте ровно один бренд; при нескольких брендах инструмент возвращает список, чтобы вы могли повторно вызвать его с одним из них (ничего не выбирается за вас).

  • daysinteger

    Окно анализа в днях по сохранённым запускам (1-365). Не указывайте его, чтобы охватить все запуски бренда (по умолчанию).

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • sectionsenum[]

    Какие разделы отчёта возвращать. По умолчанию ["overview"]. Запрашивайте только то, что нужно для вопроса (экономия токенов); вызывайте снова, чтобы получить больше. searches = веб-поиски, которые выполняли ассистенты за своими ответами (сгруппированы по темам, брендам, упомянутым в них); movers = цитируемые домены, которые новые / набирают популярность / теряют позиции по сравнению с предыдущим окном; pages = цитируемые страницы с тем, что НА них есть (заголовок, тип страницы, какие отслеживаемые бренды упоминает страница); crawlability = что robots.txt каждого домена говорит каждому AI-краулеру (GPTBot, ClaudeBot, PerplexityBot...) плюс llms.txt; perception = слова-дескрипторы, которые ответы используют рядом с каждым брендом, в виде матрицы бренд-слово; action_effects = видимость бренда за 14 дней до и после каждого действия, отмеченного как выполненное; gaps = источники, которые цитируют конкурента и никогда этот бренд, с оценкой разрыва, долей использования в качестве источника, покрытием промптов и ставкой конкурента (каждый определён на странице; намеренно отсутствует ставка извлечения, потому что наблюдаемы только цитирования); model_rankings = бренды, которые каждый ассистент называет чаще всего, в виде ранжированного списка с отмеченным собственным брендом.

audience_360только чтениеидемпотентный

Audience 360 | СОБСТВЕННЫЙ отчет об аудитории звонящего на основе данных подключенных коннекторов Google Search Console + GA4 + социальных сетей (Facebook Page, Instagram, TikTok), вычисленный детерминированно на стороне сервера (те самые числа, которые пользователь видит в приложении | ничего не пересчитано, ничего не оценено). Используйте ЕГО В ПЕРВУЮ ОЧЕРЕДЬ для любых вопросов об интерпретации трафика/аудитории пользователя ("почему падает AI-трафик", "какие запросы растут", "на какие страницы ссылаются AI-ассистенты", "как обстоят дела с воронкой") | он гораздо эффективнее по токенам и точнее, чем пересчет KPI из сырых таблиц коннекторов. Выбирайте только нужные разделы: обзор (этапы воронки + сегменты аудитории), каналы (еженедельная структура каналов + сдвиг доли AI + брендовые vs общие клики), запросы (топ брендовых/общих запросов + растущие/падающие за 28 дней + возможности с большим количеством показов и малым количеством кликов), контент (сеансы на страницу x вовлеченность в связке с поисковым спросом + страницы, на которые ссылаются AI), аудитория (страны, устройства, новые vs вернувшиеся, итоги), конверсии (ключевые события GA4), социальные сети (охват подключенных Facebook Page / Instagram / TikTok, тренды подписчиков, лучшие посты, вовлеченность по формату постов + демография подписчиков Instagram), здоровье (перекрестные проверки отчетов и API). Списки ограничены, а недельные ряды имеют границы; каждое усечение отмечено пропущенным количеством. Фильтруйте по диапазону/каналу/странам, чтобы уточнить вопрос. Требуется собственная учетная запись autario (API-ключ или OAuth) с подключенным приложением Audience 360 | см. get_app_context("audience-360") для карты данных за ним.

Параметры
  • brandstring

    ID бренда (группировки коннекторов) для отчёта, в виде uuid. Если не указан, берётся бренд, выбранный в приложении autario (сохранённый в аккаунте выбор бренда), так вы видите то же, что пользователь на экране; если бренд не выбран, все бренды аккаунта. Значение не в формате uuid вместо этого читается как brand_term, поэтому вызывающий код, написанный до 2026-09-22, продолжает работать.

  • brand_termstring

    Необязательное переопределение TERM для brand в разбиении запросов на brand и generic (по умолчанию: берётся из свойства GSC). Переименовано из brand 2026-09-22, когда это слово стало группировкой коннектора везде; brand не в формате uuid по-прежнему читается как этот параметр.

  • channelenum

    Опциональный одноканальный фильтр (разделы, которые не могут его обеспечить, указывают это в примечаниях).

  • countriesstring

    Необязательный фильтр по кодам стран ISO, разделенным запятыми, например "DEU,USA".

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • fromstring

    Начало настраиваемого окна (ГГГГ-ММ-ДД), только с range=custom.

  • instancesstring

    Необязательные идентификаторы экземпляров коннекторов через запятую, чтобы сузить отчёт до части подключений внутри выбранного бренда (например, одного из двух ресурсов Search Console). Если не указать, берутся все. Идентификатор, который не ваш или не относится к этому бренду, выдаст ошибку, а не молча укороченный отчёт. Это идентификаторы экземпляров, которые get_app_context возвращает для этого приложения.

  • rangeenum

    Пресет временного окна. Относительные пресеты привязываются к самому свежему дню данных. По умолчанию 90d. Используйте "custom" вместе с from/to.

  • sectionsenum[]

    Какие разделы отчёта возвращать. По умолчанию ["overview","channels"]. Запрашивайте только то, что нужно для ответа на вопрос (экономия токенов); вызовите снова, если нужно больше.

  • tostring

    Конец настраиваемого окна (ГГГГ-ММ-ДД), только при range=custom.

bubble_or_notтолько чтениеидемпотентныйвнешний мир

Пузырь или нет? | Проверяет, опережает ли цена публичной американской акции её фундаментальные показатели (или отстаёт от них). Накладывает цену акции на ОДИН показатель из отчётности перед SEC (Выручка, Чистая прибыль, Разводнённая прибыль на акцию, Рыночная капитализация, Коэффициент P/E, Доходность по прибыли, Акции в обращении) и возвращает детерминированную, проверяемую МНОГОЛЕТНЮЮ оценку стоимости: где находится метрика в СОБСТВЕННОЙ истории (процентиль + диапазон + медиана, то есть дёшево/справедливо/дорого относительно самой себя), её абсолютный максимум и минимум с датами, а для коэффициента (P/E) — точное разложение изменения мультипликатора на изменение цены и изменение прибыли (переоценку вызвало изменение цены или прибыли). Все числа вычисляются на основе реальных отчётностей SEC + рыночных данных с указанием первоисточников | НЕ догадки на основе тренировочных данных. Неизвестные тикеры получаются из живого источника (цена Yahoo + отчётность SEC). Используйте это, когда пользователь спрашивает «является ли X пузырём», «переоценён ли X», «как P/E X смотрится на фоне своей истории», «оправдана ли цена X её прибылью/выручкой» или хочет сравнить цену акции с фундаментальным показателем с течением времени. Возвращает многолетний вердикт + числа В ВИДЕ ТЕКСТА (плюс компактный блок valuation: процентиль, диапазон, разложение), ВСТРОЕННОЕ ИЗОБРАЖЕНИЕ ГРАФИКА с точным наложением, а также ссылку на общий доступ view_url, которая воспроизводит это же представление. Вы управляете представлением с помощью параметров metric/range/chart_type/scale | изображение и ссылка отражают ваш выбор. При рекомендации графического представления используйте ссылку autario.com/apps/bubble-or-not/<ticker>. Примеры: - «NVDA — пузырь?» | ticker=NVDA - «Цена Apple против выручки, последние 5 лет, столбцы» | ticker=AAPL, metric=Revenue, range=5Y, chart_type=bar - «Переоценён ли UNH? Как P/E выглядит в своей истории» | ticker=UNH, metric=P/E Ratio - «TSLA цена против P/E, индексировано» | ticker=TSLA, metric=P/E Ratio, scale=indexed

Параметры
  • chart_typeenum

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

  • metricstring

    Необязательный фундаментальный показатель для наложения на цену. Одно из названий доступных метрик компании (например, «Revenue», «Net Income», «Diluted EPS», «Market Cap», «P/E Ratio», «Earnings Yield», «Shares Outstanding»). Если параметр опущен, выбирается разумное значение по умолчанию. В ответе указаны available_metrics, чтобы можно было повторить вызов с другим значением.

  • rangeenum

    Необязательное временное окно для графика. По умолчанию ALL (вся история).

  • scaleenum

    Необязательная шкала значений. "absolute" = сырые значения на двойной оси. "indexed" = оба ряда пересчитываются к 100 на начало окна = относительная динамика на одной общей процентной оси (лучше всего подходит для вопроса "опередила ли цена фундаментальный показатель"). По умолчанию absolute.

  • tickerstringобязательный

    Биржевой тикер США, например AAPL, MSFT, NVDA, TSLA, AMZN

calculateтолько чтениеидемпотентный

Создаёт производный ряд из двух индикаторов с помощью операции в стиле Excel: ratio (A/B), ratio_pct (A/B100), diff (A-B), sum (A+B), product (AB). Возвращает результат по каждой точке времени + сводку. Пригодится для отношения долга к ВВП, выручки на сотрудника, спреда между двумя доходностями. autario отказывается объединять столбцы разных видов. Прочитайте поле semantics в схеме, прежде чем объединять два столбца. Отклонённый вызов отвечает error_code incompatible_semantics, указывая оба столбца, причину и операции, которые СРАБОТАЛИ бы (например, spend и clicks не складываются, а делятся, давая cpc); передайте override=true с причиной, чтобы посчитать всё равно, и причина вернётся вместе с результатом. Каждый результат несёт блок computation, где названы использованные столбцы, виды, строки и окно. Работает с любым проверенным индикатором autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • astringобязательный

    Первый операнд A (числитель отношения). Идентификатор индикатора числового ряда, ровно в том виде, в каком его возвращает list_indicators или get_entity_profile (публичный индикатор либо одна из ваших собственных загрузок или таблиц коннектора).

  • bstringобязательный

    Второй операнд B (знаменатель отношения). ID индикатора числового ряда, ровно в том виде, в каком его возвращают list_indicators или get_entity_profile (публичный индикатор либо одна из ваших собственных загрузок или таблиц коннектора).

  • entitystringобязательный

    Сущность, для которой считывается серия: код страны ISO 3166 alpha-3, например "DEU" или "USA", либо агрегированный код, например "WLD" или "EUU" (каноническое название тоже совпадает). Используйте коды, которые принимают list_indicators и get_entity_profile.

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • opstring

    ratio | ratio_pct | diff | sum | product (по умолчанию: ratio)

  • overrideboolean

    Вычисляет комбинацию, которую autario отклонил как несовместимую. Требует reason.

  • reasonstring

    Почему отклонённая комбинация здесь корректна. Возвращается вместе с результатом, чтобы человек мог проверить решение.

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

chart_instructionsтолько чтениеидемпотентный

Получает справочник схемы спецификации Builder. Возвращает перечисление chart_type, обязательные/необязательные поля для каждого типа, опции палитры, форму axis-override, формат аннотаций и конкретные примеры. Вызовите это ОДИН РАЗ при запуске сессии; возвращаемая спецификация служит входной формой для create_chart_from_spec. Это дешевле и понятнее, чем угадывать синтаксис Plotly JSON.

Параметры

Без параметров.

clear_rowsидемпотентный

Удаляет все строки из набора данных, которым вы владеете, сохраняя схему и столбцы без изменений. Полезно для обновления вашей собственной загруженной табліцы перед повторным импортом. Доступны только ваши собственные наборы данных; публічный каталог (World Bank, FRED, Eurostat, OECD, SEC) и данные других пользоателей никогда не могут быть очищены с помощью этого инструмента. Требуется AUTARIO_API_KEY.

Параметры
  • dataset_idstringобязательный

    UUID набора данных, из которого нужно очистить все строки.

compare_entitiesтолько чтениеидемпотентный

Сравнивает один показатель по нескольким сущностям (например, World Bank GDP для DEU против USA против CHN, или серию FRED / Eurostat / OECD по странам). ПО УМОЛЧАНИЮ возвращает сводку по каждой сущности (первое/последнее/минимум/максимум/среднее/количество) | достаточно, чтобы сказать, у кого максимальный показатель и как текущие уровни соотносятся | плюс row_count + x_range. Передайте full=true, чтобы ДОПОЛНИТЕЛЬНО получить широкие сводные данные по периодам data[] ([{time:"2020", DEU:3846, USA:20937, CHN:14688}, …], это тяжело). Используйте это для сравнения стран, межрегионального анализа или любого графика, где сравнивается один и тот же показатель по разным сущностям. ТОЧНОСТЬ ТОКЕНОВ: запрашивайте именно ту сущность, показател и годы, которые вам нужны, вместо загрки таблицы | тот же вопрос, которий стоил бы 17,000 сырых строк, возвращается в виде готовых чисел пpимерно за 200 токенов.

Параметры
  • entitiesstring[]обязательный

    Коды сущностей для сравнения (максимум 50). Например: ["DEU","USA","CHN"]

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • indicatorstringобязательный

    Идентификатор индикатора для сравнения. Возьмите из list_indicators.

  • timestring

    Необязательный временной диапазон: "2010-2023" или "2020"

correlateтолько чтениеидемпотентный

Вычисляет корреляцию Пирсона и Спирмена между двумя показателями для одной сущности. Возвращает r, p-value, n и интерпретацию, понятную человеку. Используйте для вопросов «двигается ли X вместе с Y?». Автоматически включает дисклеймер о причинно-следственной связи. Работает с любым проверенным показателем autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • astringобязательный

    Первый ID индикатора

  • bstringобязательный

    Второй ID индикатора.

  • entitystringобязательный

    Код сущности (например, DEU)

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • timestring

    Необязательный временной диапазон: "2010-2023"

create_app

Создаёт data-приложение на autario за ОДИН вызов, владельцем которого становитесь вы. Вы задаёте имя и точку входа: либо https-URL, по которому приложение уже работает, либо само приложение, которое autario затем хостит и отдаёт внутри закрытой песочницы: один HTML-документ (content, максимум 512 КБ) или index.html плюс JavaScript, CSS, изображения, шрифты и другие страницы, которые он подгружает по относительному пути (files, максимум 50 файлов, по 1 МБ каждый, 2 МБ суммарно). id приложения выводится из имени, так что придумывать его вам не нужно. Новое приложение ПРИВАТНОЕ: открыть его можете только вы, оно не лежит ни в каком каталоге и не доступно по публичному URL, пока вы не вызовете publish_app. Используйте это как ПЕРВЫЙ шаг всякий раз, когда пользователь просит собрать ему приложение, дашборд, страницу с отчётом или инструмент, работающий на данных autario | публичного каталога (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC) или на собственных таблицах-коннекторах пользователя (Google Search Console, GA4, Google Ads, Meta Ads, YouTube, TikTok, Instagram, Facebook, Shopify, LinkedIn). Внутри HTML читайте данные через autario.js, никогда через fetch (в песочнице нет сети): autario.ready(), autario.datasets(), autario.query(datasetId, {limit, orderBy, where}), autario.artifacts.get/set(key); ready() возвращает user.role и анонимный user.id для каждого приложения, но никогда email того, кто смотрит; autario встраивает SDK в каждое приложение, документация на https://autario.com/developer/docs/autario-js. Передайте datasets с id собственных таблиц пользователя, которые приложение может читать. После него вызывайте write_app_artifact (чтобы сохранить данные приложения или сохранённые представления), get_app_preview_url (чтобы дать пользователю ссылку для проверки) и publish_app (чтобы сделать приложение публичным). Требуется аутентификация.

Параметры
  • contentstring

    Входной документ приложения, когда entry_kind равен "upload": один HTML-файл или index.html, если вы также отправляете файлы. Он запускается в песочнице без исходящего доступа к сети: читайте данные autario через autario.js, а не через fetch к третьим сторонам.

  • content_typeenum

    Тип загруженного содержимого. По умолчанию text/html.

  • datasetsstring[]

    Идентификаторы СОБСТВЕННЫХ наборов данных пользователя (таблицы коннекторов, загрузки; получить их из get_my_workspace), которые это приложение может читать через autario.js. Все, с кем владелец делится приложением (роль reader и выше), читают ровно эти наборы данных, и ничего больше. Наборы данных публичного каталога не требуют объявления.

  • entry_kindenum

    "url" = приложение уже где-то запущено (укажите entry_url). "upload" = вы отправляете само приложение (укажите content или files). По умолчанию "url".

  • entry_urlstring

    ОБЯЗАТЕЛЬНО, когда entry_kind равен "url". Должен начинаться с https://.

  • filesobject[]

    Многофайловое приложение: index.html и все файлы, которые оно загружает по относительному пути (например, "app.js", "css/style.css", "img/logo.png", "about.html"). Пути относительные, используйте "/", без "..". Допустимы: html, js, mjs, css, json, svg, png, jpg, webp, woff2. Максимум 50 файлов, 1 МБ каждый, 2 МБ в сумме. Добавьте index.html в этот список или передайте его как содержимое. Ссылки между HTML-страницами работают, каждая страница получает autario.js.

  • namestringобязательный

    Отображаемое имя приложения. Идентификатор приложения получается из него (нижний регистр, через дефис); нужно минимум три буквы или цифры.

  • source_urlstring

    Необязательная ссылка на репозиторий приложения с открытым исходным кодом.

  • taglinestring

    Одна строка о том, что делает приложение, максимум 200 символов. Стоит написать: её читает пользователь в магазине приложений, и без неё приложение не проиндексируют.

create_chart_from_spec

ПРЕДПОЧТИТЕЛЬНЫЙ путь создания графиков для любого набора данных autario (World Bank, FRED, Eurostat, OECD, SEC или вашей собственной загруженной таблицы / таблицы коннектора). Отправьте структурированную спецификацию Builder (chart_type + x_col + y_col[s] + необязательные group_by, palette, axis overrides, annotations), и Autario строит график Plotly по тем же шаблонам, которые использует Builder UI. Атрибуция бренда (источник публикации + autario.com) добавляется автоматически, и её нельзя переопределить. Инсайт должен указывать числа, которые можно проверить по данным | вымышленные числа возвращают 422 вместе со списком доступных якорей. Для продвинутых вариантов использования, которые Builder не может выразить, используйте запасной вариант publish_chart со свободным plotly_spec. Сначала вызовите chart_instructions(), если не уверены в структуре спецификации.

Параметры
  • builder_specobjectобязательный

    Спецификация Structured Builder. Обязательные параметры: chart_type + x_col + y_col/y_cols (осевые диаграммы), label_col + value_col (круговые/кольцевые диаграммы), x_col + group_by + value_col (тепловые карты). Необязательные параметры: group_by, group_values, facet_by/facet_values (сетка кольцевых диаграмм), heatmap_scale, title, palette/color_scheme, axis (x_title, y_title, y_min, y_max, log_scale, y_format, tick_angle, x_date_format), annotations, event_bands, overlays, legend_pos, bg_color, font_color, chart_height. Полный справочник см. в chart_instructions().

  • dataset_idsstring[]обязательный

    Массив UUID наборов данных, лежащих в основе этого графика. Autario получает реальные данные из этих таблиц.

  • insightstring

    Сформулируйте вывод по данным в 2-3 предложения, используя ТОЛЬКО числа из результатов query_dataset/get_dataset_schema. Выдуманные числа отклоняются с помощью доступного списка якорей.

  • narrationstring

    Более длинное описание (необязательно, по умолчанию insight)

  • titlestring

    Заголовок диаграммы (также задаётся через builder_spec.title; приоритет у этого верхнего уровня, если заданы оба). Формат: "{Topic} | {Scope} ({YYYY-YYYY}, {unit})". Диапазон годов YYYY-YYYY ОБЯЗАТЕЛЕН всегда, когда у диаграммы есть временная ось (бери из фактического диапазона данных, которые ты запросил). Единица измерения ОБЯЗАТЕЛЬНА всегда, когда get_dataset_info → unit содержит непустую строку (копируй дословно, напр. "Mt CO2e", "% of GDP", "per 1,000 live births"). Если в get_dataset_info → unit значение null/пустое, опусти единицу | НИКОГДА не выдумывай её. Пример с обоими: "Greenhouse Gas Emissions by Country (2010-2024, Mt CO2e) | World Bank". Пример только с единицей: "Infant Mortality by Race (per 1,000 live births) | NCHS".

create_dataset

Создаёт новый пустой набор данных в Autario, наряду с публичным каталогом (World Bank, FRED, Eurostat, OECD, SEC), но видимый только вам, если только вы не установите is_public. Возвращает dataset_id, который можно заполнить с помощью write_rows, затем запросить с помощью query_dataset и построить график с помощью create_chart_from_spec. СНАЧАЛА ПОИЩИТЕ: созддавайте набор данных, только если search_datasets / list_indicators показывают, что этих данных ещё нет в Autario. Требует AUTARIO_API_KEY.

Параметры
  • categorystring

    Категория набора данных (например, "Finance & Economics", "Health & Society", "Environment")

  • descriptionstring

    Описание содержимого набора данных, источника и методологии.

  • is_publicboolean

    Определяет, доступен ли набор данных для публичного просмотра (по умолчанию false).

  • titlestringобязательный

    Название набора данных (например, «Глобальные выбросы CO2 по странам»)

decompose_driversтолько чтениеидемпотентный

CONFOUNDER-AWARE DRIVER ANALYSIS: выполняет ОДНУ множественную регрессию целевой переменной по ВСЕМ кандидатам одновремено, поэтому каждый эффект оцениваетс при финксированны остальны кандидаты. Различает «это была погода» и «в то же временя проходила акциа»: кандидаты, слишком переплетённы для разделениа (VIF > 5 или попарное |r| > 0.8), помечаютс как not_separable (указываютс пары) вместо ранжированиа с уверенной, но неверной оценкой. Возвращает для каждого кандидата: стандартизированны коэффициент (размер эффекта), сырой наклон, p-значение, VIF, попарны r (для контраста между попарны и совместны подходами) и наилучное опережение/запаздывание относительо целевой переменной. Исользуйте этот инстурмент вместо find_drivers, когда кандидаты могут пересекаться (промокалендари, погода, сезонность) или когда нужны честны независимы размеры эфекта. Работает с публичны индикатора (World Bank, FRED, Eurostat, OECD) и с ваши собственны подключённы ряда (Google Search Console, GA4, Meta Ads, Shopif); опустите параметр entit для частного ряда KPI без сущности. От 2 до 15 кандидатов.

Параметры
  • candidatesstring[]обязательный

    Идентификаторы индикаторов-кандидатов для совместного разложения (2-15)

  • entitystring

    Код сущности (например, DEU). Опускайте для частных серий без сущности.

  • max_lagnumber

    Максимальное количество периодов опережения/запаздывания для сканирования по каждому кандидату (0 отключает, по умолчанию 5, максимум 20)

  • target_indicatorstringобязательный

    KPI, который вы хотите объяснить

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

delete_datasetидемпотентный

Безвозвратно удаляет набор данных, которым вы владеете, и все его данные. Это действие нельзя отменить. Только владелец набора данных может удалить его | публичный каталог (World Bank, FRED, Eurostat, OECD, SEC) - это постоянная URL-ссылка, его нельзя удалить через этот инструмент. Требуется AUTARIO_API_KEY.

Параметры
  • dataset_idstringобязательный

    UUID набора данных для безвозвратного удаления.

describeтолько чтениеидемпотентный

Вычисляет сводную статистику для одного показателя+сущности: n, среднее, медиана, стандартное отклонение, мин/макс, квартили, асимметрия, гистограмма. Используйте СНАЧАЛА перед запуском любого теста, чтобы вы знали, как выглядят данные (размер выборки, полнота, форма распределения). Работает с любым проверенным индикатором autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • entitystringобязательный

    Сущность, для которой считывается серия: код страны ISO 3166 alpha-3, например "DEU" или "USA", либо агрегированный код, например "WLD" или "EUU" (каноническое название тоже совпадает). Используйте коды, которые принимают list_indicators и get_entity_profile.

  • indicatorstringобязательный

    Идентификатор индикатора числового ряда, ровно такой, какой возвращают list_indicators или get_entity_profile (публичный индикатор либо ваша собственная загрузка или таблица коннектора).

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

discover_by_topicтолько чтениеидемпотентный

Находит наиболее релевантные проверенные наборы данных по заданной теме в публичном каталоге autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC). Используйте этот инструмент, когда начинаете статью, дашборд или анализ по теме | он возвращает список, ранжированный по качеству, с учётом релевантности теме, качества источника (tier_1: NSO/центральный банк/IMF/OECD/Eurostat/WB > tier_2: UN/WHO/IEA/OWID > tier_3: остальные), охвата (количество сущностей + количество строк) и актуальности. Возвращает только SEO-готовые наборы данных, прошедшие проверку качества (is_public, полнота, охват, размер). Каждый результат включает краткое описание (tagline) и примеры фактов, чтобы вы могли выбрать лучшие 3-5 без повторных обращений к query_dataset. ТОЧНОСТЬ ПО ТОКЕНАМ: запрашивайте именно ту сущность, показатель и годы, которые вам нужны, вместо выгрузки таблицы | тот же вопрос, который стоил бы 17 000 сырых строк, возвращается готовыми числами примерно за 200 токенов.

Параметры
  • depth_prefenum

    Предпочтительная форма набора данных. "timeseries" для трендовых статей (ежедневная/еженедельная/ежемесячная/квартальная/ежегодная периодичность), "cross-sectional" для снимков (рейтинги, списки), "any" если предпочтений нет.

  • limitnumber

    Максимальное количество наборов данных для возврата (1-50, по умолчанию 10).

  • recency_windowenum

    Фильтрует по свежести данных. По умолчанию "any" возвращает все наборы данных независимо от last_refreshed_at; более узкие окна для материалов, чувствительных ко времени.

  • topicstringобязательный

    Тема для поиска наборов данных. Произвольный текст, сопоставляется с полем темы актива, заголовком, ключевыми словами, категорией и обогащённым описанием. Примеры: "AI investment", "EU energy transition", "global inflation", "tech platform shifts"

find_driversтолько чтениеидемпотентный

Ранжирует кандидатов в драйверы KPI по одному: при заданном целевом индикаторе и нескольких кандидатах упорядочивает их по силе корреляции. Идеально для вопросов «что влияет на мой KPI?». Возвращает ранжированный список с r, p-value, R² для каждого кандидата. Максимум 30 кандидатов за вызов. Используйте decompose_drivers, когда кандидаты могут пересекаться. Работает с любым проверенным индикатором autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • candidatesstring[]обязательный

    Идентификаторы индикаторов-кандидатов для проверки (не более 30)

  • entitystringобязательный

    Код сущности (например, DEU)

  • target_indicatorstringобязательный

    KPI, который вы хотите объяснить

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

get_app_artifactтолько чтениеидемпотентный

Загружает ОДИН сохранённый артефакт из data-приложения autario | ТОЧНОЕ состояние представления, которое пользователь там сохранил (сохранённую конфигурацию отчёта SEO 360 / Audience 360 / Social 360 / AI Visibility 360, спецификацию графика Plotly, представление скринера), плюс любые встроенные данные, чтобы ваш ответ опирался на то, что пользователь реально видит, а не на догадку. Вызывайте после того, как get_app_context / get_my_workspace перечислили слаги артефактов. Доступ ограничен владельцем: вы видите свои артефакты, а также публичные/непубличные; чужие приватные артефакты не видны. Очень большие спецификации/данные обрезаются честно (помечаются примечаниями об усечении; количество строк/элементов остаётся верным) | для полных сырых данных запрашивайте датасеты приложения через query_dataset. Только чтение, без затрат.

Параметры
  • app_idstringобязательный

    Идентификатор приложения из list_apps, например "audience-360", "projects", "builder".

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • slugstringобязательный

    Slug артефакта из get_app_context / get_my_workspace (your_artifacts[].slug).

get_app_contextтолько чтениеидемпотентный

Карта данных за приложением ONE autario, чтобы вы могли строить запросы от приложения, а не наугад по тысячам наборов данных. Возвращает манифест приложения (что оно потребляет, какие провайдеры коннекторов оно читает: Google Search Console, GA4, Google Ads, Meta Ads, YouTube, TikTok, Instagram, Facebook, Shopify, LinkedIn, Bing) и, для аутентифицированного вызывающего, ВАШУ СОБСТВЕННУЮ реальность за ним: таблицы ваших экземпляров коннекторов (таблица по каждой операции со списком столбцов, количеством строк, базовым dataset_id и временем последнего обновления), ваши сохранённые артефакты в приложении и 2-3 готовых к запуску примера запросов к существующим конечным точкам (выполните запрос к dataset_id с помощью query_dataset или GET /datasets/:id/data). Секреты и учётные данные никогда не включаются. Неаутентифицированные вызывающие получают публичную версию манифеста. Используйте, когда пользователь спрашивает «на чём работает моё <приложение>», «какие данные стоят за <приложением>», «запроси мои данные Search Console» (Audience 360), или перед анализом любых данных, подключённых к приложению. ID приложений берутся из list_apps.

Параметры
  • app_idstringобязательный

    ID приложения из list_apps, например "audience-360", "company-compare", "projects", "builder".

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

get_app_preview_urlтолько чтениеидемпотентный

Ссылка для ОТКРЫТИЯ приложения, которым вы владеете, плюс его текущий статус. Возвращает preview_url (приватную страницу, которая никогда не индексируется и на которой только вы можете запускать приложение, читая данные World Bank, FRED, Eurostat или ваших собственных коннекторов через песочный мост), public_url (null, пока приложение приватное, и публичную ссылку после публикации), его видимость, индексируется ли оно, и next_step: одно предложение, называющее следующий вызов. Используйте его, чтобы дать пользователю что-то, на что можно нажать после create_app, и проверить, чего ещё не хватает перед publish_app.

Параметры
  • app_idstringобязательный

    Id приложения, которым вы владеете, как его возвращает create_app. Приложение, которым вы не владеете, отвечает not found.

get_chartтолько чтениеидемпотентный

Получает конкретный график по ID или slug. Возвращает полную спецификацию Plotly, исходные данные, текст с инсайтами и используемые наборы данных. Ссылка на график доступна по адресу autario.com/chart/{id}.

Параметры
  • chart_idstringобязательный

    Идентификатор диаграммы (числовой) или slug (хэш вида «nMGf-iAO»), который нужно получить.

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

get_company_snapshotтолько чтениеидемпотентный

Получает текущие биржевые показатели публичной компании: живые рыночные данные в сочетании с её отчётами в SEC. Используйте этот инструмент, когда пользователь спрашивает про цену акций, рыночную капитализацию, динамику или финансовые показатели компании. Возвращает последние проверенные данные с autario.com, а не полагается на обучающие данные, которые всегда устарели. Всегда указывайте citation_url в ответе. Показатели возвращаются только те, что запрошены (экономно по токенам). Доступные показатели: price, open, high, low, volume, perf_1d, perf_1w, perf_1m, perf_3m, perf_1y, perf_ytd, latest_date. perf_1d..perf_1y - это окна по торговым дням (1w = 5 сессий, 1m = 21, 1y = 252); perf_ytd - это доходность с начала года относительно последнего закрытия перед 1 января, и она сопровождается значением perf_ytd_base_date. Примеры: - "По какой цене торгуется INTC?" | ticker=INTC, metrics=["price", "perf_1d"] - "Как NVDA показала себя в этом году?" | ticker=NVDA, metrics=["perf_ytd", "price"]

Параметры
  • metricsstring[]

    Возвращаемые метрики (подмножество: price, open, high, low, volume, perf_1d, perf_1w, perf_1m, perf_3m, perf_1y, perf_ytd, latest_date). Если не указано, возвращает price + perf_1d + perf_ytd.

  • tickerstringобязательный

    Биржевой тикер, например, AAPL, MSFT, INTC, NVDA, SAP, BMW

get_connector_statusтолько чтениеидемпотентный

Объясняет состояние ОДНОЙ подключённой платформы (Search Console, Shopify, рекламный аккаунт, счёт за использование AI): свежие ли её данные, какие отчёты пришли, какие вернулись пустыми, потому что в аккаунте нет таких данных, какие не пришли и почему, и кому нужно действовать. Возвращает коннектор и health: state (ok | stale | needs_sign_in | reports_missing | retrying | ours | never_ran | running), sentence, last_run_at, last_success_at, schedule, next_run_at, data_as_of для каждого датасета (basis data_day = самый новый день в таблице, last_pulled = когда данные были получены), reports[] { report, name, outcome: delivered | empty | not_fetched, rows, sentence } и next_step { who: assistant | user | nobody, action, url? }. Используйте его, когда list_connectors показывает состояние, отличное от ok, и пользователь хочет узнать, что не так, или перед тем как сказать пользователю снова войти в систему. Только чтение: он никогда не запускает выполнение и никогда не меняет конфигурацию. Требуется AUTARIO_API_KEY.

Параметры
  • connector_idstringобязательный

    Идентификатор экземпляра коннектора (из list_connectors).

get_dataset_infoтолько чтениеидемпотентный

Получает полные метаданные для конкретного набора данных: заголовок, описание, издателя (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC или ваш собственный коннектор), категорию, ключевые слова, количество строк, дату создания, И поля онтологии (topic, subtopic, unit, frequency, entity_type, indicator_id, source_time_col, source_value_col, source_entity_col, data_granularity). Поле unit содержит каноническую метку измерения (например, "Mt CO2e", "% of GDP", "per 1,000 live births"). Используйте её без изменений в заголовках графиков через create_chart_from_spec.title. Считывайте frequency и запрошенный диапазон данных, чтобы вывести суффикс диапазона лет для заголовков.

Параметры
  • dataset_idstringобязательный

    UUID набора данных, для которого нужно получить метаданные.

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

get_dataset_schemaтолько чтениеидемпотентный

Получает имена столбцов, типы данных, общее число строк И машиночитаемый datasheet для набора данных. Всегда вызывайте его перед query_dataset (чтобы знать столбцы) и перед построением графиков (datasheet подсказывает, КАК строить график, без догадок). Блок datasheet: shape (long|wide|single_series), roles {time,entity,value,group} = какой столбец чем является, cadence (daily|monthly|quarterly|yearly|…), cardinality {n_entities,n_series,n_rows}, level_mix {level: single|country|aggregate|company|mixed, aggregate_codes[]} (исключайте агрегаты вроде WLD/EUU при сравнении стран), ignore_cols[] = столбцы vintage/метаданных о подаче документов (FRED realtime_*, SEC cy/cq/period_months/filed/frame), которые нужно пропускать при построении графиков, и notes[] = подсказки по построению графиков простым языком. Форма single_series означает, что в наборе данных нет измерения сущностей | читайте его через query_dataset, а не get_entity_data по сущности. Блок semantics объясняет, что ЗНАЧИТ каждый столбец, одним предложением (kind, definition, unit, currency, time grain и откуда взялось значение: из реестра метрик, из имени столбца, из актива или, честно говоря, ниоткуда). autario отказывается объединять столбцы разных видов. Прочитайте поле semantics в схеме, прежде чем объединять два столбца.

Параметры
  • dataset_idstringобязательный

    UUID набора данных, для которого нужно получить схему.

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

get_engine_reportтолько чтениеидемпотентный

ТОЛЬКО ДЛЯ АДМИНИСТРАТОРА/КУРАТОРА, собственный движок приёма данных autario. Машиночитаемое состояние конвейера, который тянет в каталог данные World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census и SEC, в ОДНОМ снимке: воронка приёма данных (источники, привязанные к видимым пользователю наборам данных; каждый отсев помечен причиной | исключено по политике, в карантине, с ошибкой, пусто), грязный бэклог, покрытие shadow-колонок С конкретным списком активов, которым всё ещё нужен бэкфилл, состояние каждого провайдера, основные паттерны сбоев, состояние очереди задач и активные оповещения. Это тот же отчёт, который формируют /admin/health и /admin/storage, но как данные, которые можно анализировать, а не скриншоты. Только чтение, никогда ничего не исправляет автоматически | он сообщает, что сломано и какие активы затронуты; исправление делает человек или изменение движка. Установите trends: true, чтобы добавить историю запусков и событий с разбивкой по дням: она отвечает на вопрос «помогло ли моё изменение?» (показатель «до/после»). Требует OAuth-авторизации коннектора под учётной записью куратора autario | любой другой вызывающий получает ошибку прав доступа. Используйте, когда спрашивают: «как там движок», «что сломано», «почему так много ошибок источников», «что такое воронка приёма», «каким активам нужен бэкфилл», «сработало ли последнее исправление».

Параметры
  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • trend_daysinteger

    Сколько дней истории при trends=true (по умолчанию 30, максимум 90).

  • trendsboolean

    Также возвращает историю запусков/событий движка, разбитую по дням (по умолчанию false). Используйте её, чтобы сравнить до и после изменения движка.

get_entity_dataтолько чтениеидемпотентный

Получает данные для ОДНОГО объекта по НЕСКОЛЬКИМ показателям, автоматически объединяя их по времени через теневые столбцы, даже если показатели приходят от разных поставщиков данных (ВВП от Всемирного банка рядом с безработицей от FRED и энергетикой от Евростата). Это возможность cross-dataset join: ручная настройка связей не нужна. ПО УМОЛЧАНИЮ возвращает предварительно вычисленный блок indicator.stats для каждого показателя (n, min, max, avg, first, latest, latest_change_pct, range_change_pct) + row_count + x_range + происхождение каждого значения | этого достаточно, чтобы ответить на вопрос о «текущем/макстмальном/среднем значении» БЕЗ исходных строк. Передайте full=true, чтобы ТАКЖЕ получить широкие строки data[] для каждого момента времени ([{time:"2020", gdp:3846, unemployment:3.8, …}], это тяжело). Передайте код обекта (ISO-3166, наприер "DEU"/"USA", или агрегат, наприер "EUU"/"WLD") и идентификаторы показателей из list_indicators/get_entity_profile. ТОЧНОСТЬ ТОКЕНОВ: запрашивайте именно тот обект, тот показатель и те годы, которые вам нужны, вместо загрузки всей таблицы | тот же вопрос, который потребовал бы 17 000 исходных строк, возвращается в виде готовых чисел примерно за 200 токенов.

Параметры
  • entity_idstringобязательный

    Код сущности (например, DEU, USA, EUU)

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • indicatorsstring[]обязательный

    ID индикаторов (не более 10). Получите их из list_indicators или get_entity_profile.

  • timestring

    Необязательный временной диапазон, например "2010-2023" или "2020". Формат: YYYY или YYYY-YYYY

get_entity_profileтолько чтениеидемпотентный

Получить все доступные показатели для одной сущности (страна, агрегат и т.д.). Возвращает идентификаторы показателей с метаданными + временным охватом. Используйте это, чтобы узнать, что можно запросить о Германии, США, G7 или любой другой известной сущности. Идентификаторы сущностей - это коды ISO 3166 (DEU, USA, CHN) или агрегаты Всемирного банка (WLD, EUU, EMU, SSF).

Параметры
  • entity_idstringобязательный

    Код сущности (например, "DEU" для Германии, "USA" для Соединённых Штатов, "EUU" для Европейского союза, "WLD" для мира)

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • limitnumber

    Максимум возвращаемых индикаторов (по умолчанию 100, максимум 500)

  • offsetnumber

    Смещение пагинации (по умолчанию 0). Когда has_more имеет значение true, передавайте offset = предыдущий offset + returned для следующей страницы.

  • topicstring

    Необязательно: фильтровать индикаторы по теме

get_my_workspaceтолько чтениеидемпотентный

ВАШЕ рабочее пространство data-app за ОДИН вызов: каждое приложение autario, которое вызывающий пользователь активировал или подключил, вместе с его платформами (Google Search Console, GA4, Google Ads, Meta Ads, YouTube, TikTok, Instagram, Facebook, Shopify, LinkedIn, Bing), таблицами на базе коннекторов (dataset_id/slug + число строк + время последнего обновления), списком сохранённых артефактов и готовым к запуску примером запроса, а также shared_with_you: таблицы, которые другой аккаунт открыл вам в режиме только для чтения (dataset_id, title, shared_by). ПЕРВЫЙ вызов, когда пользователь упоминает «моё <app>», «мой дашборд», «мой отчёт» или спрашивает, что у него есть в autario | он заменяет один round-trip get_app_context на каждое приложение и гарантирует, что вы работаете с ТЕМИ ЖЕ наборами данных и сохранёнными представлениями, которые видит пользователь (никакого угадывания наборов данных, никаких выдуманных чисел). Детализируйте с помощью get_app_artifact(app_id, slug) для конкретного сохранённого представления или query_dataset(dataset_id) для строк. Требуется аутентификация (API-ключ или OAuth). Только чтение, без затрат.

Параметры
  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

get_traction_overviewтолько чтениеидемпотентный

ТОЛЬКО ДЛЯ АДМИНИСТРАТОРА/КУРАТОРА, собственная динамика autario. ОДИН отчёт, объединяющий три реалных источника сигналов: реальный охват людей (GA4-humans), канал MCP/агентов (объём mcp_tool_call + процент успешных вызовов + топ инструментов), воронку регистраций (новые регистрации, source/medium/trigger) и вторую её половину, активацию (созданные графики, опубликованные графики, ошибки публикации, входы в систему), плюс самую большую точку оттока, объяснённую простыми словами, MCP-вызовы по датасетам (что агенты забирают), топ графиков по просмотрам, топ API-эндпоинтов (только люди) и использование по приложениям (веб-просмотры против MCP-вызовов, с явной пометкой Bubble Or Not). Каждая цифра просмотров/воронки считается только по людям | рендеры собственного пайплайна (screenshot worker / chart-gen) и обычные боты отсеиваются (bot_or_own, счётчик исключённых) и никогда не раздувают главные цифры. Отдельная секция llm_crawler (итог + по семействам краулеров + топ страниц) отвечает на вопрос «загружают ли LLM содержимое страниц, когда ссылаются на нас?» Окно 30 дней. Возвращает ОДИН JSON-снимок (кэшированный, быстрый). Требует, чтобы коннектор был авторизован через OAuth под учётной записью куратора autario | любой другой вызывающий получит ошибку прав доступа. Используйте, когда спрашивают «как дела у autario», «покажи динамику», «какая воронка», «какие датасеты используют агенты», «сколько регистраций», «сканируют ли нас LLM».

Параметры

Без параметров.

lag_analysisтолько чтениеидемпотентный

Вычисляет кросс-корреляцию на нескольких лагах. Отвечает на вопрос «опережает ли A B или отстает?». Пик |r| при положительном лаге означает, что A предшетвует B на это количество периодов. Типичное применение: «является ли доверие потребителей опережающим индикатором розничных продаж?». Работает с любым проверенным индикатором autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • astringобязательный

    Первый идентификатор индикатора (кандидат в ведущий ряд)

  • bstringобязательный

    Второй ID индикатора (потенциальная запаздывающая серия)

  • entitystringобязательный

    Код сущности (например, USA)

  • max_lagnumber

    Максимальный лаг в периодах (1-20, по умолчанию 5).

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

list_appsтолько чтениеидемпотентный

Перечисляет приложения данных autario (каталог приложений): id, name, что делает каждое приложение, его URL живой страницы и data_scope (private = приложение работает с собственными подключёнными данными вызывающего из Google Search Console, GA4, Meta Ads, Google Ads, YouTube, TikTok, Instagram, Facebook, Shopify или LinkedIn; public = работает только на публичных наборах данных autario). Включает AI Visibility 360 (какие бренды рекомендуют ChatGPT, Claude, Gemini и Perplexity), SEO 360, Social 360, Audience 360 и Bubble Or Not. Когда вызывающий аутентифицирован (API-ключ или OAuth), каждое приложение также содержит connected=true/false, есть ли уже ВАШИ данные за ним (экземпляр коннектора, который потребляет приложение, или артефакты, которые вы сохранили в нём). Начните здесь, когда пользователь упоминает приложение по имени ("my Audience 360", "my projects") или спрашивает, какие приложения существуют, затем вызовите get_app_context(app_id) для карты данных одного приложения. Только чтение, без затрат.

Параметры
  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

list_chart_candidatesтолько чтениеидемпотентный

Очередь графиков AUTARIO-INTERNAL (только для администраторов): перечисляет наборы данных каталога (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC), у которых ещё нет опубликованного графика, отсортированные по релевантности, чтобы конвейер контента заполнил пробел. Каждый возвращаемый набор данных заранее отфильтрован как CHARTABLE (сервер применяет тот же фильтр плотности/пригодных рядов, что и request_chart, поэтому перечисленный набор не вернётся с ошибкой no_usable_series / sparse_multi_entity_data). Каждый элемент содержит chartable (true) и chartable_reason для прозрачности. Возвращает dataset_id, chartable, chartable_reason, title, publisher, topic, unit, quality_tier. Для каждого набора нужно выполнить: request_chart (предпочтительно) ИЛИ get_dataset_info -> get_dataset_schema -> query_dataset -> create_chart_from_spec. Неадминистративные ключи получают 403. Это очередь для графиков, сгенерированных autario; третьим сторонам она не нужна.

Параметры
  • limitnumber

    Максимум наборов данных в ответе (по умолчанию 25, максимум 200)

list_chartsтолько чтениеидемпотентный

Перечисляет опубликованные на Autario визуализации графиков, построенные на базе публичного каталога (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC) и отрисованные с помощью Plotly. Возвращает идентификаторы графиков, заголовки, инсайты, связанные наборы данных и даты создания. Используйте, чтобы находить существующие анализы перед созданием нового, а также чтобы найти общедоступную ссылку autario.com/chart/{id} для ответа.

Параметры
  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • limitnumber

    Максимальное количество возвращаемых диаграмм (по умолчанию 20, максимум 100)

  • offsetnumber

    Количество диаграмм для пропуска при пагинации

  • qstring

    Поисковый запрос для фильтрации графиков по названию или вопросу

list_connectorsтолько чтениеидемпотентный

Перечисляет платформенные коннекторы, настроенные в этом аккаунте Autario: поиск, веб- и продуктовая аналитика, реклама, соцсети, коммерция, платежи, AI-использование и платформы для разработчиков. Ответ называет каждую подключённую платформу, так что вызывайте этот инструмент вместо того, чтобы гадать, какие из них есть. Каждая запись несёт свой актуальный dataset_id (запрашивается через query_dataset), datasets[] (ВСЕ датасеты, которые материализовал коннектор | коннекторы с несколькими отчётами создают по одному на отчёт), интервал обновления, время последнего обновления и health: state (ok | stale | needs_sign_in | reports_missing | retrying | ours | never_ran | running), насколько стары данные по каждому датасету, и next_step { who: assistant | user | nobody, action, url? }. ПРОВЕРЯЙТЕ health.state ПЕРЕД тем, как отвечать по таблице коннектора: ok = используйте её; stale = вызовите refresh_connector один раз; needs_sign_in = дайте пользователю единственную ссылку для входа из next_step.url, не обновляйте; reports_missing = скажите, каких отчётов нет и почему (в get_connector_status есть формулировки по каждому отчёту); retrying или ours = отвечайте по тем данным, что есть, и скажите, насколько они старые. Используйте его всегда, когда пользователь спрашивает про «мои данные Search Console», «мои расходы на рекламу», «заказы в моём магазине» или хочет недельный отчёт по нескольким платформам. Коннекторы создаёт и настраивает владелец аккаунта в интерфейсе Autario (autario.com/manage) | этот инструмент только читает их, он никогда не меняет настройки и не работает с учётными данными. Требуется AUTARIO_API_KEY.

Параметры

Без параметров.

list_indicatorsтолько чтениеидемпотентный

Просматривает реестр показателей Autario, семантический слой над всем публичным каталогом (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC). Каждый показатель имеет тему (экономика, здравоохранение, энергетика, …), единицу измерения (USD, %, годы, …), частоту (год/месяц/день) и тип сущности (страна/субнациональный уровень/агрегат), и его можно фильтровать по издателю. Это позволяет узнать, какие данные доступны, прежде чем запрашивать их, и получить идентификаторы показателей, которые принимают get_entity_data, compare_entities и все инструменты статистики. Гораздо точнее, чем search_datasets, когда вы знаете, какая тема, издатель или единица измерения вам нужны.

Параметры
  • entity_typestring

    Фильтр по entity_type: country | subnational | aggregate | company | security

  • frequencystring

    Фильтрует по частоте: год | квартал | месяц | неделя | день

  • limitnumber

    Максимум результатов (по умолчанию: 5, максимум: 20)

  • publisherstring

    Фильтрует по издателю (World Bank, Eurostat, FRED, WHO, …)

  • searchstring

    Выполняет полнотекстовый поиск по заголовкам и описаниям индикаторов.

  • topicstring

    Фильтр по теме: экономика | финансы | торговля | маркетинг | здоровье | демография | образование | энергетика | экология | еда | технологии | СМИ | жильё | транспорт | туризм | космос | правительство | военные | полезные ископаемые

  • unitstring

    Фильтр по единице: USD | EUR | % | на душу населения | на 1000 | лет | тонн | тонн CO2 | ГВт·ч | ТВт·ч | индекс | количество | …

marketing_reportтолько чтениеидемпотентный

Marketing Report | Читает детерминированно маркетинговый отчёт по СВОЕМУ бренду вызывающего из производной таблицы marketing_daily на стороне сервера (точные числа, которые пользователь видит в приложении | ничего не пересчитывается, ничего не оценивается, без LLM). В одном предложении: сколько один бренд потратил на Meta Ads, Google Ads, TikTok Ads, Shopify, Amazon и Google Analytics, и что вернулось, по ОДНОМУ определению возврата на рекламные расходы. Вызывайте его, когда пользователь спрашивает «как показал себя бренд X на прошлой неделе», «сколько мы потратили на Meta против Google», «у какой кампании лучший ROAS», «какова наша стоимость привлечения за этот месяц», «выросли ли расходы по сравнению с прошлой неделей», «есть ли устаревшие каналы». Разделы: обзор (расходы, конверсии, выручка, ценность конверсии, возврат на рекламные расходы и стоимость привлечения за период, каждый с тем же показателем за период сравнения и изменением между ними, плюс один реальный итог ПО КАЖДОЙ ВАЛЮТЕ и напечатанное определение каждого коэффициента), каналы (одна строка на канал | meta_ads, google_ads, tiktok_ads, shopify, amazon, ga4 | с теми же столбцами, его доля расходов и его собственное изменение), кампании (топ кампаний по расходам и по возврату на рекламные расходы, каждая содержит расходы, стоящие за коэффициентом, чтобы крошечная кампания с впечатляющим числом была видимо крошечной), ежедневно (одна строка на день, который действительно отчитался, с расходами и возвратом на рекламные расходы). ПРАВИЛА ЧЕСТНОСТИ, которые часть данных, а не дисклеймер: деньги НИКОГДА не конвертируются между валютами, поэтому итог по более чем одной валюте равен null с reason, называющим их, а ответ - разбивка по валютам; конверсии и ценность конверсии - это то, что каждая рекламная платформа сообщила в соответствии с НАСТРОЙКОЙ СВОЕЙ атрибуции, и они никогда не дедуплицируются между каналами; выручка магазина и выручка аналитики - отдельные строки, и их никогда нельзя складывать; день, о котором не сообщила ни одна платформа, ОТСУТСТВУЕТ в ежедневном ряду, а не присутствует как ноль; коэффициент без знаменателя равен null, никогда не бесконечен и никогда не равен нулю. Период сравнения - тот же…

Параметры
  • brandstring

    Идентификатор бренда (uuid) для отчёта. Если не указать, берётся бренд, выбранный в приложении autario (сохранённый в аккаунте выбор бренда); если ничего не выбрано - Default brand аккаунта, к которому уже относится каждый неназначенный коннектор. Каждый ответ перечисляет бренды вызывающего, поэтому первый вызов без этого аргумента подскажет, что передать дальше.

  • clientstring

    Устаревшее написание brand, всё ещё принимается, чтобы вызывающий код, написанный до 2026-09-22, продолжал работать. Передаёт brand.

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • fromstring

    День начала (YYYY-MM-DD), когда period имеет значение "custom". Непригодная пара откатывается к окну по умолчанию, а не выдаёт ошибку.

  • instancesstring

    Необязательные идентификаторы экземпляров коннекторов через запятую, чтобы сузить отчёт до части подключений внутри выбранного бренда (например, одного из двух ресурсов Search Console). Если не указать, берутся все. Идентификатор, который не ваш или не относится к этому бренду, выдаст ошибку, а не молча укороченный отчёт. Это идентификаторы экземпляров, которые get_app_context возвращает для этого приложения.

  • periodenum

    Окно отчётности. По умолчанию last-30. "this-week" идёт с понедельника по сегодня и сравнивает с теми же днями недели неделей раньше; "custom" требует from и to.

  • sectionsenum[]

    Какие разделы отчёта возвращать. По умолчанию ["overview"]. Запрашивайте только то, что нужно для ответа на вопрос (экономия токенов); при необходимости вызывайте снова.

  • tostring

    День окончания (YYYY-MM-DD), когда period равен "custom".

pct_changeтолько чтениеидемпотентный

Процентное изменение показателя от периода к периоду. Используется для темпов роста (YoY, QoQ, MoM) | «насколько быстро рос ВВП Германии», «что происходит с ИПЦ США от месяца к месяцу». Работает с любым проверенным показателем Autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • entitystringобязательный

    Сущность, для которой считывается серия: код страны ISO 3166 alpha-3, например "DEU" или "USA", либо агрегированный код, например "WLD" или "EUU" (каноническое название тоже совпадает). Используйте коды, которые принимают list_indicators и get_entity_profile.

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • indicatorstringобязательный

    Идентификатор индикатора числового ряда, ровно такой, какой возвращают list_indicators или get_entity_profile (публичный индикатор либо ваша собственная загрузка или таблица коннектора).

  • periodstring

    yoy | qoq | mom (по умолчанию: yoy)

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

projects

Projects | СОБСТВЕННАЯ доска проектов вызывающего с её целями и ключевыми результатами, читается и записывается детерминированно (без LLM на этом пути): что команда договорилась достичь, над чем она работает, кто над этим работает, насколько продвинулась работа и в какой ключевой результат вносит вклад каждая работа. Вызывайте её для вопросов «над чем работает моя команда», «какой ключевой результат не имеет проекта за собой», «какой вклад вносит маркетинг», «какие проекты отстают от плана», «что не решено», а также чтобы добавить или переместить проект, цель или ключевой результат. PROJECTS: «list» сворачивает доску по ОДНОЙ оси: group = okr (по умолчанию) | country | function | person. По person проект появляется у владельца и у каждого участника; по остальным осям - один раз. Если по оси ничего не задано, проект попадает в ИМЕНОВАННУЮ группу («No country set») и никогда не теряется. Нерешённые проекты возвращаются в inbox. «get» возвращает один проект с вехами и KPI; «create» добавляет проект; «update» изменяет проект (этап, прогресс, светофор, даты, родителя, бюджет, трудозатраты, влияние, key_result_id). Проект содержит целевую дату (формулировка срока выводится при чтении), родителя (не более трёх уровней), зависимости (blocked_by), бюджет в собственной валюте (не конвертируется), трудозатраты в днях и влияние от 1 до 5; sort = effort_impact сортирует сначала по влиянию, затем по трудозатратам, без вычисления оценки. OBJECTIVES: «objectives» возвращает каждую цель с её ключевыми результатами: значение, source (dataset или вручную), ВЫЧИСЛЯЕМЫЙ статус (on track, at risk, off track, no data yet; вычисляется из базового и целевого значений, направления и оставшегося времени, никогда не задаётся вручную, а отсутствие значения никогда не считается on track), ограничители, историю целевых значений и стоящие за ней проекты. «create_objective» требует title; «update_objective» требует id; «create_key_result» требует objective_id, title, target (или country_values); «update_key_result» требует id. Изменение целевого значения требует target_reason (не менее десяти символов) и сохраняется в истории, которую ничто не перезаписывает. Ключевой результат может нести значения по странам (country_values) и указывает, как они суммируются (aggregation); с…

Параметры
  • actionenum

    Что делать. По умолчанию "list".

  • aggregationenum

    Для ключевых результатов: как страны складываются в регион. sum (по умолчанию) для подсчётов и денег, average для ставок и уровней, none перечисляет страны без итога.

  • baselinenumber

    Для ключевых результатов: с какого значения начинался показатель. Достижение идёт от базового значения к целевому.

  • briefstring

    Короткое описание того, что это за проект.

  • budget_amountnumber

    Budget. Требует budget_currency. Никогда не конвертируется между валютами.

  • budget_currencystring

    Трёхбуквенный код валюты бюджета, например EUR.

  • commitmentenum

    Для целей: committed (ожидается на уровне 1.0) или aspirational (0.7 - хороший результат). Изменяет правило статуса её ключевых результатов, но никогда не число.

  • contributorsstring[]

    Все остальные, кто над этим работает. Ось person группирует по этим именам вместе с владельцем.

  • countrystring

    Регион или страна, которая управляет им, в формулировке самого аккаунта ("DACH", "Nordics"), а не код ISO.

  • country_columnstring

    Для ключевых результатов с dataset_id: столбец, который называет страну строки (autario_entity, когда он есть в наборе данных). Затем value_column считывается по каждой стране; страна, которой нет в наборе данных, сохраняет своё типизированное значение.

  • country_valuesobject[]

    Для ключевых результатов: значение по каждой стране, [{ country, current, target }]; country задаётся названием или кодом ISO. Итог по региону использует эти значения; несколько стран без значений никогда не разбиваются.

  • dataset_idstring

    Для ключевых результатов: датасет, из которого читается значение (любой датасет в этом аккаунте).

  • directionenum

    Для ключевых результатов: что лучше - больше или меньше. По умолчанию: увеличение.

  • effort_daysnumber

    Оценка трудозатрат в человеко-днях.

  • ends_onstring

    Для целей: конец этого окна, YYYY-MM-DD.

  • filter_columnstring

    Для ключевых результатов: необязательный столбец, по которому фильтруется набор данных.

  • filter_valuestring

    Для ключевых результатов: значение filter_column должно иметь.

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • functionstring

    Функция, которая его вносит ("Marketing", "Supply chain").

  • groupenum

    Для "list": по какой оси сворачиваются карточки. По умолчанию "okr" - это ось, которая отвечает на вопрос: «работает ли всё, что мы делаем, на то, о чём мы договорились?»

  • guardrail_notestring

    Для ключевых результатов: как к этому числу можно прийти неправильным путём.

  • guards_idstring

    Для ключевых результатов: делает этот ключевой результат ОГРАНИЧИТЕЛЕМ того ключевого результата.

  • idstring

    Идентификатор объекта для чтения или изменения: проект для "get" и "update", цель для "update_objective", ключевой результат для "update_key_result".

  • impactenum

    Ожидаемое влияние как оценка: 1 низкое, 2 некоторое, 3 явное, 4 высокое, 5 очень высокое.

  • key_result_idstring

    Идентификатор ключевого результата, в который этот проект вносит вклад. "list" возвращает доступные для привязки элементы из key_results; передайте одно из их значений id. Не указывайте для работы, которая пока не вносит вклад ни в один ключевой результат: именно это ось OKR и делает видимым.

  • kindenum

    Это проект с завершением или повторяющаяся повседневная работа? По умолчанию: "project".

  • manual_valuenumber

    Для ключевых результатов: текущее значение, введённое вручную. Отображается так, как введено вручную; предпочтительнее dataset_id + value_column.

  • objective_idstring

    Для "create_key_result": цель, к которой он относится. "objectives" перечисляет их.

  • ownerstring

    Единственный человек, который за это отвечает.

  • parent_idstring

    Проект, в состав которого входит этот. Проекты вкладываются не глубже трёх уровней (программа, рабочий поток, часть); перемещение, которое создало бы четвёртый уровень или цикл, отклоняется с сообщением в одно предложение. Прогресс родителя, если у родителя нет собственного прогресса, равен среднему по его дочерним элементам, и об этом сообщается.

  • progress_pctinteger

    Прогресс в процентах, от 0 до 100, устанавливает человек. Никогда не выводится из этапов или дат.

  • resources_urlstring

    Ссылка на то, где на самом деле ведётся работа (папка на диске, доска, документ). Только http(s).

  • sortenum

    Для "list": порядок карточек внутри каждой группы. "board" (по умолчанию) ставит работу, вышедшую из графика, на первое место; "effort_impact" сортирует по impact (от 5 к 1), затем по effort (сначала меньше дней), работа без оценки идёт последней. Сводный балл не рассчитывается.

  • spent_amountnumber

    Уже потраченные деньги, введённые человеком, в budget_currency.

  • stageenum

    Текущее состояние. Новый проект стартует в статусе "active" (выполняется); когда владелец доски включил "New projects need admin approval", новый проект пользователя без прав администратора стартует в "inbox" (ожидает проверки), и только администратор выводит его оттуда. "long_list" = согласован, но не начат; "done" = завершён.

  • started_atstring

    Дата начала YYYY-MM-DD

  • starts_onstring

    Для целей: начало окна, относительно которого рассчитывается темп их ключевых результатов, YYYY-MM-DD.

  • statusenum

    Светофор, который выставляет человек: в графике, под угрозой, вне графика.

  • targetnumber

    Для ключевых результатов: число, которое засчитывается как выполненное. Обязательно при создании.

  • target_datestring

    Целевая дата, YYYY-MM-DD. "Осталось N дней" / "просрочено на N дней" вычисляется из неё при каждом чтении и никогда не хранится.

  • target_reasonstring

    Для «update_key_result»: почему цель сдвигается (десять символов или больше). Обязательно, когда меняется target; изменение сохраняется в истории ключевого результата.

  • titlestring

    Название проекта. Обязательно для "create".

  • unitstring

    Для ключевых результатов: единица измерения, в которой указано число.

  • value_columnstring

    Для ключевых результатов: столбец dataset_id, в котором хранится число.

publish_appидемпотентный

Публикует приложение, которым владеете ВЫ, на платном тарифе: на Free приложение остаётся приватным, и в ответ приходит 402 plan_required со ссылкой на апгрейд. Два способа публикации: "public" добавляет плитку в магазин приложений autario в разделе Community apps, рядом с AI Visibility 360 и источниками данных World Bank и FRED, плюс публичный URL, а "unlisted" даёт только URL, так что открыть его сможет любой, кому вы отправите ссылку, и больше никто его не найдёт. Каждая публикация сначала прогоняет проверку контента и отказывает, называя правило и строку: внешний скрипт, встроенный фрейм, форма, отправляющая данные куда-то ещё, редирект, рекламная или партнёрская ссылка, скрытый текст или текст, нацеленный на AI-агентов, в названии, слогане или манифесте. Дальше и unlisted, и public синхронно проходят ОДНУ AI-проверку контента на каждую версию контента (текст и код), а для публичного листинга приложение должно быть размещено на autario (upload_app_bundle): block возвращает причины (отредактируйте приложение и опубликуйте снова), review_unavailable значит, что надо попробовать позже. Возвращает public_url. Зрители читают данные через autario.js со своей ролью: посторонний видит только публичные данные каталога, участник команды, которого владелец пригласил в приложение (Account > Team), видит наборы данных, объявленные приложением. Учтите: опубликованное приложение намеренно НЕ индексируется поисковиками; только autario может добавить community-приложение в sitemap. Используйте, когда пользователь говорит, что приложением уже можно поделиться. unpublish_app отменяет публикацию и никогда не отклоняется.

Параметры
  • app_idstringобязательный

    Id приложения, которым вы владеете, как его возвращает create_app. Приложение, которым вы не владеете, отвечает not found.

  • visibilityenum

    "public" = отображается в магазине приложений. "unlisted" = доступно только по ссылке. По умолчанию: "public".

publish_chart

Публикует диаграмму через свободную спецификацию Plotly. Вместо этого используйте create_chart_from_spec, если только не нужна функция Plotly, которую не покрывает спецификация Builder (пользовательские фигуры, многоосевые макеты, кадры анимации). Требует AUTARIO_API_KEY. Правила атрибуции бренда и проверки выводов такие же, как для create_chart_from_spec.

Параметры
  • dataset_idsstring[]обязательный

    Массив UUID наборов данных, которые использует эта диаграмма. Autario извлекает реальные данные из этих наборов, чтобы гарантировать отсутствие галлюцинированных значений.

  • insightstring

    Инсайт по данным на 2-3 предложения с конкретными числами из запрошенных данных. Необходимо использовать проверенные числа из результатов query_dataset, а не из обучающих данных.

  • narrationstring

    Более подробное описание методологии анализа и контекста.

  • plotly_specobject

    Спецификация Plotly с массивом traces и объектом layout. В traces для ссылок на колонки используются x_col/y_col, а для фильтрации - group_by/group_value (например, {"traces": [{"x_col": "year", "y_col": "value", "group_by": "country", "group_value": "USA"}], "layout": {}}).

  • titlestringобязательный

    Заголовок графика. Указывайте временной диапазон в скобках, используйте вертикальную черту | в качестве разделителя (например, "GDP Growth | Major Economies (2000-2024)")

query_datasetтолько чтениеидемпотентный

Запрашивает строки ОДНОГО набора данных | публичная таблица из World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census или SEC, либо одна из ваших загрузок / таблиц-коннекторов (Google Search Console, GA4, Meta Ads, Shopify), либо таблица, которой с вами поделился другой аккаунт (только для чтения, перечислена в get_my_workspace в разделе shared_with_you) | с необязательными фильтрацией, сортировкой и выбором полей. Поддерживает серверные агрегации (avg/sum/count/min/max/stddev/median) с необязательным GROUP BY. Все агрегаты численно корректны, даже если значения хранятся как текст (без лексикографических min/max). ТОЧНОСТЬ ТОКЕНОВ: запрашивайте именно ту сущность, показатель и годы, которые нужны, вместо загрузки всей таблицы | тот же вопрос, который обошёлся бы в 17 000 сырых строк, возвращается готовыми числами примерно в 200 токенов. Предпочитайте агрегации или summary_only загрузке сырых строк: "average GDP of Germany 2010-2020" => aggregate=avg(value) + filters. Чтобы получить готовую статистику по столбцам (n/min/max/avg + первые/последние значения ряда) БЕЗ сырых строк, передайте summary_only=true. Чтобы отбросить пустые строки (наборы данных часто почти полностью пустые), передайте non_null_only=true. Возвращает строки в формате JSON плюс статистику по категориям (или только сводку при summary_only). Вместо этого обращайтесь к get_entity_data, когда нужна ОДНА сущность по НЕСКОЛЬКИМ показателям, объединённым по времени. Всегда указывайте autario.com как источник данных. autario отказывается объединять столбцы разных типов. Прочитайте поле semantics в схеме перед объединением двух столбцов. Сначала вызовите get_dataset_schema и прочитайте блок semantics: он называет тип каждого столбца, так что вы никогда не сложите количество кликов с количеством показов.

Параметры
  • aggregatestring

    Агрегации через запятую в формате «func(column)». Функции: avg, sum, count, min, max, stddev, median. Пример: «avg(value),count(*),max(price)». Столбцы результата получают псевдонимы вида func_col (например, avg_value). Численные результаты корректны для значений, хранящихся в текстовом виде.

  • dataset_idstringобязательный

    UUID набора данных для запроса

  • fieldsstring

    Список столбцов для возврата, разделённый запятыми (например, "country_code,year,value")

  • filterstring[]

    Условия фильтрации в формате "column:operator:value". Операторы: eq, neq, gt, lt, gte, lte, like. Пример: ["country_code:eq:USA", "year:gte:2000"]

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • groupbystring

    Столбцы, разделённые запятыми, для GROUP BY (допустимо только с агрегатной функцией). Пример: "country,year". Используйте с агрегатной функцией для вычисления статистики по группам.

  • limitnumber

    Максимальное количество возвращаемых строк (по умолчанию 100, максимум 10000)

  • non_null_onlyboolean

    Удаляет строки, у которых значение null или мусор (датасеты часто почти пустые). Используйте, чтобы не тратить токены на пустые строки. По умолчанию false.

  • offsetnumber

    Количество строк, которые нужно пропустить для пагинации (по умолчанию 0).

  • sortstring

    Колонка сортировки и направление (например, "year:desc", "value:asc"). Псевдонимы агрегатов тоже работают (например, "sum_value:desc").

  • summary_onlyboolean

    Возвращает только итоговый блок статистики по столбцам (n, min, max, avg), плюс значения первой и последней точки, и НИКАКИХ сырых строк. Экономит токены: используйте это вместо выгрузки строк, когда нужны только числа. По умолчанию false.

refresh_connectorидемпотентныйвнешний мир

Забирает свежие показатели с одной подключённой платформы прямо сейчас и обновляет её таблицу Postgres, размещённую на Autario. Работает для любого коннектора, будь то Search Console, Shopify, рекламный кабинет или счёт за использование AI. Используйте, когда health.state имеет значение stale или never_ran, либо пользователь говорит "get the latest". Ответ - это завершённый запуск: status (refreshed | failed), rows, dataset_id и health с одним исходом на отчёт (delivered | empty | not_fetched, с фразой почему) и next_step. Пустой отчёт - не ошибка: у аккаунта нет таких данных. Он НЕ запускает прогон, который не поможет, а вместо этого объясняет почему: needs_sign_in (логин пропал, отдайте пользователю next_step.url), already_running или too_soon (один запуск на коннектор раз в 10 минут; retry_at подсказывает когда). Вызывайте его ОДИН раз на вопрос, никогда в цикле. Он не может менять настройки, отчёты, расписание или логин. connector_id берите из list_connectors. Детерминированная выборка, без затрат на LLM. Требует AUTARIO_API_KEY.

Параметры
  • connector_idstringобязательный

    Идентификатор экземпляра коннектора для обновления (из list_connectors).

regressionтолько чтениеидемпотентный

Линейная регрессия y ~ x для одного объекта. Возвращает наклон, точку пересечения, R² и интерпретацию. Используйте для вопросов вида "как X предсказывает Y?". Работает с любым проверенным индикатором autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • entitystringобязательный

    Сущность, для которой считывается ряд: код страны ISO 3166 alpha-3, например "DEU" или "USA", либо агрегированный код, например "WLD" или "EUU" (каноническое название тоже подходит). Используйте коды, которые принимают list_indicators и get_entity_profile.

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

  • xstringобязательный

    ID индикатора независимой переменной (предиктора)

  • ystringобязательный

    ID индикатора зависимой переменной (целевой)

report_data_issue

Сообщите о проблеме с качеством данных, которую вы нашли в наборе данных autario или на графике (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC или любой другой издатель в каталоге), чтобы движок мог её устранить. Используйте это при QA-проверке, когда замечаете: набор данных, который выглядит обрезанным / лишь частично загруженным (намного меньше строк, чем должен содержать источник), единицу измерения, которая противоречит диапазону значений (единица «%», а значения в тысячах), бессмысленные или неверные названия столбцов/рядов, столбец со всеми одинаковыми значениями (нулевая дисперсия), опубликованный график, который вводит в заблуждение или отображает не тот ряд, или данные, которые выглядят устаревшими. ОБЯЗАТЕЛЬНО указывайте конкретные числа, которые вы наблюдали, в evidence (например, количество строк, которое вы увидели, по сравнению с ожидаемым, единицу измерения, несколько примеров значений) | находки без доказательств бесполезны. Движок направляет безопасные типы (partial_ingest_suspected, stale, broken_time_col) на автоматическую повторную загрузку при следующем обновлении; всё остальное попадает в очередь ручной проверки. Повторное сообщение о той же нерешённой проблеме никогда не создаёт строку-дубликат: оно УЧИТЫВАЕТСЯ в существующей находке (occurrences в ответе), и как только об одной и той же проблеме сообщат три раза, она передаётся в очередь ручной проверки. Так что повтор безопасен, но он не остаётся незамеченным | сообщайте снова только в том случае, если вы снова наблюдали проблему. Требуется аутентификация.

Параметры
  • dataset_idstring

    UUID набора данных, к которому относится проблема (из search_datasets / get_dataset_info). Опускайте его только в случае проблемы на уровне графика, у которого нет единого основного набора данных.

  • detailstring

    Понятное человеку краткое описание проблемы одним предложением.

  • evidenceobject

    Конкретные числа, подтверждающие вывод, в виде JSON-объекта. Примеры: {"rows_seen": 500, "rows_expected": 15000, "source": "World Bank API has ~15k country-year rows"} или {"unit": "%", "value_range": [120, 9800]}. Обязательно для действенного вывода.

  • finding_typeenumобязательный

    Что за проблема. partial_ingest_suspected = строк меньше, чем в источнике (усечено). stale = данные старше, чем должны быть. broken_time_col = все строки имеют одну дату / столбец vintage используется как время. unit_mismatch = заявленная единица измерения противоречит числам. label = неправильные или бессмысленные имена столбцов или рядов. wrong_series = показан не тот или дублирующийся ряд. confusing_chart = опубликованный график вводит в заблуждение конечных пользователей. zero_variance = все значения идентичны. engine_gap = систематическая ошибка парсера/движка. moved/dead_source = URL источника изменился или возвращает 404.

  • severityenum

    Насколько это плохо для конечных пользователей. high = неверные/вводящие в заблуждение числа, показанные публично. По умолчанию medium.

request_chart

Запрос AUTARIO-INTERNAL на построение графика верхнего уровня (только для администратора): сервер строит Plotly-график по данным из каталога (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC). Спецификацию вы НЕ собираете, а вот insight ПИШЕТЕ. Чтобы попасть с первой попытки, действуйте в два шага: (1) PREPARE - вызовите с dataset_id/query и БЕЗ insight; сервер детерминированно собирает график и возвращает charted_entities (точный набор сущностей, по которым построен график, каждая со значениями latest/peak/trough/average) и chart_type, НЕ публикуя его. ВАЖНО: мультистрановой набор данных строится как СЕМЕЙСТВО СУЩНОСТЕЙ (крупнейшие экономики, G7, агрегированные строки...), поэтому insight проверяется ТОЛЬКО по сущностям, которые реально есть в charted_entities. Привязывайте каждое утверждение к одной из ЭТИХ сущностей и ссылайтесь только на значения именно этих сущностей. (2) PUBLISH - повторно вызовите с тем же dataset_id/query и вашим insight на 2-3 предложения; сервер сверяет его с реальными данными (защита от выдуманных чисел) и публикует, возвращая URL. Сервер сам НЕ запускает LLM (insight пишете вы). Один запрос = один график. При отклонении возвращается 422 с указанием, КАКОЕ число/утверждение не прошло, а также charted_entities и доступные якоря, чтобы вы исправили всё за один шаг. Используйте ИМЕННО ЭТО вместо create_chart_from_spec, когда нужен «хороший график для этого набора данных/темы», без сборки полной спецификации Builder. Ключи без прав адмнистратора получают 403; сторонние пользователи работают через create_chart_from_pec / publish_art.

Параметры
  • chart_typestring

    ОПЦИОНАЛЬНАЯ подсказка (line | bar | snapshot). Сервер по-прежнему принимает окончательное решение о типе графика на основе структуры данных; это лишь мягкое предпочтение.

  • dataset_idstring

    UUID датасета для построения графика (из search_datasets / discover_by_topic / list_chart_candidates). Предпочтителен, когда вы уже знаете датасет.

  • insightstring

    Ваше аналитическое заключение по данным из 2-3 предложений. ПРОПУСТИТЕ ЕГО в вызове PREPARE, чтобы сначала получать charted_entities + anchors; ОТПРАВЬТЕ ЕГО в вызове PUBLISH для проверки и публикации. Каждая указанная цифра ОБЯЗАНА быт ь одним из значений для кажой сущности в charted_entities (latest/peak/trоugh/аverage), возвращённых вызовом prepare. Сервер проверяет её по реалным данным и публикует при успехе, либо возвращат непрошедшие проверку значения + charted_entities + anchors при неудаче. Сервер НЕ пишет это за вас.

  • querystring

    Строка темы или поиска в свободной форме, которую сервер сопоставляет с лучшим набором данных для построения графиков (например, «мировая инфляция», «уровень безработицы в США»). Используйте её вместо dataset_id, когда известна только тема. Если указаны оба параметра, приоритет у dataset_id.

  • regionstring

    НЕОБЯЗАТЕЛЬНАЯ подсказка для фокусировки набора данных по нескольким странам на регионе или сущности (например, "G7", "Europe"). Мягкое предпочтение; сервер выбирает итоговый набор сущностей.

  • timestring

    НЕОБЯЗАТЕЛЬНАЯ подсказка по временному диапазону (например, «2010-2024»). Мягкое предпочтение: сервер использует фактический диапазон данных.

rolling_statsтолько чтениеидемпотентный

Статистика скользящего окна (среднее, стандартное отклонение, минимум, максимум, сумма) для индикатора. Сглаживает шум, выявляет тренды | используйте перед тем, как заявлять о развороте в месячном ряду FRED или Eurostat. Работает с любым проверенным индикатором autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • entitystringобязательный

    Сущность, для которой считывается ряд: код страны ISO 3166 alpha-3, например "DEU" или "USA", либо агрегированный код, например "WLD" или "EUU" (каноническое название тоже подходит). Используйте коды, которые принимают list_indicators и get_entity_profile.

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • indicatorstringобязательный

    Идентификатор индикатора числового ряда, ровно такой, какой возвращают list_indicators или get_entity_profile (публичный индикатор либо ваша собственная загрузка или таблица коннектора).

  • opstring

    mean | std | min | max | sum (по умолчанию: mean)

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

  • windownumber

    Размер окна в периодах (2-100, по умолчанию 5)

search_datasetsтолько чтениеидемпотентный

Ищет в каталоге данных Autario по ключевому слову | тысячи нормализованных публичных наборов данных от World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census и SEC, плюс ваши собственные загрузки и таблицы коннекторов (Google Search Console, GA4, Meta Ads, Google Ads, YouTube, TikTok, Instagram, Facebook, Shopify, LinkedIn, Bing). Возвращает идентификаторы наборов данных, заголовки, описания, категории, издателей, количество строк, last_refreshed_at И доверенные поля онтологии (topic, subtopic, unit, frequency, entity_type, indicator_id), когда уверенность онтологии высока. Аутентифицированные вызывающие клиенты (API key / OAuth) также находят свои СОБСТВЕННЫЕ приватные наборы данных (uploads, write_rows, connectors); приватные данные других пользователей не возвращаются никогда. Сначала используйте этот инструмент, чтобы обнаружить доступные наборы данных перед запросом. Для точной фильтрации по теме, единице измерения и частоте по всему каталогу предпочтительнее list_indicators. Для ТЕМАТИЧЕСКОГО исследования статей предпочтительнее discover_by_topic, который добавляет ранжирование по уровню качества и примеры фактов. ТОЧНОСТЬ ТОКЕНОВ: запрашивайте ровно ту сущность, показатель и годы, которые нужны, вместо загрузки таблицы | тот же вопрос, который стоил бы 17 000 сырых строк, возвращается готовыми числами примерно за 200 токенов.

Параметры
  • categorystring

    Фильтровать по категории. Варианты: "Финансы и экономика", "Торговля", "Технологии", "Здоровье и общество", "Энергетика", "Окружающая среда", "Демография", "Образование", "Инфраструктура".

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • limitnumber

    Максимальное количество возвращаемых результатов (по умолчанию: 30, максимум: 30).

  • pagenumber

    Номер страницы для постраничной навигации (по умолчанию 1)

  • querystring

    Поисковый термин для сопоставления с названиями наборов данных, их описаниями и ключевыми словами (например, "GDP growth", "CO2 emissions", "unemployment rate")

  • visibilityenum

    Какие наборы данных искать: только каталог "public", только "private" (только ваши собственные наборы данных), "both". По умолчанию: "both" при аутентификации, в противном случае "public". Приватные наборы данных других пользователей никогда не возвращаются.

seasonality_decompositionтолько чтениеидемпотентный

Аддитивное разложение Y = тренд + сезонность + остаток. Убирает сезонный цикл из ряда и выявляет основной тренд | отлично подходит для месячных или квартальных данных (розничные продажи, безработица). Возвращает компоненты для каждого момента времени и суммарную амплитуду. Работает с любым проверенным индикатором autario (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC).

Параметры
  • entitystringобязательный

    Сущность, для которой считывается серия: код страны ISO 3166 alpha-3, например "DEU" или "USA", либо агрегированный код, например "WLD" или "EUU" (каноническое название тоже совпадает). Используйте коды, которые принимают list_indicators и get_entity_profile.

  • fullboolean

    Возвращает полный необработанный временной ряд (тяжело, много токенов). По умолчанию false → вы получаете только сводку/статистику, которой достаточно, чтобы ОТВЕТИТЬ на вопрос. Устанавливайте true только тогда, когда нужно построить график или экспортировать каждую точку.

  • indicatorstringобязательный

    Идентификатор индикатора числового ряда, ровно такой, какой возвращают list_indicators или get_entity_profile (публичный индикатор либо ваша собственная загрузка или таблица коннектора).

  • periodnumber

    Сезонный период в шагах времени (12=месячный, 4=квартальный, 7=недельный). Автоматически определяется из частоты индикатора, если не указан.

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

seo_360только чтениеидемпотентный

SEO 360 | СОБСТВЕННЫЙ детерминированный ACTION-отчёт Google Search Console; вычисляется на сервере из подключённых данных GSC (те же точные числа, которые пользователь видит в приложении | ничего не пересчитывается, ничего не оценивается). Единица данных: пара (запрос, страница), и КАЖДАЯ строка завершается конкретным действием, поэтому вызывайте этот инструмент, когда пользователь спрашивает «что мне писать дальше», «какую страницу исправить в первую очередь», «где я теряю клики», «как развиваются мои позиции», «какие страницы деградируют», «как у меня дела с Core Web Vitals», «какие технические SEO-проблемы есть на моём сайте». Разделы: page2_gaps (пары с позициями 8-20, отсортированные по потенциальному приросту кликов до топ-3 | основной список «написать или улучшить»), ctr_underperformers (страница в топ-10, но сниппет не получает клик | работа над title/description), orphan_demand (запросы со спросом, у которых лучшая страница не по теме | страницы нет, напишите её), cannibalization (один запрос размазан по нескольким страницам | объедините или разведите), trends (победители/проигравшие по кликам И по позициям относительно прошлого окна, с явной пометкой, когда прошлое окно неполное), rank_tracking (ряды позиций топовых и закреплённых запросов с текущими значениями и дельтами за 7д/28д, распределение позиций Top3/4-10/11-20/21+, индекс share-of-voice, разбивка по брендовым и небрендовым запросам), decay (очередь на обновление: страницы, теряющие клики несколько окон подряд, отсортированные по потерянным кликам, с опциональным пересчётом в EUR на основе собственной настройки пользователя «ценность клика»), vitals (полевые данные p75 по Core Web Vitals из Chrome UX Report для топовых страниц, со статусом «прошло/не прошло» по каждому из LCP/INP/CLS), audit (ограниченный снимок обхода собственного сайта: битые ссылки, цепочки редиректов, проблемы с title/description, конфликты noindex/canonical, страницы-сироты, сравнение новых и исправленных проблем, возможности для внутренних ссылок), health (покрытие данных, устаревание, какой источник CTR-бенчмарка применяется). CTR-бенчмарк это медиана собственных данных пользователя по каждой группе позиций, с документированной стандартной кривой как запасным вариантом для малочисленных групп. Глубже, чем audience_360 (который…

Параметры
  • brandstring

    Идентификатор бренда (группировки коннекторов), по которому строится отчёт, в формате uuid. Если не указан, берётся бренд, выбранный в приложении autario (сохранённый в аккаунте выбор бренда), поэтому вы видите то же, что и пользователь на экране; если бренд не выбран, то все бренды аккаунта. Бренд, который не ваш, возвращает ошибку и никогда не отдаёт показатели другого бренда.

  • daysinteger

    Окно анализа задается в днях (7-90, по умолчанию 28) и заканчивается на самом новом дне данных вызывающего. Для сравнения тренда используется окно такой же длины, расположенное непосредственно перед ним.

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • instancesstring

    Необязательные идентификаторы экземпляров коннекторов через запятую, чтобы сузить отчёт до части подключений внутри выбранного бренда (например, одного из двух ресурсов Search Console). Если не указать, берутся все. Идентификатор, который не ваш или не относится к этому бренду, выдаст ошибку, а не молча укороченный отчёт. Это идентификаторы экземпляров, которые get_app_context возвращает для этого приложения.

  • sectionsenum[]

    Какие разделы отчёта возвращать. По умолчанию: ["page2_gaps","health"]. Запрашивайте только то, что нужно для ответа (экономия токенов); при необходимости вызывайте снова.

social_360только чтениеидемпотентный

Social 360 | СОБСТВЕННЫЙ детерминированный отчёт вызывающего о социальных показателях по данным его подключённых Facebook Page, Instagram, TikTok, YouTube, LinkedIn и Threads, который считается на сервере (те самые числа, что пользователь видит в приложении, ничего не оценено). Вызывайте его для вопросов «как дела у моих соцсетей», «какой пост сработал лучше всех», «какого формата стоит публиковать больше», «из-за чего подскочили подписчики», «сколько из этого пришло из рекламы», «как я выгляжу на фоне конкурентов». Разделы: score (индекс 0-100 по каждой платформе плюс смешанный показатель с весом по охвату, построенный из коэффициента вовлечённости к охвату, роста подписчиков и регулярности публикаций, в сравнении с СОБСТВЕННОЙ историей аккаунта; часть, которую платформа не может отдать, отбрасывается, но никогда не обнуляется), explorer (каждый канал в виде дневных рядов по каждому KPI, который отдаёт его платформа, матрица поддержки с указанием ПОЧЕМУ KPI отсутствует, по каждому каналу суммы платного охвата и платных взаимодействий из Meta Ads за окно, а также разбивки Instagram: просмотры по типам контента, включая его тип Ads, просмотры и охват по подписчикам и не подписчикам, взаимодействия по типам контента, ответы на stories, репосты, нажатия на кнопку контакта), posts (топ постов с сортировкой по вовлечённости, охвату, просмотрам, лайкам, комментариям, репостам, сохранениям и коэффициентам к охвату; бенчмарк по форматам; частота против вовлечённости; эффективность против медианного поста того же формата; посты Instagram с репостами, подписками, посещениями профиля и долей пропусков reels; stories в виде строк формата STORY с ответами, переходами по ссылкам и навигацией; ПЛАТНОЕ ПРОТИВ ОРГАНИЧЕСКОГО: пост, который продвигает реклама Meta, несёт paid=true, paidReach, paidInteractions и кампанию рядом со своими органическими числами, а пост, который не называет ни одна реклама, органический по факту), geo (официальные разбивки по странам: демография Instagram, география YouTube; плюс возраст подписчиков, пол и топ городов), spikes (необычные дни по подписчикам или охвату, где посты из этого окна идут как КАНДИДАТЫ, но никогда как заявленная причина), peers (Вы против отслеживаемых публичных аккаунтов: разрыв по подписчикам, гонка роста, частота публикаций, публичная вовлечённость), findings (детерминированный список works / needs-attention,…

Параметры
  • brandstring

    Идентификатор бренда (группировки коннекторов), по которому нужен отчёт, в виде uuid. Если не указан, берётся бренд, выбранный в приложении autario (выбор бренда, сохранённый в аккаунте), так вы видите то, что пользователь видит на экране; если бренд не выбран, все бренды аккаунта. Бренд, который не ваш, возвращает ошибку, но никогда не цифры другого бренда.

  • daysinteger

    Окно анализа в днях (7-90, по умолчанию 28). Каждая платформа привязывает его к самому свежему дню СОБСТВЕННОЙ таблицы коннекторов, потому что коннекторы обновляются с разной периодичностью.

  • formatenum

    Формат выходных данных для этого вызова MCP. По умолчанию: 'toon' (Token-Oriented Notation, меньше всего токенов, лучше всего подходит для табличных строк). 'compact' = минифицированный JSON. 'json' = форматированный JSON для удобства чтения. REST API всегда возвращает JSON независимо от выбранного формата.

  • instancesstring

    Необязательные идентификаторы экземпляров коннекторов через запятую, чтобы сузить отчёт до части подключений внутри выбранного бренда (например, одного из двух ресурсов Search Console). Если не указать, берутся все. Идентификатор, который не ваш или не относится к этому бренду, выдаст ошибку, а не молча укороченный отчёт. Это идентификаторы экземпляров, которые get_app_context возвращает для этого приложения.

  • sectionsenum[]

    Какие разделы отчёта возвращать. По умолчанию ["score","health"]. Запрашивайте только то, что нужно для вопроса (экономия токенов); вызывайте снова, если нужно больше. activity = таблица активности: каждый пост с платформой, типом контента, темой, типом поста, тональностью и языком, сводные таблицы по измерениям и группы (платформа, тип контента, тема, язык), которые превышают медиану платформы; метки берутся из собственного запуска классификации пользователя.

  • sortenum

    Как ранжируется кросс-платформенный список топ-постов (раздел постов). Вовлечённость по умолчанию. Три показателя ранжируют только те посты, для которых платформа их передаёт (сегодня Instagram).

unpublish_appидемпотентный

Возвращает приложение, которым ВЫ владеете, в приватный режим: оно исчезает из autario app store, его публичный URL перестаёт работать для всех остальных, и только вы можете открывать его по URL предпросмотра, где оно продолжает читать данные World Bank, FRED и коннекторов, как и раньше. Ничего не удаляется, а publish_app возвращает его обратно. Используйте его, когда пользователь хочет убрать приложение из магазина или перед публикацией изменения, которое не хочет показывать посторонним.

Параметры
  • app_idstringобязательный

    Id приложения, которым вы владеете, как его возвращает create_app. Приложение, которым вы не владеете, отвечает not found.

update_app_manifestидемпотентный

Обновляет манифест приложения, которым владеете ВЫ: его название, слоган, входной URL, версию, репозиторий исходного кода и наборы данных или операции autario, которые ему разрешено читать (consumed_datasets, который sandbox bridge применяет во время выполнения: идентификатор набора данных World Bank или FRED, операция котировки Yahoo в реальном времени или собственные таблицы коннектора Google Search Console и GA4 вызывающей стороны). Меняются только переданные вами поля; всё остальное в манифесте сохраняется. Позволяет объявить доступ к данным после create_app, объявить, что отчётами приложения можно делиться по секретной ссылке (share), или переименовать или перенаправить существующее приложение. Приложение, которым вы не владеете, отвечает "not found". Это никогда не меняет, кто может открыть приложение: публикация - это publish_app, намеренно отдельное действие.

Параметры
  • app_idstringобязательный

    Идентификатор приложения, который возвращает create_app.

  • consumed_datasetsobject[]

    Что читает приложение, например [{"op":"datasetData","dataset":"<id>"}]. Sandbox bridge отклоняет любое чтение, которое манифест не объявил. Чтобы прочитать подключённые аккаунты того, кто открывает приложение, добавьте ключи коннекторов: [{"op":"connectors","providers":["google_search_console","ga4"]}] | эти провайдеры затем появляются на вкладке Settings приложения с состоянием подключения этого пользователя, так что пользователь, который не подключил какой-либо из них, может подключить его прямо из приложения. Добавьте "optional": true и "unlocks":"<что это добавляет>" для источника, без которого приложение работает.

  • entry_urlstring

    Где запускается приложение. Загруженный бандл использует стандартный "index.html".

  • namestring

    Новое отображаемое имя. Пропустите, чтобы сохранить текущее.

  • shareobject

    Разрешает открывать отчёт этого приложения по секретной ссылке только для чтения, например {"subjects":["account"],"sections":["meta","report"]}. "subjects" указывает, на ЧЬИ данные ведёт ссылка, и может называть только те виды, которые autario умеет разрешать ("account" = владелец ссылки, а именно это и нужно стороннему приложению); "sections" - это список, который ссылка может запросить, и всё, что за его пределами, отклоняется. Пропустите ключ, чтобы не менять текущую настройку. Приложение, которое никогда это не объявляло, вообще нельзя расшарить. Владелец по-прежнему решает для каждой ссылки, кто может её открыть: любой, у кого есть URL, только авторизованные пользователи из указанных доменов компании или только указанные адреса.

  • source_urlstring

    Ссылка на репозиторий с открытым исходным кодом.

  • taglinestring

    Описание в одну строку, максимум 200 символов.

  • tierenum

    Runtime model. 2 = изолированное пользовательское приложение (по умолчанию для всего, что вы здесь создаёте). Устанавливайте это, только если вы точно знаете, что вам нужен 1.

  • versionstring

    Версия в свободной текстовой форме, например "1.2.0". Бандлы хранятся отдельно для каждой версии.

update_chartидемпотентный

Обновите существующий график, который вам принадлежит. Только API-ключ, создавший график, может его обновить. Используйте это, чтобы изменить спецификацию Plotly, заголовок или insight ранее опубликованного графика.

Параметры
  • chart_idstringобязательный

    Идентификатор графика или slug, возвращаемый publish_chart.

  • insightstring

    Обновлённый текст инсайта с проверенными цифрами.

  • narrationstring

    Обновлённое описание анализа.

  • plotly_specobjectобязательный

    Обновлённая спецификация Plotly с трейсами и макетом.

  • titlestring

    Обновлённый заголовок диаграммы

upload_app_bundleидемпотентный

Загружает или заменяет код приложения, которым владеете ВЫ: один входной документ (content: HTML или JavaScript, макс. 512 КБ) или набор файлов (files: index.html плюс JavaScript, CSS, изображения, шрифты и другие HTML-страницы, которые он загружает по относительному пути, макс. 50 файлов, по 1 МБ каждый, 2 МБ всего; изображения и шрифты в base64). Новая загрузка заменяет весь набор этой версии. autario хранит его и отдаёт внутри заблокированной песочницы без исходящего доступа к сети, поэтому приложение читает данные World Bank, FRED, Eurostat, SEC и коннекторов через autario.js (autario.query, autario.datasets, autario.artifacts), а не вызывает что-либо само; autario встраивает SDK прямо в отдаваемую страницу, поэтому тег script для https://autario.com/autario.js необязателен. Повторная загрузка той же версии заменяет её на месте. Его можно использовать, чтобы выпустить новую сборку приложения, созданного с помощью create_app, или исправить его после того, как пользователь сообщит о чём-то.

Параметры
  • app_idstringобязательный

    Id приложения, которым вы владеете, как его возвращает create_app. Приложение, которым вы не владеете, отвечает not found.

  • contentstring

    Сам входной документ (один HTML-файл) или index.html, если вы также отправляете файлы. Укажите content, files или и то и другое.

  • content_typeenum

    Тип содержимого, когда это единственный файл. По умолчанию text/html.

  • filesobject[]

    Многофайловое приложение: index.html и все файлы, которые оно загружает по относительному пути (например, "app.js", "css/style.css", "img/logo.png", "about.html"). Пути относительные, используйте "/", без "..". Допустимы: html, js, mjs, css, json, svg, png, jpg, webp, woff2. Максимум 50 файлов, 1 МБ каждый, 2 МБ в сумме. Добавьте index.html в этот список или передайте его как содержимое. Ссылки между HTML-страницами работают, каждая страница получает autario.js.

  • versionstring

    Необязательная метка версии, к которой относится этот бандл.

verify_valueтолько чтениеидемпотентный

Проверяет, что заявленное значение соответствует первоисточнику (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC). Используйте этот инструмент, когда пользователь спрашивает «не выдумал ли ты это?» или когда нужно перепроверить указнные вами цифры перед представлением. Передайте индикатор, сущность, время и ожидаемое значение. Возвращает, совпадает ли актуальное значение autario, с относительной разницей и происхождением данных. Если ваш time= соответствует более чем одному наблюдению (например, год в месячном ряду), вы получите reason="ambiguous_query" и перечень возможных наблюдений вместо вердикта: уточните time= и запросите снова, а не считайте какой-то один вариант ответом.

Параметры
  • entitystringобязательный

    Код сущности (например, DEU, USA, EUU)

  • expectednumber

    Значение, которое нужно проверить. Опустите, если нужна только проверка существования.

  • indicatorstringобязательный

    ID индикатора

  • timestringобязательный

    Период времени (например, «2023» или «2023-06»)

what_mattersтолько чтениеидемпотентный

Отвечает на вопрос «чем это объясняется?» одним вызовом: по заданной метрике результата и сущности ранжирует, какие другие метрики лучше всего объясняют результат. Если candidates не указан, автоматически выбирает кандидатов из онтологии (та же тема + entity_type), поэтому может охватывать серии World Bank, FRED, Eurostat, OECD, WHO и IMF, даже если вы их не называете. Возвращает рейтинг с метками уверенности (strong/suggestive/weak/inconclusive), пояснительными строками и подсказками sharpen-suggestions, указывающими на смежные области, которые ещё не включены. Частоты автоматически выравниваются по более крупному общему шагу - без завышенного числа наблюдений. Используйте этот инструмент вместо find_drivers, когда нужен ответ, пригодный для изложения.

Параметры
  • candidatesstring

    Необязательные идентификаторы индикаторов-кандидатов, разделённые запятыми. Если не указаны, автоматически выбирает из онтологии.

  • entitystringобязательный

    Код сущности (например, USA, DEU)

  • outcomestringобязательный

    Идентификатор индикатора итоговой метрики

  • timestring

    Необязательное временное окно. "2010-2023" оставляет период с 2010 по 2023 включительно, "2019-01-2024-06" работает помесячно, а одно значение "2015" оставляет с 2015 года и дальше. Если параметр пропущен или не разбирается, берётся весь ряд.

write_app_artifact

Сохраняет ARTIFACT в приложение: собственный вывод приложения или сохранённое состояние, принадлежащее вам. ARTIFACT - это то, что get_app_artifact считывает позже | спецификация графика Plotly, сохранённая конфигурация отчёта, доска, представление скринера, таблица показателей Всемирного банка или SEC, вычисленная приложением. Укажите type (своя метка, например "chart", "report", "board"), title и spec и/или data в формате JSON. Передайте artifact_id, чтобы обновить уже созданный элемент вместо создания нового. Используйте его сразу после create_app, чтобы наполнить приложение реальными данными, или когда пользователь просит сохранить представление. Вы можете записывать в любое приложение, которое можете открыть; чужое приватное приложение отвечает 'not found'.

Параметры
  • app_idstringобязательный

    Приложение, которому принадлежит артефакт.

  • artifact_idstring

    Пропустите, чтобы СОЗДАТЬ. Укажите идентификатор существующего артефакта, чтобы применить PATCH к нему.

  • dataobject

    Необязательные встроенные данные, относящиеся к артефакту.

  • specobject

    Сохранённое представление/конфигурация в формате JSON (например, спецификация Plotly, набор фильтров).

  • titlestring

    Человекочитаемый заголовок, отображаемый в приложении и в get_app_artifact.

  • typestring

    Своя метка для типа артефакта, например "chart", "report", "board". Обязательна при создании.

  • visibilityenum

    Кто может читать артефакт. По умолчанию private.

write_rows

Добавляет строки данных в существующий набор данных, которым вы владеете (созданный через create_dataset) | ваши собственные числа, производная таблица, которую вы вычислили, или ряд, собранный из результатов World Bank / FRED / Eurostat. Схема автоматически определяется по первой партии. Все значения хранятся в текстовом виде. Максимум 10 000 строк за один вызов; для более крупных наборов данных используйте несколько вызовов. Требуется AUTARIO_API_KEY.

Параметры
  • dataset_idstringобязательный

    UUID набора данных, в который нужно добавить строки.

  • rowsobject[]обязательный

    Массив объектов-строк, где ключи - имена столбцов (например, [{"country": "USA", "year": "2024", "value": "25000"}])

2.31.0основная
2.30.0
2.29.0
2.28.0
2.26.0
2.23.0
2.22.0
2.21.3
2.21.2
2.21.1
2.19.1
2.19.0
2.18.0
2.15.0
2.14.0
2.12.3
2.12.2
2.12.1
2.12.0
2.11.5
2.11.3
2.11.2
2.11.1
2.11.0
2.10.0
2.9.0
2.8.0
2.7.0
2.6.3
2.6.2
2.6.1
2.6.0
2.5.0
2.4.0
2.2.0
2.1.0
2.0.0
1.0.0

Выберите клиент, чтобы установить Autario/autario-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "autario-autario-mcp-03admzw5bq": {
      "command": "npx",
      "args": [
        "autario-mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "autario-autario-mcp-03admzw5bq": {
      "command": "npx",
      "args": [
        "autario-mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "autario-autario-mcp-03admzw5bq": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "autario-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"autario-autario-mcp-03admzw5bq\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"autario-mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "autario-autario-mcp-03admzw5bq": {
      "command": "npx",
      "args": [
        "autario-mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add autario-autario-mcp-03admzw5bq -- npx autario-mcp

Либо через JSON-конфиг:

claude mcp add-json autario-autario-mcp-03admzw5bq "{\"command\":\"npx\",\"args\":[\"autario-mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add autario-autario-mcp-03admzw5bq -- npx autario-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.autario-autario-mcp-03admzw5bq]
command = "npx"
args = ["autario-mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите Autario/autario-mcp, а в поле команды запуска — строку ниже:
npx autario-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "autario-autario-mcp-03admzw5bq": {
      "command": "npx",
      "args": [
        "autario-mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "autario-autario-mcp-03admzw5bq": {
      "command": "npx",
      "args": [
        "autario-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например autario-autario-mcp-03admzw5bq.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: autario-autario-mcp-03admzw5bq
    command: npx
    args:
      - "autario-mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "autario-autario-mcp-03admzw5bq": {
      "command": "npx",
      "args": [
        "autario-mcp"
      ]
    }
  }
}

Похожие MCP-сервера

musharna/data-aggregator-mcp

musharna/data-aggregator-mcp

от musharna

Объединяет поиск и загрузку исследовательских данных из 12+ источников (Zenodo, NCBI, PubMed) через единую модель. Полезен ученым, работающим с омиксными данными, публикациями и ML-датасетами — оди...

Python⭐ 4
takashiishida/arxiv-latex-mcp

takashiishida/arxiv-latex-mcp

от takashiishida

MCP сервер для доступа к LaTeX-исходникам arXiv. Точная обработка математических формул отличает его от PDF. Предоставляет инструменты: полный текст, абстракт, разделы статьи. Полезен для работы с научными публикациями в Claude, Cursor и других.

Python⭐ 148
carrierone/verilexdata-mcp

carrierone/verilexdata-mcp

от carrierone

MCP сервер Verilex Data открывает AI-агентам доступ к 20 структурированным датасетам: государственные данные (SEC, NPI, погода), крипто-аналитика (DeFi, OFAC, киты) и prediction markets. Полезен разработчикам и аналитикам. Оплата через USDC по запросу.

TypeScript⭐ 1
2s-io/sdk

2s-io/sdk

от 2s-io

MCP сервер 2s.io даёт AI-агентам доступ к 350+ API-эндпоинтам с оплатой за вызов в USDC. Есть бесплатные пробные запросы и встроенная безопасность. Полезен разработчикам, которым нужны реальные данные из разных сфер.

TypeScript⭐ 8
8enSmith/mcp-open-library

8enSmith/mcp-open-library

от 8ensmith

MCP-сервер для поиска книг и авторов через Open Library API. Позволяет AI-ассистентам искать книги по названию, авторов по имени, получать обложки и фото. Полезен разработчикам, интегрирующим катал...

TypeScript⭐ 96
street1983nk/infranode

street1983nk/infranode

от street1983nk

MCP-сервер для открытых данных инфраструктуры Германии: 45 инструментов для погоды, транспорта, экологии, экономики и демографии 84+ городов. Без API-ключа и установки - полезен разработчикам и ана...

Python⭐ 14
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин