linkfox-etsy-product-query

Original：🇨🇳 Chinese

Translated

2 scriptsChecked / no sensitive code detected

Filter Etsy products by multiple dimensions (keywords/URL, price, sales volume, favorites, reviews, listing time, categories, types like handmade/vintage, tags like Pick/Bestsell/Raving). Trigger this skill when users mention Etsy products, Etsy listing, Etsy product selection, Etsy bestsellers, Etsy handmade, Etsy vintage, etsy items, or Etsy product query. Even if users don't mention the tool name, this skill should be triggered as long as they search for products on Etsy, check sales/price/tags, or filter products.

4installs

Sourcelinkfox-ai/linkfox-skills

Added on2026-08-15

NPX Install

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

SKILL.md Content (Chinese)

View Translation Comparison →

Etsy Product Query (

_ehunt_productQuery

)

Key Points

Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 20, maximum 100 (recommended ≤50).
Range Parameters: Same logic as the store API,
```
begin*
```
/
```
end*
```
are paired.
Sorting:
```
sortBy
```
is 1~6 (upstream
```
sort_by
```
).
```
sortDesc
```
: 1=Descending, 2=Ascending (different from 1/0 in
```
_ehunt_storeQuery
```
).
Product Type
```
productType
```
:
```
1
```
Handmade,
```
2
```
Vintage,
```
3
```
Digital,
```
4
```
Custom,
```
9
```
Others; use commas for multiple selections.
Currency:
```
currencyCode
```
defaults to
```
USD
```
.
Category ID:
```
category
```
is a single category ID; you can obtain the ID through category retrieval skills first.

Script (Optional)

Command-line debugging:

python scripts/etsy_product_query.py '<JSON>'

(requires

LINKFOXAGENT_API_KEY

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

References

See references/api.md for the input/output parameter table.

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 with 401 or 402 Status Code
Response Indicates Insufficient Points or Balance: The message contains content like "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: Points consumed = Number of returned products × 1.8. Billing is based on the number of items returned on the current page; turning to the next page is essentially sending another request, and points are recalculated based on the number of items 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.

linkfox-etsy-product-query

NPX Install

Tags

SKILL.md Content (Chinese)

Etsy Product Query (
`_ehunt_productQuery`
)

Key Points

Script (Optional)

References

Resolve Authentication and Points Issues

Exception Scenarios

Points Consumption Rules

linkfox-etsy-product-query

NPX Install

Tags

SKILL.md Content (Chinese)

Etsy Product Query (_ehunt_productQuery)

Key Points

Script (Optional)

References

Resolve Authentication and Points Issues

Exception Scenarios

Points Consumption Rules

Etsy Product Query (
`_ehunt_productQuery`
)