linkfox-etsy-category-search

Original：🇨🇳 Chinese

Translated

2 scriptsChecked / no sensitive code detected

Etsy category data. You can retrieve category names, ids, and parentIds, which are used as category identifiers for product/shop filtering. This skill is triggered when users mention Etsy categories, Etsy category id, Etsy category tree, Etsy category query, syncEtsyCategory, or category query. Even if users don't mention the tool name, this skill should be triggered as long as they are searching for category ids by keywords in the locally synchronized Etsy category database.

4installs

Sourcelinkfox-ai/linkfox-skills

Added on2026-08-15

NPX Install

npx skill4agent add linkfox-ai/linkfox-skills linkfox-etsy-category-search

SKILL.md Content (Chinese)

View Translation Comparison →

Etsy Category Retrieval

Key Points

Required:
```
keyword
```
(substring match for category name, category id,
```
parentIds
```
).
Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 50, maximum 200.
The returned id
can be used as the category identifier for parameters like
```
category
```
in Etsy product search / shop side (consistent with the specific tool schema).

Script (Optional)

Command line debugging:

python scripts/etsy_category_search.py '<JSON>'

(requires

LINKFOXAGENT_API_KEY

). See the end of references/api.md for details.

References

The input/output parameter table is available in references/api.md.

Resolving Authentication and Credit Issues

When the following exceptions occur, use references/onboarding.md to guide users to resolve the issues:

Exception Scenarios

API Key not configured: Neither
```
LINKFOX_AGENT_API_KEY
```
nor
```
LINKFOXAGENT_API_KEY
```
is configured in environment variables.
Response returns 401 or 402 status code
Response indicates insufficient credits or balance: The message contains content such as "insufficient credits/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge" or similar meanings.

Credit Consumption Rules

No credits are consumed.