编程

Etsy商品查询

试用

按多维度筛选 Etsy 商品（关键词/URL、价格、销量、收藏、评论、上架时间、类目、手工/复古等类型、Pick/Bestsell/Raving 等标签）。当用户提到 Etsy 商品、Etsy listing、Etsy 选品、Etsy 爆款、Etsy handmade、Etsy vintage、etsy items、Etsy商品查询时触发。即使用户未提及工具名，只要在 Etsy 上搜商品、看销量/价格/标签或筛品，也应触发此技能。

它能做什么

按多维度筛选 Etsy 商品（关键词/URL、价格、销量、收藏、评论、上架时间、类目、手工/复古等类型、Pick/Bestsell/Raving 等标签）。当用户提到 Etsy 商品、Etsy listing、Etsy 选品、Etsy 爆款、Etsy handmade、Etsy vintage、etsy items、Etsy商品查询时触发。即使用户未提及工具名，只要在 Etsy 上搜商品、看销量/价格/标签或筛品，也应触发此技能。

技能文档

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 ''（需 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。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

相关技能

Etsy店铺查询

按多维度筛选 Etsy 店铺（销量、收藏、评论、开店时间、国家、主营类目、Raving/星标等）。当用户提到 Etsy 店铺、Etsy 店搜、Etsy seller、Etsy 店铺排行、Etsy 周销量店铺、etsy stores、Etsy店铺查询 时触发。即使用户未提及工具名，只要在 Etsy 上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。

1 次安装

Etsy-商品详情

查询单个 Etsy Listing 的公共商品详情。输入 Etsy 商品直链，返回商品标题与描述、价格区间、币种、主图与图片集、变体、库存上限、类目、发货地与预计送达、店铺资料、评论数量、评分及买家反馈标签等数据。当用户提到 Etsy 商品详情、Etsy listing 解析、Etsy 商品链接查询、竞品 Listing 拆解、价格图片提取、店铺与评论概况、Etsy product details、Etsy listing lookup 时触发。即使用户未明确说“商品详情”，只要提供带数字 listing ID 的 Etsy 商品直链并希望读取当前公开商品页信息，也应触发此技能。

1 次安装

Etsy类目搜索

Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。

1 次安装

Etsy Seller

Etsy shop optimization assistant. Listing SEO, tag selection, pricing strategy, competitor analysis, and shop audits. Encodes Etsy-specific domain expertise that generic AI can't replicate.

2 次安装

Etsy Keyword Search

Etsy keyword search scraper: given a search keyword and optional page number, returns paginated product listings with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShipping, badge from etsy.com search results. Use when user mention

Etsy Category Listing

Etsy category page scraper: given an Etsy category URL (e.g. https://www.etsy.com/c/jewelry) and optional page number, returns paginated product listings with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShipping, badge from categ