mcpbeat Sign in

Ecommerce Etsy Product Query Agent Skill

by nexscope-ai

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.

543 tokens
context cost
SKILL.md, read when the skill is used
4
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
101
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/nexscope-ai/nexscope-ecommerce-skills --skill ecommerce.etsy-product-query

What comes with it

13 772 bytes besides the instruction
manifest.json
references/api.md
scripts/etsy_product_query.py

The instruction itself

6 sections, as written by the author

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.

How to use it

Copy the folder

Take nexscope-ai/ecommerce.etsy-product-query from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.