工具与 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搜索操作

在精简目录中查找相关操作并返回稳定的操作 ID。支持多种语言的表达和轻微拼写错误。

必填字段: 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运行工作流

按顺序执行 1 到 5 项操作，应用共享筛选条件，并可按需生成临时 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