mcpbeat Sign in

Ecommerce Etsy Category Search Agent Skill

by nexscope-ai

Search Etsy category data by name, ID, or parent IDs to find category identifiers for product/store filtering. Trigger when user mentions Etsy category, Etsy category ID, Etsy category tree, Etsy category lookup, syncEtsyCategory, or category search — even if the tool name is not mentioned, as long as the need is to find a category ID by keyword in a locally synced Etsy category library.

352 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-category-search

What comes with it

10 610 bytes besides the instruction
manifest.json
references/api.md
scripts/etsy_category_search.py

The instruction itself

6 sections, as written by the author

Etsy Category Search

Key Points

  • Required: keyword (substring match against category name, category ID, parentIds).
  • Pagination: page starts at 1; pageSize defaults to 50, maximum 200.
  • The returned id can be used as the category identifier for Etsy product search / store query category parameters (consistent with the specific tool schema).

Script (Optional)

Command-line debugging: python scripts/etsy_category_search.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

Does not consume credits.

How to use it

Copy the folder

Take nexscope-ai/ecommerce.etsy-category-search 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.