Skip to content
AsklearAgent Docs
Dashboard
中EN

Shop performance

Query monthly atomic metrics for one exact Tmall shop ID or standard URL.

Document ID: agent.dataset.tmall.task.shop_performance

Authenticated runtime tools and each query response are authoritative for tenant scope and current data coverage.

This is an MCP query composition, not a complete business report; see Research Methods in the Agent Docs for complete workflows.

Required inputs

shop_referenceRequired · exact_reference

Exact Tmall shop ID or standard URL

shop_id
timeRequired · user_required

Analysis time range

Execution steps

  1. 1
    query_trend · query_metrics

    Query shop metrics grouped by month.

    Request contract
    metrics: gmv, units, aspgroup_by: shop_id, shop_url, monthfilter: shop_id eq $shop_referencetime: $time

Call example

Replace example values with exact user inputs or platform values returned by search_values.

query_metrics
{
  "dataset": "tmall",
  "filters": [
    {
      "field": "shop_id",
      "op": "eq",
      "value": "https://example.tmall.com/"
    }
  ],
  "group_by": [
    "shop_id",
    "shop_url",
    "month"
  ],
  "metrics": [
    "gmv",
    "units",
    "asp"
  ],
  "task_query": "使用 tmall 数据执行店铺销售表现；shop_reference=https://example.tmall.com/，time={\"last_complete_months\":3}",
  "time": {
    "last_complete_months": 3
  }
}

Output policy

  • Present a month-by-month trend with metric definitions.

Stop conditions

  • Stop and request an exact shop ID or standard URL when normalization fails.

Limitations

  • Do not infer traffic, inventory, or operational causes.