Shopify
Filter Shopify standalone stores by multiple dimensions (store name/domain, country, years since creation, product count, ad count, monthly visits, monthly orders, social media followers, etc.).
nexscope_shopify_store_queryhttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "shopify-store-query-1",
"method": "tools/call",
"params": {
"name": "nexscope_shopify_store_query",
"arguments": {
"pageSize": 20,
"searchKey": "phone case",
"page": 1
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/shopify-store-queryProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| Name | Type | Required | Description |
|---|---|---|---|
searchKey | string | optional | Store name or domain keyword Example: {} |
country | string | optional | Country code (e.g., US, CN) Example: {} |
year | integer | optional | Store creation year: 1=Last 1 year, 2=1~2 years, 3=2~3 years, 4=3+ years Example: 1 |
productNumMin | integer | optional | Product count range start Example: 1 |
productNumMax | integer | optional | Product count range end Example: 1 |
advertiseCountMin | integer | optional | Ad count range start Example: 1 |
advertiseCountMax | integer | optional | Ad count range end Example: 1 |
monthlyVisitMin | integer | optional | Monthly visits range start Example: 1 |
monthlyVisitMax | integer | optional | Monthly visits range end Example: 1 |
monthOrderMin | integer | optional | Monthly orders range start Example: 1 |
monthOrderMax | integer | optional | Monthly orders range end Example: 1 |
sortBy | integer | optional | Sort field: 0=Product count, 1=Category count, 2=Monthly visits, 3=FB followers, 4=Ins followers, 5=Ad count, 6=Relevance, 7=Monthly orders (default) Example: 7 |
orderBy | string | optional | Sort direction: desc (default) / asc Example: desc |
page | integer | optional | Page number (starting from 1) Example: 1 |
pageSize | integer | optional | Results per page, default 20, max 100 Example: 20 |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Number of results returned on this page Example: 1 |
data.storeNum | integer | optional | Total number of matching stores (upstream store_num) Example: 1 |
data.stores | array | optional | Shopify store list Example: [] |
data.stores[] | object |
{
"pageSize": 20,
"searchKey": "phone case",
"page": 1
}{
"data": {
"total": 1,
"storeNum": 1,
"stores": [
{
"storeId": "example-id",
"shopId": "example-id",
"facebookUrl": "https://example.com/image.jpg",
"instagramUrl": "https://example.com/image.jpg"
}
],
"columns": []
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Item in data stores. |
data.stores[].storeId | string | optional | Store ID Example: example-id |
data.stores[].shopId | string | optional | Shopify shop ID Example: example-id |
data.stores[].storeName | string | optional | Store name Example: null |
data.stores[].storeDomain | string | optional | Store domain Example: null |
data.stores[].storeLink | string | optional | Store link Example: null |
data.stores[].country | string | optional | Country Example: null |
data.stores[].createdTime | string | optional | Creation time Example: null |
data.stores[].productNum | string | optional | Product count Example: null |
data.stores[].categoryNum | string | optional | Category count Example: null |
data.stores[].categories | array | optional | Category list (elements contain id and name) Example: null |
data.stores[].monthlyVisit | string | optional | Monthly visits (formatted) Example: null |
data.stores[].monthOrderNum | string | optional | Monthly orders (formatted) Example: null |
data.stores[].fbFollowers | string | optional | Facebook followers Example: null |
data.stores[].insFollowers | string | optional | Instagram followers Example: null |
data.stores[].advertiseCount | string | optional | Ad count Example: null |
data.stores[].adLink | string | optional | Ad library link Example: null |
data.stores[].email | string | optional | Contact email Example: null |
data.stores[].facebookUrl | string | optional | Facebook page Example: https://example.com/image.jpg |
data.stores[].instagramUrl | string | optional | Instagram page Example: https://example.com/image.jpg |
data.stores[].socialLinks | object | optional | Social media links (Map) Example: null |
data.stores[].globalRank | string | optional | Global rank Example: null |
data.stores[].logo | string | optional | Store logo URL Example: null |
data.stores[].availableStatus | string | optional | Whether active: 1=Active Example: null |
data.columns | array | optional | Columns for rendering Example: [] |
data.title | string | optional | Title (Shopify Store Query) Example: null |
data.sourceType | string | optional | Source type: shopify Example: null |
data.sourceTool | string | optional | Tool type: ehunt Example: null |
data.type | string | optional | Render style: tableListWorkbenches Example: null |
data.costToken | integer | optional | Token cost reported by the upstream provider. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |