Shopify Product Research
Shopify Store Query MCP
Find Shopify stores by country, product range, sales, and audience size. Call the Shopify Store Query API via REST or MCP with your Nexscope API key.
Shopify Store Query AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Find Shopify Stores
Prompt: Find Shopify Stores for [search phrase] in [target marketplace]. Show the available results and clearly identify missing information.
2. Continue The Results Within A Page Limit
Prompt: Find Shopify Stores for [search phrase] in [target marketplace]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.
3. Prioritize The Results For Review
Prompt: Find Shopify Stores for [search phrase] in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period. For this selection, choose product count, category count, monthly visits, Facebook followers, Instagram followers, ad count, relevance or monthly orders.
4. Find Matches By Product Count
Prompt: Find Shopify Stores for [search phrase] in [target marketplace]. Limit results to [my chosen product count range]. Keep the lower and upper bounds consistent and show only the matching records.
5. Find Matches By Ad Count
Prompt: Find Shopify Stores for [search phrase] in [target marketplace]. Limit results to [my chosen ad count range]. Keep the lower and upper bounds consistent and show only the matching records.
6. Find Matches By Monthly Visits
Prompt: Find Shopify Stores for [search phrase] in [target marketplace]. Limit results to [my chosen monthly visits range]. Keep the lower and upper bounds consistent and show only the matching records.
7. Find Matches By Monthly Orders
Prompt: Find Shopify Stores for [search phrase] in [target marketplace]. Limit results to [my chosen monthly orders range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Research Stores By Age
Prompt: Find Shopify stores matching [search phrase] in [target marketplace] with [my selected store age]. Choose the supported age band: under one year, one to two years, two to three years, or more than three years. Summarize the matching stores.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_shopify_store_queryhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "shopify-store-query-1",
"method": "tools/call",
"params": {
"name": "nexscope_shopify_store_query",
"arguments": {
"page": 1,
"pageSize": 20,
"searchKey": "phone case"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress 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 keyword |
country | string | optional | Country code (e.g., US, CN) |
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 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Number of items returned on this page |
storeNum | integer | optional | Total number of eligible stores (upstream `store_num`) |
stores | array | optional | Shopify store list |
columns | array | optional | Rendered columns |
title | string | optional | Title (`Shopify store query`) |
sourceType | string | optional | Source type: shopify |
type | string | optional | Rendered style: tableListWorkbenches |
storeId | `store_id` | optional | Store ID |
shopId | `shop_id` | optional | Shopify shop ID |
storeName | `store_name` | optional | Store name |
storeDomain | `store_domain` | optional | Store domain name |
storeLink | `store_link` | optional | Store link |
country | - | optional | country |
createdTime | `created_time` | optional | creation time |
productNum | `product_num` | optional | Number of products |
categoryNum | `category_num` | optional | Number of categories |
categories | - | optional | Category list (elements include `id`, `name`) |
monthlyVisit | `monthly_visit` | optional | Monthly visits (formatted) |
monthOrderNum | `month_order_num` | optional | Monthly order volume (formatted) |
fbFollowers | `fb_followers` | optional | Number of Facebook fans |
insFollowers | `ins_followers` | optional | Instagram followers |
advertiseCount | `advertise_count` | optional | Number of ads |
adLink | `ad_link` | optional | Ad library link |
email | - | optional | Contact email |
facebookUrl | `facebook_url` | optional | Facebook home page |
instagramUrl | `instagram_url` | optional | Instagram Home Page |
socialLinks | `social_links` | optional | Social Media Links (Map) |
globalRank | `global_rank` | optional | global ranking |
logo | - | optional | Store Logo URL |
availableStatus | `available_status` | optional | Is it active: 1=active |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Find Shopify stores by country, product range, sales, and audience size. Use “allbirds.com”.
Example Answer
In the published sample, its reported total is 1. Its reported store num is 1. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"searchKey": "allbirds.com",
"page": 1,
"pageSize": 10
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"sourceTool": "ehunt",
"sourceType": "shopify",
"stores": [
{
"categoryNum": 9,
"globalRank": "",
"country": "US",
"socialLinks": {
"youtube": "https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw",
"twitter": "https://twitter.com/allbirds",
"tiktok": "https://www.tiktok.com/@weareallbirds",
"facebook": "https://www.facebook.com/weareallbirds",
"pinterest": "http://pinterest.com/weareallbirds",
"instagram": "https://www.instagram.com/allbirds"
},
"storeDomain": "allbirds.com",
"productNum": 692,
"storeId": "5852578",
"fbFollowers": "0",
"monthOrderNum": "5.6k",
"storeLink": "https://allbirds.com",
"facebookUrl": "https://www.facebook.com/1096859176844485",
"availableStatus": 1,
"adLink": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=ALL&view_all_page_id=1096859176844485&sort_data[direction]=desc&sort_data[mode]=relevancy_monthly_grouped",
"createdTime": "2002-01-09",
"advertiseCount": 247,
"logo": "https://www.allbirds.com/cdn/shop/files/favicon.png?v=1719584207",
"storeName": "The World’s Most Comfortable Shoes",
"instagramUrl": "https://www.instagram.com/allbirds",
"shopId": "11044168",
"categories": [
{
"name": "5",
"id": "5"
}
],
"monthlyVisit": "6250.0k",
"email": "help@allbirds.com",
"insFollowers": "0"
}
],
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "storeId",
"sortable": true,
"title": "店铺 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "shopId",
"sortable": true,
"title": "商店 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "storeName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "text",
"field": "storeDomain",
"sortable": true,
"title": "店铺域名"
},
{
"filterable": true,
"cellType": "text",
"field": "storeLink",
"sortable": true,
"title": "店铺链接"
},
{
"filterable": true,
"cellType": "text",
"field": "country",
"sortable": true,
"title": "国家名称"
},
{
"filterable": true,
"cellType": "text",
"field": "createdTime",
"sortable": true,
"title": "创建时间"
},
{
"filterable": true,
"cellType": "number",
"field": "productNum",
"sortable": true,
"title": "产品数量"
},
{
"filterable": true,
"cellType": "number",
"field": "categoryNum",
"sortable": true,
"title": "类目数量"
},
{
"filterable": true,
"cellType": "text",
"field": "categories",
"sortable": true,
"title": "类目列表"
},
{
"filterable": true,
"cellType": "text",
"field": "monthlyVisit",
"sortable": true,
"title": "月访问量(格式化,如 2"
},
{
"filterable": true,
"cellType": "text",
"field": "monthOrderNum",
"sortable": true,
"title": "月订单量(格式化,如 15"
},
{
"filterable": true,
"cellType": "text",
"field": "fbFollowers",
"sortable": true,
"title": "Facebook 粉丝数(格式化)"
},
{
"filterable": true,
"cellType": "text",
"field": "insFollowers",
"sortable": true,
"title": "Instagram 粉丝数(格式化)"
},
{
"filterable": true,
"cellType": "number",
"field": "advertiseCount",
"sortable": true,
"title": "广告数量"
},
{
"filterable": true,
"cellType": "text",
"field": "adLink",
"sortable": true,
"title": "广告库链接"
},
{
"filterable": true,
"cellType": "text",
"field": "email",
"sortable": true,
"title": "联系邮箱"
},
{
"filterable": true,
"cellType": "text",
"field": "facebookUrl",
"sortable": true,
"title": "Facebook 主页链接"
},
{
"filterable": true,
"cellType": "text",
"field": "instagramUrl",
"sortable": true,
"title": "Instagram 主页链接"
},
{
"filterable": true,
"cellType": "text",
"field": "socialLinks",
"sortable": true,
"title": "其他社交链接"
},
{
"filterable": true,
"cellType": "text",
"field": "globalRank",
"sortable": true,
"title": "全球排名"
},
{
"filterable": true,
"cellType": "text",
"field": "logo",
"sortable": true,
"title": "店铺 Logo URL"
},
{
"filterable": true,
"cellType": "number",
"field": "availableStatus",
"sortable": true,
"title": "店铺状态:1=活跃"
}
],
"storeNum": 1,
"title": "Shopify 店铺查询",
"type": "tableListWorkbenches"
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "shopify-store-query-example",
"method": "tools/call",
"params": {
"name": "nexscope_shopify_store_query",
"arguments": {
"searchKey": "allbirds.com",
"page": 1,
"pageSize": 10
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "shopify-store-query-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"title\":\"Shopify 店铺查询\",\"total\":1,\"stores\":[{\"categories\":[{\"name\":\"5\",\"id\":\"5\"}],\"categoryNum\":9,\"globalRank\":\"\",\"country\":\"US\",\"socialLinks\":{\"youtube\":\"https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw\",\"twitter\":\"https://twitter.com/allbirds\",\"tiktok\":\"https://www.tiktok.com/@weareallbirds\",\"facebook\":\"https://www.facebook.com/weareallbirds\",\"pinterest\":\"http://pinterest.com/weareallbirds\",\"instagram\":\"https://www.instagram.com/allbirds\"},\"storeDomain\":\"allbirds.com\",\"productNum\":692,\"storeId\":\"5852578\",\"fbFollowers\":\"0\",\"monthOrderNum\":\"5.6k\",\"storeLink\":\"https://allbirds.com\",\"facebookUrl\":\"https://www.facebook.com/1096859176844485\"}],\"storeNum\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"title": "Shopify 店铺查询",
"total": 1,
"stores": [
{
"categories": [
{
"name": "5",
"id": "5"
}
],
"categoryNum": 9,
"globalRank": "",
"country": "US",
"socialLinks": {
"youtube": "https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw",
"twitter": "https://twitter.com/allbirds",
"tiktok": "https://www.tiktok.com/@weareallbirds",
"facebook": "https://www.facebook.com/weareallbirds",
"pinterest": "http://pinterest.com/weareallbirds",
"instagram": "https://www.instagram.com/allbirds"
},
"storeDomain": "allbirds.com",
"productNum": 692,
"storeId": "5852578",
"fbFollowers": "0",
"monthOrderNum": "5.6k",
"storeLink": "https://allbirds.com",
"facebookUrl": "https://www.facebook.com/1096859176844485"
}
],
"storeNum": 1
}
},
"isError": false
}
}