linkfox-etsy-product-query
按多维度筛选 Etsy 商品（关键词/URL、价格、销量、收藏、评论、上架时间、类目、手工/复古等类型、Pick/Bestsell/Raving 等标签）。当用户提到 Etsy 商品、Etsy listing、Etsy 选品、Etsy 爆款、Etsy handmade、Etsy vintage、etsy items、Etsy商品查询时触发。即使用户未提及工具名，只要在 Etsy 上搜商品、看销量/价格/标签或筛品，也应触发此技能。
How do I install this agent skill?
npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-etsy-product-queryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides functionalities to query Etsy product information and handle user onboarding, authentication, and billing via LinkFox's official services. All operations are legitimate vendor-defined behaviors with no security issues identified.
- Socketwarn
1 alert: gptAnomaly
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Etsy 商品查询（_ehunt_productQuery）
要点
- 分页：
page从 1 起；pageSize默认 20、最大 100（建议 ≤50）。 - 区间入参：与店铺接口相同思路，
begin*/end*成对。 - 排序：
sortBy为 1~6（上游sort_by）。sortDesc：1=降序，2=升序（与_ehunt_storeQuery的 1/0 不同）。 - 商品类型
productType：1手工、2复古、3数字、4定制、9其他，多选用逗号。 - 货币：
currencyCode默认USD。 - 类目 id：
category为单品类 ID；可先通过类目检索类技能拿到 id。
脚本（可选）
命令行调试：python scripts/etsy_product_query.py '<JSON>'（需 LINKFOXAGENT_API_KEY）。详见 references/api.md 末尾。
参考
入参/出参表见 references/api.md。
解决认证和算力问题
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
异常情况
- 未配置API Key：环境变量未配置
LINKFOX_AGENT_API_KEY，也未配置LINKFOXAGENT_API_KEY。 - 响应401或402状态码
- 响应提示算力或余额不足：消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。
算力消耗规则
按动态规则计费：消耗算力 = 返回的商品数 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。
重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/linkfox-ai/linkfox-skills/linkfox-etsy-product-query">View linkfox-etsy-product-query on skillZs</a>