mcpbeat Sign in

Ecommerce Etsy Store Query Agent Skill

by nexscope-ai

Query Etsy stores with multi-dimensional filters (sales, favorites, reviews, store opening date, country, primary category, Raving/Star ratings). Trigger when user mentions Etsy store, Etsy shop search, Etsy seller, Etsy shop ranking, Etsy weekly sales stores, Etsy stores, or Etsy store query — even if the tool name is not mentioned, as long as the need is to find stores, filter store data, or analyze store performance on Etsy.

472 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-store-query

What comes with it

14 896 bytes besides the instruction
manifest.json
references/api.md
scripts/etsy_store_query.py

The instruction itself

6 sections, as written by the author

Etsy Store Query

Key Points

  • Pagination: page starts at 1; pageSize defaults to 20, maximum 100.
  • Range Parameters: begin* / end* pairs correspond to upstream comma-delimited ranges. Filling only one side means the upstream treats it as "start~" or "~end".
  • Sorting: sortBy only supports 8~11 (8 total sales, 9 weekly sales, 10 review count, 11 favorite count). sortDesc: 1=descending, 0=ascending (do not confuse with the product query interface''s sortDesc).

Script (Optional)

Command-line debugging: python scripts/etsy_store_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 credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits.

Credit Consumption

Dynamic pricing: credits consumed = number of stores 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-store-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.