Құралдар және API

Каталогта тауарлар, санаттар, нишалар, брендтер, сатушылар, жиынтықтар, таңдаулылар және маркетплейстер бойынша тек оқуға арналған әрекеттер бар. Іздеуді орыс, қазақ, қытай немесе ағылшын тілінде орындауға болады; таңдалған әрекеттің толық схемасы бөлек жүктеледі. Сұраулар мен қатар орындалатын әрекеттердің қолданыстағы шектері search_actions және describe_action жауаптарында беріледі; аналитикаға сұрау жібермес бұрын соларды тексеріңіз.

Авторизация

Кілтпен қосылатын клиенттер Authorization: Bearer <сіздің кілтіңіз> тақырыбын жіберуі керек. OAuth арқылы қосылған веб-клиенттер Dattoria арқылы кіреді.

HTTP ТАҚЫРЫБЫ

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

MCP спецификациясыModel Context Protocol