{"code":0,"msg":null,"data":{"version":"1.0.0","description":"MCP-compatible metadata for callable Nexscope ecommerce skill APIs.","name":"nexscope-skill-api","authentication":{"type":"apiKey","header":"Authorization","format":"Bearer ${NEXSCOPE_API_KEY}"},"tools":[{"name":"nexscope_data_eh_etsy_etsy_category_search","description":"Etsy Product Research: etsy/etsy Category Search API.","endpoint":"https://api.nexscope.ai/eh/etsy/etsyCategorySearch","method":"POST","inputSchema":{"type":"object","properties":{"keyword":{"type":"string","description":"Keywords: Match category name, category id, parentIds field (substring)","maxLength":200},"page":{"type":"integer","description":"Page number (starting from 1)","minimum":1},"pageSize":{"type":"integer","description":"Number of items per page, maximum 200","minimum":1,"maximum":200}},"required":["keyword"],"additionalProperties":true},"outputSchema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer"},{"type":"null"}]},"categories":{"anyOf":[{"type":"array"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"categoryLevel":{"anyOf":[{"type":"integer"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentIds":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer"},{"type":"null"}]},"page":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]}},"type":"object","required":["code","msg","data","ts","time","cost","traceId"]},"title":"Etsy Product Research: etsy/etsy Category Search API","_meta":{"nexscope/billing":{"consumesCredits":true,"instruction":"Check current pricing before execution. Do not automatically retry a paid call."},"nexscope/inputExamples":[{"keyword":"jewelry","page":1,"pageSize":50}],"nexscope/examplesAreIllustrative":true}},{"name":"nexscope_data_etsy_product_detail","description":"Etsy Product Research: product/detail API.","endpoint":"https://api.nexscope.ai/etsy/product/detail","method":"POST","inputSchema":{"type":"object","properties":{"productUrl":{"type":"string","description":"Etsy products HTTPS direct link. Userinfo must not be included; Host must be `etsy.com` or its subdomain, port must be omitted or `443`; path must be `/listing/<numeric ID>`, with at most one non-empty title slug, and can have trailing slashes and query parameters"}},"required":["productUrl"],"additionalProperties":true},"outputSchema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array"},{"type":"null"}]},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopId":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopSales":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopName":{"anyOf":[{"type":"string"},{"type":"null"}]},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"searchPosition":{"anyOf":[{"type":"string"},{"type":"null"}]},"image":{"anyOf":[{"type":"string"},{"type":"null"}]},"images":{"anyOf":[{"type":"array"},{"type":"null"}]},"maxQuantity":{"anyOf":[{"type":"integer"},{"type":"null"}]},"variants":{"anyOf":[{"type":"array"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"array"},{"type":"null"}]},"shopReviews":{"anyOf":[{"type":"integer"},{"type":"null"}]},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}]},"star":{"anyOf":[{"type":"string"},{"type":"null"}]},"highlightsTags":{"anyOf":[{"type":"array"},{"type":"null"}]},"reviewsTags":{"anyOf":[{"type":"array"},{"type":"null"}]},"yearsOnEtsy":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasRatingsBadge":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"hasConvosBadge":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"hasShippingBadge":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"reviewsScores":{"anyOf":[{"type":"object"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryShippingFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"moreLikeUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer"},{"type":"null"}]},"page":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]}},"type":"object","required":["code","msg","data","ts","time","cost","traceId"]},"title":"Etsy Product Research: product/detail API","_meta":{"nexscope/billing":{"consumesCredits":true,"instruction":"Check current pricing before execution. Do not automatically retry a paid call."},"nexscope/inputExamples":[{"productUrl":"https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"}],"nexscope/examplesAreIllustrative":true}},{"name":"nexscope_data_eh_etsy_product_query","description":"Etsy Product Research: etsy/product Query API.","endpoint":"https://api.nexscope.ai/eh/etsy/productQuery","method":"POST","inputSchema":{"type":"object","properties":{"beginFavorites":{"type":"integer","description":"The number of favorites (starting), together with the ending value, form the upstream favorites","minimum":0},"beginFavoritesWeekly":{"type":"integer","description":"Number of new favorites per week (start), which together with the end value form the upstream favorites_weekly","minimum":0},"beginPrice":{"type":"number","description":"Price (start), together with the end price, form the upstream price (such as 20~100); when filling in only one side, the upstream is start~ or ~end","minimum":0},"beginReviews":{"type":"integer","description":"The number of reviews (starting), which together with the end value form the upstream reviews","minimum":0},"beginReviewsWeekly":{"type":"integer","description":"Number of new comments per week (start), which together with the end value form the upstream reviews_weekly","minimum":0},"beginSales":{"type":"integer","description":"Total sales (starting), which together with the ending value form the upstream sales","minimum":0},"beginSalesWeekly":{"type":"integer","description":"Weekly sales volume (start), together with the end value, form the upstream sales_weekly (such as 1~100)","minimum":0},"category":{"type":"string","description":"Product classification ID (single product category), please see the product classification interface for details","maxLength":1000},"country":{"type":"string","description":"Shipping country","maxLength":1000},"currencyCode":{"type":"string","description":"Currency code, default `USD`","maxLength":1000},"endFavorites":{"type":"integer","description":"Number of collections (end)","minimum":0},"endFavoritesWeekly":{"type":"integer","description":"Number of new favorites per week (end)","minimum":0},"endPrice":{"type":"number","description":"Price (end), which together with the starting price forms the upstream price","minimum":0},"endReviews":{"type":"integer","description":"Number of comments (end)","minimum":0},"endReviewsWeekly":{"type":"integer","description":"Number of new comments per week (end)","minimum":0},"endSales":{"type":"integer","description":"Total sales (end)","minimum":0},"endSalesWeekly":{"type":"integer","description":"Weekly sales (end)","minimum":0},"isBestsell":{"type":"integer","description":"Is it a best-selling product?"},"isPick":{"type":"integer","description":"Whether to Pick the product"},"isRaving":{"type":"integer","description":"Whether Raving product"},"listedTime":{"type":"string","description":"The shelf time is no earlier than this date (YYYY-MM-DD)"},"page":{"type":"integer","description":"Page number (starting from 1)","minimum":1},"pageSize":{"type":"integer","description":"Number of entries per page, maximum 100, recommended not to exceed 50","minimum":1,"maximum":100},"productType":{"type":"string","description":"Product type, multiple commas separated: 1=Handmade 2=Vintage 3=Digital 4=Customized 9=Other"},"searchKey":{"type":"string","description":"Search keywords or Etsy product URLs","maxLength":500},"sortBy":{"type":"integer","description":"Sorting field (corresponding to upstream sort_by, value 1~6)","minimum":1,"maximum":6},"sortDesc":{"type":"integer","description":"Sorting direction (corresponds to upstream `desc`). Schema example: Descending `1`, Ascending `2`"},"status":{"type":"integer","description":"Product status (example: 1 on the shelves, 0 off the shelves)"}},"required":[],"additionalProperties":true},"outputSchema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array"},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer"},{"type":"null"}]},"productNum":{"anyOf":[{"type":"integer"},{"type":"null"}]},"title":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"null"}]},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"products":{"anyOf":[{"type":"array"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"favorites":{"anyOf":[{"type":"integer"},{"type":"null"}]},"favoritesWeekly":{"anyOf":[{"type":"integer"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isBestsell":{"anyOf":[{"type":"integer"},{"type":"null"}]},"isPick":{"anyOf":[{"type":"integer"},{"type":"null"}]},"isRaving":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}]},"reviewsWeekly":{"anyOf":[{"type":"integer"},{"type":"null"}]},"salesTotal":{"anyOf":[{"type":"integer"},{"type":"null"}]},"salesWeekly":{"anyOf":[{"type":"integer"},{"type":"null"}]},"shipsFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"integer"},{"type":"null"}]},"storeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer"},{"type":"null"}]},"page":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]}},"type":"object","required":["code","msg","data","ts","time","cost","traceId"]},"title":"Etsy Product Research: etsy/product Query API","_meta":{"nexscope/billing":{"consumesCredits":true,"instruction":"Check current pricing before execution. Do not automatically retry a paid call."},"nexscope/inputExamples":[{"searchKey":"poster","currencyCode":"USD","page":1,"pageSize":20}],"nexscope/examplesAreIllustrative":true}},{"name":"nexscope_data_eh_etsy_store_query","description":"Etsy Product Research: etsy/store Query API.","endpoint":"https://api.nexscope.ai/eh/etsy/storeQuery","method":"POST","inputSchema":{"type":"object","properties":{"beginFavorites":{"type":"integer","description":"The number of store collections (starting), and the ending value form the upstream favorites","minimum":0},"beginFavoritesWeekly":{"type":"integer","description":"The store adds new favorites in the week (start), which together with the end value form the upstream favorites_weekly","minimum":0},"beginReviews":{"type":"integer","description":"The number of store reviews (starting), which together with the ending value form the upstream reviews","minimum":0},"beginReviewsWeekly":{"type":"integer","description":"Added reviews for the store week (start), which together with the end value form the upstream reviews_weekly","minimum":0},"beginSales":{"type":"integer","description":"The total sales volume of the store (starting), and the ending value form the upstream sales","minimum":0},"beginSalesWeekly":{"type":"integer","description":"Store weekly sales (start), which together with the end value form the upstream sales_weekly, such as 10,100","minimum":0},"beginStoreOpenedAt":{"type":"string","description":"The start of the store opening time interval (YYYY-MM-DD), and the end date form the upstream start_at, such as 2020-01-01~2023-01-01"},"category":{"type":"string","description":"Store main categories","maxLength":1000},"country":{"type":"string","description":"Store country","maxLength":1000},"endFavorites":{"type":"integer","description":"Number of store collections (end)","minimum":0},"endFavoritesWeekly":{"type":"integer","description":"Store Weekly Added Favorites (Ended)","minimum":0},"endReviews":{"type":"integer","description":"Number of store reviews (end)","minimum":0},"endReviewsWeekly":{"type":"integer","description":"New comments for store week (end)","minimum":0},"endSales":{"type":"integer","description":"Total store sales (end)","minimum":0},"endSalesWeekly":{"type":"integer","description":"Store weekly sales (end)","minimum":0},"endStoreOpenedAt":{"type":"string","description":"The store opening time interval ends (YYYY-MM-DD)"},"isRaving":{"type":"integer","description":"Whether Raving Shop: 1=Yes"},"isStar":{"type":"integer","description":"Whether to star the store: 1=Yes"},"page":{"type":"integer","description":"Page number (starting from 1)","minimum":1},"pageSize":{"type":"integer","description":"Number of items per page, maximum 100","minimum":1,"maximum":100},"searchKey":{"type":"string","description":"Search keywords or store name, store URL","maxLength":500},"sortBy":{"type":"integer","description":"Sorting field sort_by: 8=total sales, 9=weekly sales, 10=number of comments, 11=number of collections","minimum":8,"maximum":11},"sortDesc":{"type":"integer","description":"Sorting direction (corresponding to upstream desc): 1=descending order, 0=ascending order"},"status":{"type":"integer","description":"Store status: 1=active, 0=inactive"}},"required":[],"additionalProperties":true},"outputSchema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"stores":{"anyOf":[{"type":"array"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array"},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer"},{"type":"null"}]},"storeNum":{"anyOf":[{"type":"integer"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"array"},{"type":"null"}]},"country":{"anyOf":[{"type":"array"},{"type":"null"}]},"favorites":{"anyOf":[{"type":"integer"},{"type":"null"}]},"favoritesWeekly":{"anyOf":[{"type":"integer"},{"type":"null"}]},"isRaving":{"anyOf":[{"type":"integer"},{"type":"null"}]},"isStar":{"anyOf":[{"type":"integer"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"productCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"rating":{"anyOf":[{"type":"number"},{"type":"null"}]},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}]},"reviewsWeekly":{"anyOf":[{"type":"integer"},{"type":"null"}]},"salesTotal":{"anyOf":[{"type":"integer"},{"type":"null"}]},"salesWeekly":{"anyOf":[{"type":"integer"},{"type":"null"}]},"shopWebsite":{"anyOf":[{"type":"string"},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"integer"},{"type":"null"}]},"storeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"storeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"storeUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer"},{"type":"null"}]},"page":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]}},"type":"object","required":["code","msg","data","ts","time","cost","traceId"]},"title":"Etsy Product Research: etsy/store Query API","_meta":{"nexscope/billing":{"consumesCredits":true,"instruction":"Check current pricing before execution. Do not automatically retry a paid call."},"nexscope/inputExamples":[{"searchKey":"ceramic","country":"US","page":1,"pageSize":20}],"nexscope/examplesAreIllustrative":true}}],"jsonRpcEndpoint":{"url":"https://api.nexscope.ai/api/skill-api/v1/mcp","protocol":"MCP JSON-RPC over HTTP","method":"POST","supportedMethods":["initialize","tools/list","tools/call"]}},"ts":"1792169581016","time":"2026-10-16 16:53:01","cost":"2","traceId":null}