How do I install the Ecommerce Etsy Product Query skill?

Run npx skillmds@latest add nexscope-ai/ecommerce-etsy-product-query in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ecommerce Etsy Product Query safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ecommerce Etsy Product Query?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ecommerce Etsy Product Query free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ecommerce Etsy Product Query?

nexscope-ai (@nexscope-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ecommerce Etsy Product Query by nexscope-ai

Name: Ecommerce Etsy Product Query
Author: nexscope-ai

Ecommerce Etsy Product Query

Query Etsy products with multi-dimensional filters (keyword/URL, price, sales, favorites, reviews, listing date, category, handmade/vintage types, Pick/Bestseller/Raving tags). Trigger when user mentions Etsy products, Etsy listings, Etsy product sourcing, Etsy bestsellers, Etsy handmade, Etsy vintage, Etsy items, or Etsy product query — even if the tool name is not mentioned, as long as the need is to search products, view sales/price/tags, or filter items on Etsy.

nexscope-ai Updated Sep 17, 2026

File contents

Etsy Product Query (`_ehunt_productQuery`)

Key Points

Pagination: page starts at 1; pageSize defaults to 20, maximum 100 (recommended <= 50).
Range Parameters: Same approach as the store interface — begin* / end* pairs.
Sorting: sortBy is 1~6 (upstream sort_by). sortDesc: 1=descending, 2=ascending (different from _ehunt_storeQuery which uses 1/0).
Product Type productType: 1 Handmade, 2 Vintage, 3 Digital, 4 Custom, 9 Other, use commas for multiple selection.
Currency: currencyCode defaults to USD.
Category ID: category is a single category ID; use the category search skill to find the ID first.

Script (Optional)

Command-line debugging: python scripts/etsy_product_query.py ''<JSON>'' (requires NEXSCOPE_API_KEY). See references/api.md for details.

Reference

Input/output parameter tables are in references/api.md.

Authentication

Set the NEXSCOPE_API_KEY environment variable. If authentication fails (401/402) or you see insufficient balance errors, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to get an API Key or top up credits.

Credit Consumption

Dynamic pricing: credits consumed = number of products returned x 1.8. Billed per page of results returned; fetching the next page is essentially a new request, billed again based on the new page''s result count.

Important: This skill''s cost scales dynamically and may consume a significant number of credits in a single call. You must warn the user and let them decide whether to continue.

---name: ecommerce-etsy-product-querydescription: Query Etsy products with multi-dimensional filters (keyword/URL, price, sales, favorites, reviews, listing date, category, handmade/vintage types, Pick/Bestseller/Raving tags). Trigger when user mentions Etsy products, Etsy listings, Etsy product sourcing, Etsy bestsellers, Etsy handmade, Etsy vintage, Etsy items, or Etsy product query — even if the tool name is not mentioned, as long as the need is to search products, view sales/price/tags, or filter items on Etsy.---# Etsy Product Query (`_ehunt_productQuery`)## Key Points- **Pagination**: `page` starts at 1; `pageSize` defaults to 20, maximum 100 (recommended <= 50).- **Range Parameters**: Same approach as the store interface — `begin*` / `end*` pairs.- **Sorting**: `sortBy` is **1~6** (upstream `sort_by`). `sortDesc`: **1=descending, 2=ascending** (different from `_ehunt_storeQuery` which uses 1/0).- **Product Type** `productType`: `1` Handmade, `2` Vintage, `3` Digital, `4` Custom, `9` Other, use commas for multiple selection.- **Currency**: `currencyCode` defaults to `USD`.- **Category ID**: `category` is a single category ID; use the category search skill to find the ID first.## Script (Optional)Command-line debugging: `python scripts/etsy_product_query.py ''<JSON>''` (requires `NEXSCOPE_API_KEY`). See [references/api.md](references/api.md) for details.## ReferenceInput/output parameter tables are in [references/api.md](references/api.md).## AuthenticationSet the `NEXSCOPE_API_KEY` environment variable. If authentication fails (401/402) or you see insufficient balance errors, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to get an API Key or top up credits.## Credit ConsumptionDynamic pricing: credits consumed = number of products returned x 1.8. Billed per page of results returned; fetching the next page is essentially a new request, billed again based on the new page''s result count.> **Important**: This skill''s cost scales dynamically and may consume a significant number of credits in a single call. You must warn the user and let them decide whether to continue.

Frequently asked questions