# Ecommerce Etsy Category Search

> 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.

- Skill: `nexscope-ai/ecommerce-etsy-category-search` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add nexscope-ai/ecommerce-etsy-category-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nexscope-ai/ecommerce-etsy-category-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nexscope-ai (https://skillmd.com/u/nexscope-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nexscope-ai/ecommerce-etsy-category-search

---


# 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](references/api.md) for details.

## Reference

Input/output parameter tables are in [references/api.md](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.