linkfox-etsy-store-query

Original：🇨🇳 Chinese

Translated

2 scriptsChecked / no sensitive code detected

Filter Etsy stores by multiple dimensions (sales volume, favorites, reviews, store opening time, country, main category, Raving/starred, etc.). Trigger when users mention Etsy stores, Etsy store search, Etsy seller, Etsy store rankings, weekly top-selling Etsy stores, etsy stores, or Etsy store inquiry. Even if users don't mention the tool name, this skill should be triggered as long as they are looking for stores on Etsy, filtering store data, or analyzing store performance.

2installs

Sourcelinkfox-ai/linkfox-skills

Added on2026-08-15

NPX Install

npx skill4agent add linkfox-ai/linkfox-skills linkfox-etsy-store-query

SKILL.md Content (Chinese)

View Translation Comparison →

Etsy Store Inquiry

Key Points

Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 20, maximum 100.
Range Parameters:
```
begin*
```
/
```
end*
```
correspond to upstream comma-separated ranges in pairs; if only one side is filled, the upstream will be "start~" or "~end".
Sorting:
```
sortBy
```
only supports values 8~11 (8 = total sales, 9 = weekly sales, 10 = number of reviews, 11 = number of favorites).
```
sortDesc
```
: 1=descending order, 0=ascending order (do not confuse with
```
sortDesc
```
in the product API).

Script (Optional)

Command line debugging:

python scripts/etsy_store_query.py '<JSON>'

(requires

LINKFOXAGENT_API_KEY

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

References

See references/api.md for input/output parameter tables.

Resolve Authentication and Points Issues

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

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 points or balance: The message contains content such as "insufficient points balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge", or similar meanings.

Points Consumption Rules

Billing follows dynamic rules: Consumed points = number of returned stores × 1.8. Billing is based on the number of results returned on the current page; turning to the next page is essentially sending another request, and points are recalculated based on the number of results returned on the next page.

Important: The service of this skill is calculated dynamically by multiples, which may consume a large number of points at once. Users must be reminded, and it is up to the user to decide whether to continue.