Etsy Product Research
Etsy Store Query MCP
Search Etsy stores by keyword, category, country, status, ratings, sales, favorites, reviews, and opening date with pagination. Available via REST API or MCP.
Etsy 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 Etsy Shops Matching My Research Criteria
Prompt: Find Etsy shops matching my research criteria 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 Etsy shops matching my research criteria 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 Etsy shops matching my research criteria 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 total sales, weekly sales, review count or favorite count.
4. Find Matches By Total Favorites
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Limit results to [my chosen total favorites range]. Keep the lower and upper bounds consistent and show only the matching records.
5. Find Matches By Weekly Favorites
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Limit results to [my chosen weekly favorites range]. Keep the lower and upper bounds consistent and show only the matching records.
6. Find Matches By Total Reviews
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Limit results to [my chosen total reviews range]. Keep the lower and upper bounds consistent and show only the matching records.
7. Find Matches By Weekly Reviews
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Limit results to [my chosen weekly reviews range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Find Matches By Sales Amount
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Limit results to [my chosen sales amount range]. Keep the lower and upper bounds consistent and show only the matching records.
9. Find Matches By Weekly Sales
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Limit results to [my chosen weekly sales range]. Keep the lower and upper bounds consistent and show only the matching records.
10. Find Matches By Store Opening Date
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Limit results to [my chosen store opening date range]. Keep the lower and upper bounds consistent and show only the matching records.
11. Narrow Results By Primary Store Category
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Use [my selected primary store category] to narrow the results. Report only what the selected records support.
12. Narrow Results By Store Status
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Use [my selected store status] to narrow the results. Report only what the selected records support.
13. Find Highly Praised Stores Or Products
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Apply [my preference for the raving classification] when reviewing the results. Summarize only the returned records.
14. Find Etsy Star Stores
Prompt: Find Etsy shops matching my research criteria for [search phrase] in [target marketplace]. Apply [my preference for star stores] when reviewing the results. Summarize only the returned records.
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_etsy_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": "etsy-store-query-1",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_store_query",
"arguments": {
"page": 1,
"pageSize": 20,
"searchKey": "Lewshop1"
}
}
}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, keyword, or Etsy store URL. Example: Lewshop1 |
category | string | optional | Primary store category. Example: Jewelry |
country | string | optional | Store country or region. Example: US |
status | integer | optional | Store status: 1 active, 0 inactive. Example: 1 |
isRaving | integer | optional | Raving store flag: 1 yes. Example: 1 |
isStar | integer | optional | Star store flag: 1 yes. Example: 1 |
beginFavorites | integer | optional | Minimum total favorites. Example: 0 |
endFavorites | integer | optional | Maximum total favorites. Example: 10000 |
beginFavoritesWeekly | integer | optional | Minimum weekly favorites. Example: 0 |
endFavoritesWeekly | integer | optional | Maximum weekly favorites. Example: 1000 |
beginReviews | integer | optional | Minimum total reviews. Example: 0 |
endReviews | integer | optional | Maximum total reviews. Example: 10000 |
beginReviewsWeekly | integer | optional | Minimum weekly reviews. Example: 0 |
endReviewsWeekly | integer | optional | Maximum weekly reviews. Example: 1000 |
beginSales | integer | optional | Minimum total sales. Example: 0 |
endSales | integer | optional | Maximum total sales. Example: 100000 |
beginSalesWeekly | integer | optional | Minimum weekly sales. Example: 0 |
endSalesWeekly | integer | optional | Maximum weekly sales. Example: 1000 |
beginStoreOpenedAt | string | optional | Opening date range start in YYYY-MM-DD format. Example: 2020-01-01 |
endStoreOpenedAt | string | optional | Opening date range end in YYYY-MM-DD format. Example: 2026-01-01 |
sortBy | integer | optional | Sort field: 8 total sales, 9 weekly sales, 10 reviews, 11 favorites. Example: 8 |
sortDesc | integer | optional | Sort direction: 1 descending, 0 ascending. Example: 1 |
page | integer | optional | Page number starting from 1. Example: 1 |
pageSize | integer | optional | Items per page from 1 to 100. Example: 20 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Number of records (number of records returned on this page) |
sourceType | string | optional | Source type: etsy |
stores | array | optional | Store list |
columns | array | optional | Rendered columns |
costToken | integer | optional | Token consumption (estimated based on the number of items returned on this page) |
storeNum | integer | optional | Total number of eligible stores (upstream store_num) |
title | string | optional | Title |
type | string | optional | Rendering style |
category | array | optional | List of main categories |
country | array | optional | Country list |
favorites | integer | optional | Number of collections |
favoritesWeekly | integer | optional | Number of new favorites per week |
isRaving | integer | optional | Whether Raving: 1=Yes |
isStar | integer | optional | Star or not: 1=Yes |
logoUrl | string | optional | Store avatar URL |
productCount | integer | optional | Store product quantity |
rating | number | optional | Rating |
reviews | integer | optional | Number of comments |
reviewsWeekly | integer | optional | New comments per week |
salesTotal | integer | optional | total sales |
salesWeekly | integer | optional | Weekly sales |
shopWebsite | string | optional | Store official website/external link |
startAt | string | optional | Store opening date |
status | integer | optional | Store status: 1=active, 0=inactive |
storeId | string | optional | Store ID |
storeName | string | optional | Store name |
storeUrl | string | optional | Store link |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Find Etsy shops matching my research criteria.
Example Answer
In the published sample, its reported total is 20. Its reported store num is 3931535. 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
{
"page": 1,
"pageSize": 20,
"sortBy": 9,
"sortDesc": 1
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 20,
"sourceTool": "ehunt",
"sourceType": "etsy",
"stores": [
{
"favorites": 103819,
"country": [
"US"
],
"isRaving": 1,
"rating": 484,
"salesTotal": 2337140,
"favoritesWeekly": 278,
"salesWeekly": 37140,
"storeId": "9901413",
"productCount": 10576,
"logoUrl": "https://i.etsystatic.com/9901413/r/isla/5fb889/87829779/isla_500x500.87829779_6bvbiam9.jpg",
"shopWebsite": "/shop/Beadboat1",
"reviews": 269720,
"isStar": 1,
"storeUrl": "/shop/Beadboat1",
"reviewsWeekly": 200,
"storeName": "Beadboat1",
"category": [
"60730d8d2eef8f4f",
"565631402af79df4"
],
"startAt": "2014-08-22 03:39:19",
"status": 1
},
{
"favorites": 46484,
"country": [
"US"
],
"isRaving": 1,
"rating": 484,
"salesTotal": 1021978,
"favoritesWeekly": 331,
"salesWeekly": 21978,
"storeId": "18669781",
"productCount": 971,
"logoUrl": "https://i.etsystatic.com/18669781/r/isla/e058f8/73016339/isla_500x500.73016339_f7nxd7m4.jpg",
"shopWebsite": "/shop/SeedCult",
"reviews": 86005,
"isStar": 1,
"storeUrl": "/shop/SeedCult",
"reviewsWeekly": 280,
"storeName": "SeedCult",
"category": [
"dddaa894234df841"
],
"startAt": "2018-10-09 20:52:28",
"status": 1
},
{
"favorites": 50526,
"country": [
"US"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 1200000,
"favoritesWeekly": 127,
"salesWeekly": 10248,
"storeId": "13622716",
"productCount": 1438,
"logoUrl": "https://i.etsystatic.com/13622716/r/isla/bc8ccc/71532549/isla_180x180.71532549_noeakuxe.jpg",
"shopWebsite": "https://www.etsy.com/shop/MyPorchPrints",
"reviews": 137536,
"isStar": 1,
"storeUrl": "https://www.etsy.com/shop/MyPorchPrints",
"reviewsWeekly": 275,
"storeName": "MyPorchPrints",
"category": [
"f199495489bdde6e",
"60730d8d2eef8f4f"
],
"startAt": "2016-08-31 21:40:35",
"status": 1
},
{
"favorites": 78301,
"country": [
"US"
],
"isRaving": 1,
"rating": 488,
"salesTotal": 1662421,
"favoritesWeekly": 503,
"salesWeekly": 6024,
"storeId": "20230277",
"productCount": 16673,
"logoUrl": "https://i.etsystatic.com/20230277/r/isla/30192b/45135135/isla_500x500.45135135_h48rosag.jpg",
"shopWebsite": "/shop/WarungBeads",
"reviews": 134451,
"isStar": 0,
"storeUrl": "/shop/WarungBeads",
"reviewsWeekly": 408,
"storeName": "WarungBeads",
"category": [
"60730d8d2eef8f4f",
"565631402af79df4"
],
"startAt": "2019-05-16 01:14:04",
"status": 1
},
{
"favorites": 161472,
"country": [
"GB"
],
"isRaving": 1,
"rating": 488,
"salesTotal": 2184757,
"favoritesWeekly": 1296,
"salesWeekly": 4678,
"storeId": "10967397",
"productCount": 6969,
"logoUrl": "https://i.etsystatic.com/10967397/r/isla/049d6d/27554222/isla_500x500.27554222_7tnx15id.jpg",
"shopWebsite": "/shop/SilverRainSilver",
"reviews": 436270,
"isStar": 1,
"storeUrl": "/shop/SilverRainSilver",
"reviewsWeekly": 780,
"storeName": "SilverRainSilver",
"category": [
"565631402af79df4"
],
"startAt": "2015-04-07 21:45:47",
"status": 1
},
{
"favorites": 537947,
"country": [
"US"
],
"isRaving": 1,
"rating": 482,
"salesTotal": 3847700,
"favoritesWeekly": 1741,
"salesWeekly": 4652,
"storeId": "10204022",
"productCount": 2529,
"logoUrl": "https://i.etsystatic.com/10204022/r/isla/883ac2/88813489/isla_500x500.88813489_7nbtt4gg.jpg",
"shopWebsite": "/shop/CaitlynMinimalist",
"reviews": 751160,
"isStar": 1,
"storeUrl": "/shop/CaitlynMinimalist",
"reviewsWeekly": 648,
"storeName": "CaitlynMinimalist",
"category": [
"565631402af79df4"
],
"startAt": "2014-11-02 07:08:19",
"status": 1
},
{
"favorites": 84649,
"country": [
"US"
],
"isRaving": 1,
"rating": 476,
"salesTotal": 731584,
"favoritesWeekly": 1127,
"salesWeekly": 3948,
"storeId": "21623448",
"productCount": 2639,
"logoUrl": "https://i.etsystatic.com/21623448/r/isla/77d109/58073783/isla_500x500.58073783_dhq85jyl.jpg",
"shopWebsite": "/shop/OuferJewelry",
"reviews": 127973,
"isStar": 1,
"storeUrl": "/shop/OuferJewelry",
"reviewsWeekly": 421,
"storeName": "OuferJewelry",
"category": [
"565631402af79df4"
],
"startAt": "2019-11-15 14:55:13",
"status": 1
},
{
"favorites": 37097,
"country": [
"US"
],
"isRaving": 1,
"rating": 496,
"salesTotal": 692947,
"favoritesWeekly": 509,
"salesWeekly": 3905,
"storeId": "11543088",
"productCount": 15758,
"logoUrl": "https://i.etsystatic.com/11543088/r/isla/2665a6/26883994/isla_500x500.26883994_oe9ptrie.jpg",
"shopWebsite": "/shop/CuteLittleFabricShop",
"reviews": 127088,
"isStar": 1,
"storeUrl": "/shop/CuteLittleFabricShop",
"reviewsWeekly": 500,
"storeName": "CuteLittleFabricShop",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2015-08-20 05:34:08",
"status": 1
},
{
"favorites": 50417,
"country": [
"TR"
],
"isRaving": 1,
"rating": 496,
"salesTotal": 1298384,
"favoritesWeekly": 181,
"salesWeekly": 3368,
"storeId": "5793103",
"productCount": 15084,
"logoUrl": "https://i.etsystatic.com/5793103/r/isla/25e6f2/60438582/isla_500x500.60438582_f12h61bu.jpg",
"shopWebsite": "/shop/AZsupplies",
"reviews": 149090,
"isStar": 1,
"storeUrl": "/shop/AZsupplies",
"reviewsWeekly": 421,
"storeName": "AZsupplies",
"category": [
"565631402af79df4",
"60730d8d2eef8f4f"
],
"startAt": "2010-02-05 01:59:35",
"status": 1
},
{
"favorites": 6528,
"country": [
"US"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 40000,
"favoritesWeekly": 2072,
"salesWeekly": 3033,
"storeId": "49772883",
"productCount": 21,
"logoUrl": "https://i.etsystatic.com/49772883/r/isla/010345/72480394/isla_180x180.72480394_bcrxkac7.jpg",
"shopWebsite": "https://www.etsy.com/shop/MysticTarotGuide",
"reviews": 3650,
"isStar": 0,
"storeUrl": "https://www.etsy.com/shop/MysticTarotGuide",
"reviewsWeekly": 38,
"storeName": "MysticTarotGuide",
"category": [
"dddaa894234df841"
],
"startAt": "2024-05-29 00:10:41",
"status": 1
},
{
"favorites": 73579,
"country": [
"CA"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 559400,
"favoritesWeekly": 706,
"salesWeekly": 2800,
"storeId": "15888388",
"productCount": 439,
"logoUrl": "https://i.etsystatic.com/15888388/r/isla/08d730/60423365/isla_180x180.60423365_sji9bndx.jpg",
"shopWebsite": "https://www.etsy.com/shop/MJsOffTheHookDesigns",
"reviews": 43340,
"isStar": 1,
"storeUrl": "https://www.etsy.com/shop/MJsOffTheHookDesigns",
"reviewsWeekly": 103,
"storeName": "MJsOffTheHookDesigns",
"category": [
"dddaa894234df841",
"60730d8d2eef8f4f",
"efe0bd2c212eceec"
],
"startAt": "2017-08-31 07:55:31",
"status": 1
},
{
"favorites": 75057,
"country": [
"US"
],
"isRaving": 1,
"rating": 487,
"salesTotal": 961258,
"favoritesWeekly": 313,
"salesWeekly": 2792,
"storeId": "10067510",
"productCount": 6911,
"logoUrl": "https://i.etsystatic.com/10067510/r/isla/709554/34852290/isla_500x500.34852290_mkcb9mua.jpg",
"shopWebsite": "/shop/stonesdirect",
"reviews": 176144,
"isStar": 1,
"storeUrl": "/shop/stonesdirect",
"reviewsWeekly": 420,
"storeName": "stonesdirect",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2014-10-02 23:38:25",
"status": 1
},
{
"favorites": 23975,
"country": [
"CN"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 627500,
"favoritesWeekly": 166,
"salesWeekly": 2788,
"storeId": "19202076",
"productCount": 4624,
"logoUrl": "https://i.etsystatic.com/19202076/r/isla/df2cd2/54636778/isla_500x500.54636778_n04ucoor.jpg",
"shopWebsite": "/shop/CreationCraftStudio",
"reviews": 66250,
"isStar": 1,
"storeUrl": "/shop/CreationCraftStudio",
"reviewsWeekly": 244,
"storeName": "CreationCraftStudio",
"category": [
"60730d8d2eef8f4f",
"dddaa894234df841",
"98edb85b00d9527a"
],
"startAt": "2018-12-27 12:50:44",
"status": 1
},
{
"favorites": 63490,
"country": [
"US"
],
"isRaving": 1,
"rating": 479,
"salesTotal": 1609186,
"favoritesWeekly": 200,
"salesWeekly": 2703,
"storeId": "10162345",
"productCount": 2172,
"logoUrl": "https://i.etsystatic.com/10162345/r/isla/2b61f9/17468509/isla_500x500.17468509_inn5sqst.jpg",
"shopWebsite": "/shop/SeedGeeks",
"reviews": 146656,
"isStar": 1,
"storeUrl": "/shop/SeedGeeks",
"reviewsWeekly": 228,
"storeName": "SeedGeeks",
"category": [
"60730d8d2eef8f4f",
"0a9c8cfb7eb4d0bb"
],
"startAt": "2014-11-01 01:49:42",
"status": 1
},
{
"favorites": 9660,
"country": [
"US"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 173500,
"favoritesWeekly": 272,
"salesWeekly": 2333,
"storeId": "51952023",
"productCount": 2873,
"logoUrl": "https://i.etsystatic.com/51952023/r/isla/5ee6f9/71046291/isla_180x180.71046291_1yad14na.jpg",
"shopWebsite": "https://www.etsy.com/shop/JennyKitchenShop",
"reviews": 4110,
"isStar": 0,
"storeUrl": "https://www.etsy.com/shop/JennyKitchenShop",
"reviewsWeekly": 34,
"storeName": "JennyKitchenShop",
"category": [
"4c34af4f84db571c",
"dddaa894234df841",
"efe0bd2c212eceec"
],
"startAt": "2024-04-26 09:51:33",
"status": 1
},
{
"favorites": 19301,
"country": [
"CN"
],
"isRaving": 0,
"rating": 486,
"salesTotal": 401700,
"favoritesWeekly": 134,
"salesWeekly": 2264,
"storeId": "23414921",
"productCount": 2299,
"logoUrl": "https://i.etsystatic.com/23414921/r/isla/3e3249/43362005/isla_500x500.43362005_87fmd63l.jpg",
"shopWebsite": "/shop/LoveBeadsCords",
"reviews": 58210,
"isStar": 1,
"storeUrl": "/shop/LoveBeadsCords",
"reviewsWeekly": 264,
"storeName": "LoveBeadsCords",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2020-05-27 14:26:25",
"status": 1
},
{
"favorites": 39028,
"country": [
"US"
],
"isRaving": 0,
"rating": 490,
"salesTotal": 310900,
"favoritesWeekly": 626,
"salesWeekly": 2094,
"storeId": "6612469",
"productCount": 351,
"logoUrl": "https://i.etsystatic.com/6612469/r/isla/d5607f/67532039/isla_500x500.67532039_q9spg4ov.jpg",
"shopWebsite": "/shop/BrianaKdesigns",
"reviews": 23778,
"isStar": 1,
"storeUrl": "/shop/BrianaKdesigns",
"reviewsWeekly": 63,
"storeName": "BrianaKdesigns",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2011-11-15 22:46:56",
"status": 1
},
{
"favorites": 24313,
"country": [
"GB"
],
"isRaving": 0,
"rating": 484,
"salesTotal": 538500,
"favoritesWeekly": 562,
"salesWeekly": 1984,
"storeId": "25947065",
"productCount": 1396,
"logoUrl": "https://i.etsystatic.com/25947065/r/isla/0cc238/49528375/isla_500x500.49528375_90nvyayp.jpg",
"shopWebsite": "/shop/Lamoriea",
"reviews": 82570,
"isStar": 1,
"storeUrl": "/shop/Lamoriea",
"reviewsWeekly": 203,
"storeName": "Lamoriea",
"category": [
"dddaa894234df841",
"565631402af79df4"
],
"startAt": "2020-11-09 17:10:05",
"status": 1
},
{
"favorites": 191219,
"country": [
"US"
],
"isRaving": 1,
"rating": 473,
"salesTotal": 1327698,
"favoritesWeekly": 538,
"salesWeekly": 1937,
"storeId": "5400716",
"productCount": 45504,
"logoUrl": "https://i.etsystatic.com/5400716/r/isla/4c8a71/86657365/isla_500x500.86657365_kj6vwj7w.jpg",
"shopWebsite": "/shop/Spoonflower",
"reviews": 205772,
"isStar": 0,
"storeUrl": "/shop/Spoonflower",
"reviewsWeekly": 270,
"storeName": "Spoonflower",
"category": [
"dddaa894234df841",
"60730d8d2eef8f4f"
],
"startAt": "2008-11-11 00:30:11",
"status": 1
},
{
"favorites": 43197,
"country": [
"US"
],
"isRaving": 1,
"rating": 491,
"salesTotal": 928949,
"favoritesWeekly": 110,
"salesWeekly": 1924,
"storeId": "12711311",
"productCount": 5548,
"logoUrl": "https://i.etsystatic.com/12711311/r/isla/fc29ed/78520513/isla_500x500.78520513_kalhfwut.jpg",
"shopWebsite": "/shop/CrcbeadsShop",
"reviews": 146416,
"isStar": 0,
"storeUrl": "/shop/CrcbeadsShop",
"reviewsWeekly": 134,
"storeName": "CrcbeadsShop",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2016-03-15 08:22:47",
"status": 1
}
],
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "storeId",
"sortable": true,
"title": "店铺 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "storeName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "text",
"field": "logoUrl",
"sortable": true,
"title": "店铺头像 URL"
},
{
"filterable": true,
"cellType": "text",
"field": "storeUrl",
"sortable": true,
"title": "店铺链接"
},
{
"filterable": true,
"cellType": "number",
"field": "status",
"sortable": true,
"title": "店铺状态:1=活跃,0=非活跃"
},
{
"filterable": true,
"cellType": "number",
"field": "productCount",
"sortable": true,
"title": "店铺商品数量"
},
{
"filterable": true,
"cellType": "text",
"field": "startAt",
"sortable": true,
"title": "开店日期"
},
{
"filterable": true,
"cellType": "number",
"field": "salesWeekly",
"sortable": true,
"title": "周销量"
},
{
"filterable": true,
"cellType": "number",
"field": "salesTotal",
"sortable": true,
"title": "总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "reviews",
"sortable": true,
"title": "评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewsWeekly",
"sortable": true,
"title": "周新增评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "favorites",
"sortable": true,
"title": "收藏数"
},
{
"filterable": true,
"cellType": "number",
"field": "favoritesWeekly",
"sortable": true,
"title": "周新增收藏数"
},
{
"filterable": true,
"cellType": "number",
"field": "isStar",
"sortable": true,
"title": "是否星标:1=是"
},
{
"filterable": true,
"cellType": "number",
"field": "isRaving",
"sortable": true,
"title": "是否 Raving:1=是"
},
{
"filterable": true,
"cellType": "text",
"field": "category",
"sortable": true,
"title": "主营类目列表"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "评分"
},
{
"filterable": true,
"cellType": "text",
"field": "country",
"sortable": true,
"title": "国家/地区列表"
},
{
"filterable": true,
"cellType": "text",
"field": "shopWebsite",
"sortable": true,
"title": "店铺官网/外链"
}
],
"storeNum": 3931535,
"title": "店铺查询",
"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": "etsy-store-query-example",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_store_query",
"arguments": {
"page": 1,
"pageSize": 20,
"sortBy": 9,
"sortDesc": 1
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "etsy-store-query-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"title\":\"店铺查询\",\"total\":20,\"stores\":[{\"reviews\":269720,\"rating\":484,\"favorites\":103819,\"country\":[\"US\"],\"isRaving\":1,\"salesTotal\":2337140,\"favoritesWeekly\":278,\"salesWeekly\":37140,\"storeId\":\"9901413\",\"productCount\":10576,\"logoUrl\":\"https://i.etsystatic.com/9901413/r/isla/5fb889/87829779/isla_500x500.87829779_6bvbiam9.jpg\",\"shopWebsite\":\"/shop/Beadboat1\"},{\"reviews\":86005,\"rating\":484,\"favorites\":46484,\"country\":[\"US\"],\"isRaving\":1,\"salesTotal\":1021978,\"favoritesWeekly\":331,\"salesWeekly\":21978,\"storeId\":\"18669781\",\"productCount\":971,\"logoUrl\":\"https://i.etsystatic.com/18669781/r/isla/e058f8/73016339/isla_500x500.73016339_f7nxd7m4.jpg\",\"shopWebsite\":\"/shop/SeedCult\"}],\"storeNum\":3931535}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"title": "店铺查询",
"total": 20,
"stores": [
{
"reviews": 269720,
"rating": 484,
"favorites": 103819,
"country": [
"US"
],
"isRaving": 1,
"salesTotal": 2337140,
"favoritesWeekly": 278,
"salesWeekly": 37140,
"storeId": "9901413",
"productCount": 10576,
"logoUrl": "https://i.etsystatic.com/9901413/r/isla/5fb889/87829779/isla_500x500.87829779_6bvbiam9.jpg",
"shopWebsite": "/shop/Beadboat1"
},
{
"reviews": 86005,
"rating": 484,
"favorites": 46484,
"country": [
"US"
],
"isRaving": 1,
"salesTotal": 1021978,
"favoritesWeekly": 331,
"salesWeekly": 21978,
"storeId": "18669781",
"productCount": 971,
"logoUrl": "https://i.etsystatic.com/18669781/r/isla/e058f8/73016339/isla_500x500.73016339_f7nxd7m4.jpg",
"shopWebsite": "/shop/SeedCult"
}
],
"storeNum": 3931535
}
},
"isError": false
}
}