Поделиться через

SuperMCP (предварительная версия)

SuperMCP по суперметрикам — сервер MCP (протокол контекста модели) предоставляет доступ к маркетинговым данным с подключенных платформ, таких как Google Analytics, Facebook Ads, Google Ads и многое другое.

Этот API позволяет LLM запрашивать маркетинговые данные, обнаруживать источники данных и учетные записи, изучать доступные поля и получать метрики производительности.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Суперметрики
URL https://supermetrics.com
Метаданные коннектора
Publisher Суперметрики
Веб-сайт https://supermetrics.com
Политика конфиденциальности https://supermetrics.com/privacy
Категории Маркетинг

Настраиваемый соединитель SuperMCP (Суперметрики)

Этот соединитель позволяет Microsoft Power Automate, Power Apps и Azure Logic Apps запрашивать маркетинговые данные через SuperMCP (сервер MCP суперметрики).
Используйте его для обнаружения источников данных и учетных записей, изучения доступных полей и выполнения маркетинговых запросов производительности.

Publisher

Supermetrics

Тип соединителя

Настраиваемый соединитель (Swagger/OpenAPI 2.0)

Служба или API

API SuperMCP (сервер MCP)

  • Хозяин:mcp.supermetrics.com
  • Базовый путь:/
  • Схема:https

Предпосылки

Вам потребуется:

  • Среда Power Automate или Power Apps, в которой можно создавать настраиваемые соединители
  • Учетная запись Суперметрики с по крайней мере одним подключенным источником данных (например, Google Analytics, Google Ads, Facebook Ads и т. д.). Если у вас нет учетной записи Суперметрики, одна с 14-дневной пробной версией будет создана при первом входе.

Authentication

Этот соединитель использует OAuth 2.0.

Поддерживаемые операции

Открытие

  • Обнаружение доступных источников данных Суперметрики (POST /mcp/data_source_discovery)
  • Обнаружение учетных записей источника данных (POST /mcp/accounts_discovery)
  • Обнаружение доступных полей (POST /mcp/field_discovery)

Запрос данных

  • Выполнение асинхронного запроса данных (POST /mcp/data_query)
    • Возвращает значение schedule_id
  • Получение асинхронных результатов запроса (POST /mcp/get_async_query_results)
    • schedule_id Использование результатов до возврата результатов

Служебные программы и ресурсы (обычно расширенная видимость)

  • Получение сегодня (UTC) (POST /mcp/get_today)
  • Проверка работоспособности (GET /mcp/resources/health)

Support

Лицензия

Собственные — © суперметрики

Ограничения регулирования

Имя Вызовы Период обновления
API-вызовы на соединение 100 60 секунд

Действия

Запрос маркетинговых данных из источников данных Supermetrics

Запрос маркетинговых данных из источников данных Суперметрики Возвращает schedule_id. Затем необходимо вызвать get_async_query_results, чтобы получить фактические данные.
Обнаружение доступных источников данных суперметрики

Обнаружение доступных источников данных Суперметрики Обычно это первый шаг. Вызовите это, чтобы узнать, какие источники данных доступны перед запросом данных.
Обнаружение доступных полей для источников данных с помощью сведений о схеме

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

Обнаружение доступных учетных записей для конкретного источника данных вызывается после data_source_discovery получения идентификаторов учетных записей, необходимых для запросов данных.
Получение результатов запросов данных с помощью schedule_id

Получение результатов запросов данных с помощью schedule_id Использовать это с schedule_id из data_query для получения фактических результатов запроса.
Получение сведений о пользователе, прошедших проверку подлинности, из суперметрики

Получение сведений о пользователе, прошедших проверку подлинности, из суперметрики
Получение текущих сведений о дате и времени в формате UTC

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

Получение сведений о работоспособности сервера и конфигурации.

Запрос маркетинговых данных из источников данных Supermetrics

Идентификатор операции:
dataquery

Запрос маркетинговых данных из источников данных Суперметрики Возвращает schedule_id. Затем необходимо вызвать get_async_query_results, чтобы получить фактические данные.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор источника данных
 ds_id True string

Идентификатор источника данных, который можно получить с помощью средства data_source_discovery. Примеры: "FA" для Facebook Ads, AW для Google Ads, GAWA для Google Analytics.
ds_accounts
 ds_accounts True array of string
столбцов
 fields True array of string
Тип диапазона дат
 date_range_type string

Выберите один из двух подходов:

  1. Используйте custom и предоставьте start_date и end_date.
  2. Используйте относительный диапазон в формате "last_X_Y" (например, "last_7_days", "last_3_months".
    • Можно добавить "_inc", чтобы включить текущий период (например, "last_7_days_inc".

ВАЖНО. Для любой относительной даты, указанной пользователем, сначала вызовите средство get_today, чтобы узнать текущий год и дату! Если существует неоднозначность периода времени (например, значение "сегодня", "сегодня", "на этой неделе", "в августе прошлого года" или аналогичные фразы), вызовите get_today средство для подтверждения текущего года и даты, а затем используйте этот ответ для заполнения этого параметра.
Дата начала
 start_date string

Требуется, если date_range_type='custom'. Принимает:

  • Точную дату в формате YYY-MM-DD (например, "2024-01-01")
  • Дата естественного языка (например, "вчера", "в следующий понедельник")

ВАЖНО. Для любой относительной даты, указанной пользователем, сначала вызовите средство get_today, чтобы узнать текущий год и дату! Если существует неоднозначность ссылки на время (например, относительные фразы, такие как "сегодня", "на этой неделе", "конец месяца"), вызовите get_today средство для подтверждения текущего года и даты, а затем используйте этот ответ для заполнения этого параметра.
Дата окончания
 end_date string

Требуется, если date_range_type='custom'. Принимает:

  • Точную дату в формате YYY-MM-DD (например, "2024-01-31")
  • Дата естественного языка (например, "вчера", "в последнюю пятницу")

ВАЖНО. Для любой относительной даты, указанной пользователем, сначала вызовите средство get_today, чтобы узнать текущий год и дату! Если существует неоднозначность ссылки на время (например, относительные фразы, такие как "сегодня", "на этой неделе", "конец месяца"), вызовите get_today средство для подтверждения текущего года и даты, а затем используйте этот ответ для заполнения этого параметра.
Часовой пояс
 timezone string

При необходимости задайте часовой пояс для вычислений дат (например, "Америка/New_York", "Европа/Лондон", "Азия/Токио". Использует имена часового пояса IANA. Если не указано, используется UTC.
Фильтры
 filters string

Строка выражения фильтра. Каждое условие имеет форму: [field_name] [оператор] [значение] Условия могут сочетаться с AND /OR.

Поддерживаемые операторы:

  • "==" → равно
  • "!=" → не равен
  • '>' → больше
  • '>=' → больше или равно
  • "<" → меньше, чем
  • '<=' → меньше или равно
  • "=@" → содержит (не учитывает регистр, только измерения)
  • "!@" → не содержит (без учета регистра, только измерений)
  • "=~" → соответствует регулярному выражению (только измерения)
  • "!~" → не соответствует регулярному выражению (только измерения)

Примеры.

  • "страна == Соединенные Штаты"
  • "страна == США ИЛИ страна == Канада"
  • "session > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • PagePath =~ ^/products/.*"
Settings
 settings object

Дополнительная конфигурация запроса. Используйте объект JSON, например {"show_all_time_values": true}. Расширенная функция для определенных параметров источника данных. Пропустите, если у вас нет конкретных требований.
Тип периода сравнения
 compare_type string

Выберите способ сравнения результатов с предыдущим периодом:

  • "prev_range": предыдущий период той же длины
  • "prev_year": тот же период за предыдущий год
  • "prev_year_weekday": одни и те же выходные дни в предыдущем году
  • Custom: определяемый пользователем период (требуется compare_start_date и compare_end_date)
Тип значения сравнения
 compare_show string

Как отобразить сравнение:

  • "perc_change": процентное изменение (по умолчанию)
  • "abs_change": абсолютное изменение
  • "value": необработанное значение из периода сравнения
Дата начала периода сравнения
 compare_start_date string

Требуется, если compare_type='custom'. Дата начала настраиваемого периода сравнения в формате YYY-MM-DD (например, "2024-01-01".
Дата окончания периода сравнения
 compare_end_date string

Требуется, если compare_type='custom'. Дата окончания настраиваемого периода сравнения в формате YYY-MM-DD (например, 2024-01-31).

Возвращаемое значение

Тело
DataqueryResponse

Обнаружение доступных источников данных суперметрики

Идентификатор операции:
datasourcediscovery

Обнаружение доступных источников данных Суперметрики Обычно это первый шаг. Вызовите это, чтобы узнать, какие источники данных доступны перед запросом данных.

Параметры

Имя Ключ Обязательно Тип Описание
Сжатие ответа
 compress boolean

Включение сжатия для ответа

Возвращаемое значение

Тело
DatasourcediscoveryResponse

Обнаружение доступных полей для источников данных с помощью сведений о схеме

Идентификатор операции:
fielddiscovery

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор источника данных
 ds_id True string

Идентификатор источника данных, который можно получить с помощью средства data_source_discovery. Примеры: "FA" для Facebook Ads, AW для Google Ads, GAWA для Google Analytics.
Тип поля
 field_type string

Фильтрация по типу поля (измерение или метрика)
Сжатие ответа
 compress boolean

Включение сжатия для ответа

Возвращаемое значение

Тело
FielddiscoveryResponse

Обнаружение доступных учетных записей для определенного источника данных

Идентификатор операции:
accountsdiscovery

Обнаружение доступных учетных записей для конкретного источника данных вызывается после data_source_discovery получения идентификаторов учетных записей, необходимых для запросов данных.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор источника данных
 ds_id True string

Идентификатор источника данных, который можно получить с помощью средства data_source_discovery. Примеры: "FA" для Facebook Ads, AW для Google Ads, GAWA для Google Analytics.
Сжатие ответа
 compress boolean

Включение сжатия для ответа

Возвращаемое значение

Тело
AccountsdiscoveryResponse

Получение результатов запросов данных с помощью schedule_id

Идентификатор операции:
getasyncqueryresults

Получение результатов запросов данных с помощью schedule_id Использовать это с schedule_id из data_query для получения фактических результатов запроса.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор расписания
 schedule_id True string

Идентификатор расписания, возвращенный из запроса data_query. Идентификатор расписания должен быть точно таким же, как и в ответе data_query. Относитесь к идентификаторам как непрозрачные. Скопируйте подробные сведения. Не сокращайте, не форматируйте или парафразируйте.
Сжатие ответа
 compress boolean

Включение сжатия для ответа

Возвращаемое значение

Тело
GetasyncqueryresultsResponse

Получение сведений о пользователе, прошедших проверку подлинности, из суперметрики

Идентификатор операции:
userinfo

Получение сведений о пользователе, прошедших проверку подлинности, из суперметрики

Параметры

Имя Ключ Обязательно Тип Описание
object

Возвращаемое значение

Тело
UserinfoResponse

Получение текущих сведений о дате и времени в формате UTC

Идентификатор операции:
gettoday

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

Параметры

Имя Ключ Обязательно Тип Описание
object

Возвращаемое значение

Тело
GettodayResponse

Проверка состояния здоровья

Идентификатор операции:
healthCheck

Получение сведений о работоспособности сервера и конфигурации.

Возвращаемое значение

response
string

Определения

AccountsdiscoveryResponse

Имя Путь Тип Описание
успешно
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Имя Путь Тип Описание
успешно
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Имя Путь Тип Описание
успешно
 success boolean
источники данных
 data.data_sources array of object
id
 data.data_sources.id string
имя
 data.data_sources.name string
категория
 data.data_sources.category string

FielddiscoveryResponse

Имя Путь Тип Описание
успешно
 success boolean
источник данных
 data.data_source string
итог
 data.total integer
metrics
 data.metrics array of object
id
 data.metrics.id string
имя
 data.metrics.name string
описание
 data.metrics.description string
dimensions
 data.dimensions array of object
id
 data.dimensions.id string
имя
 data.dimensions.name string
описание
 data.dimensions.description string

GetasyncqueryresultsResponse

Имя Путь Тип Описание
успешно
 success boolean
данные
 data.data array of object
items
 data.data object
статус
 data.status string

GettodayResponse

Имя Путь Тип Описание
успешно
 success boolean
date
 data.date date
iso_string
 data.iso_string string
отметка времени
 data.timestamp integer

UserinfoResponse

Имя Путь Тип Описание
успешно
 success boolean
идентификатор пользователя
 data.user_id string
электронная почта
 data.email string
имя
 data.name string

струна

Это базовый тип данных string.