Shopify Product Research

Shopify Product Research: shopify/store Query API

Shopify Product Research: shopify/store Query API.

MCP tool name

nexscope_data_eh_shopify_store_query

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-eh-shopify-store-query-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_eh_shopify_store_query",
    "arguments": {
      "country": "US",
      "orderBy": "desc",
      "page": 1,
      "pageSize": 20,
      "searchKey": "fashion",
      "sortBy": 7,
      "year": 2
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`searchKey`	`string`	optional	Store name or domain name keywords Example: {}
`country`	`string`	optional	Country code (e.g. `US`, `CN`) Example: {}
`year`	`integer`	optional	Store creation year: 1=last year, 2=1~2 years, 3=2~3 years, 4=more than 3 years Example: {}
`productNumMin`	`integer`	optional	Product number range (start) Example: {}
`productNumMax`	`integer`	optional	Product number interval (end) Example: {}
`advertiseCountMin`	`integer`	optional	Advertisement count interval (start) Example: {}
`advertiseCountMax`	`integer`	optional	Advertisement count interval (end) Example: {}
`monthlyVisitMin`	`integer`	optional	Monthly visit range (start) Example: {}
`monthlyVisitMax`	`integer`	optional	Monthly visit range (end) Example: {}
`monthOrderMin`	`integer`	optional	Monthly order volume range (starting) Example: {}
`monthOrderMax`	`integer`	optional	Monthly order volume range (end) Example: {}
`sortBy`	`integer`	optional	Sorting fields: 0=number of products, 1=number of categories, 2=monthly visits, 3=FB fans, 4=Ins fans, 5=number of ads, 6=relevance, 7=number of monthly orders Example: 7
`orderBy`	`string`	optional	Sorting direction: `desc` (descending order)/`asc` (ascending order) Example: desc
`page`	`integer`	optional	Page number, starting from 1 Example: 1
`pageSize`	`integer`	optional	Number of items per page, maximum 100 Example: 20

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of items returned on this page Example: {}
`storeNum`	`integer`	optional	Total number of eligible stores (upstream `store_num`) Example: {}
`stores`	`array`	optional	Shopify store list Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`title`	`string`	optional	Title (`Shopify store query`) Example: {}
`sourceType`	`string`	optional	Source type: shopify Example: {}
`type`	`string`	optional	Rendered style: tableListWorkbenches Example: {}
`storeId`	`store_id`	optional	Store ID Example: {}
`shopId`	`shop_id`	optional	Shopify shop ID Example: {}
`storeName`	`store_name`	optional	Store name Example: {}
`storeDomain`	`store_domain`	optional	Store domain name Example: {}
`storeLink`	`store_link`	optional	Store link Example: {}
`country`	`-`	optional	country Example: {}
`createdTime`	`created_time`	optional	creation time Example: {}
`productNum`	`product_num`	optional	Number of products Example: {}
`categoryNum`	`category_num`	optional	Number of categories Example: {}
`categories`	`-`	optional	Category list (elements include `id`, `name`) Example: {}
`monthlyVisit`	`monthly_visit`	optional	Monthly visits (formatted) Example: {}
`monthOrderNum`	`month_order_num`	optional	Monthly order volume (formatted) Example: {}
`fbFollowers`	`fb_followers`	optional	Number of Facebook fans Example: {}
`insFollowers`	`ins_followers`	optional	Instagram followers Example: {}
`advertiseCount`	`advertise_count`	optional	Number of ads Example: {}
`adLink`	`ad_link`	optional	Ad library link Example: {}
`email`	`-`	optional	Contact email Example: {}
`facebookUrl`	`facebook_url`	optional	Facebook home page Example: {}
`instagramUrl`	`instagram_url`	optional	Instagram Home Page Example: {}
`socialLinks`	`social_links`	optional	Social Media Links (Map) Example: {}
`globalRank`	`global_rank`	optional	global ranking Example: {}
`logo`	`-`	optional	Store Logo URL Example: {}
`availableStatus`	`available_status`	optional	Is it active: 1=active Example: {}

Examples

Example arguments

{
  "country": "US",
  "orderBy": "desc",
  "page": 1,
  "pageSize": 20,
  "searchKey": "fashion",
  "sortBy": 7,
  "year": 2
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}