Инструменты и API

Каталог содержит только действия чтения для товаров, категорий, ниш, брендов, продавцов, сводок, избранного и маркетплейсов. Ищите на русском, казахском, китайском или английском; подробная схема загружается отдельно для выбранного действия. Общий предел по умолчанию - 20 аналитических вызовов в секунду; администратор может изменить его и связанные ограничения в настройках MCP. Действующие значения возвращаются в search_actions и describe_action; сверяйтесь с ними перед вызовом данных.

Авторизация

Для ключевых подключений передавайте заголовок Authorization: Bearer <ваш ключ>. В веб-клиентах, подключённых через OAuth, вход выполняется через страницу Dattoria.

HTTP HEADER

Authorization: Bearer YOUR_DATTORIA_MCP_TOKEN

Ограничения

marketplace указывайте только если поле есть в схеме действия; допустимые значения - kaspi и teez. Если схема принимает даты, передавайте dateFrom и dateTo вместе в формате YYYY-MM-DD. Период - не более 180 дней, конечная дата не может быть в будущем. Запрашивайте одну страницу за вызов и соблюдайте пределы page и limit из схемы выбранного действия. Строковые поля ограничены схемой конкретного действия; запрос search_actions - от 1 до 120 символов.

Инструменты

Сервер публикует четыре компактных MCP-инструмента и каталог разрешённых действий чтения. Агент сначала находит действие, затем загружает его схему по запросу и только после этого выполняет один отчёт или последовательный сценарий до пяти шагов.

search_actionsПоиск действия

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

Обязательные поля: query
Необязательные поля: section, limit (1–12)

ПРИМЕР ВЫЗОВА

{
  "query": "поиск товаров",
  "section": "products",
  "limit": 8
}

describe_actionОписание действия

Возвращает полную схему аргументов, ограничения и значения полей для одного найденного действия.

Обязательные поля: actionId
Необязательные поля: -

ПРИМЕР ВЫЗОВА

{
  "actionId": "products.search"
}

execute_actionВыполнение действия

Выполняет одно действие только для чтения. Аргументы проверяются по схеме, полученной через describe_action.

Обязательные поля: actionId, arguments
Необязательные поля: - (поля arguments зависят от схемы действия)

ПРИМЕР ВЫЗОВА

{
  "actionId": "products.search",
  "arguments": {
    "marketplace": "kaspi",
    "search": "smartphones",
    "page": 1,
    "limit": 20
  }
}

execute_workflowСценарий из действий

Последовательно выполняет от одного до пяти действий, применяет общие фильтры и при необходимости создаёт временную выгрузку JSON или CSV.

Обязательные поля: steps (1–5)
Необязательные поля: defaults, continueOnError, outputFormat (json or csv)

ПРИМЕР ВЫЗОВА

{
  "defaults": {
    "marketplace": "kaspi",
    "dateFrom": "2026-09-01",
    "dateTo": "2026-09-30"
  },
  "steps": [
    {
      "actionId": "products.search",
      "arguments": {"search": "smartphones", "page": 1, "limit": 20}
    },
    {
      "actionId": "categories.search",
      "arguments": {"search": "phones", "page": 1, "limit": 20}
    }
  ],
  "continueOnError": true,
  "outputFormat": "json"
}

Подробные примеры работы со сценариямиworkflows.md

Спецификация MCPModel Context Protocol