关于 linkfox-etsy-store-query
linkfox-etsy-store-query 是用于查询 Etsy 店铺数据的技能,面向需要按销量、评论或收藏等指标筛选店铺的用户。它支持分页、范围条件和指定排序,并说明了认证与算力不足时的处理方式。
主要功能
- 01分页查询店铺
- 02按指标排序
- 03设置数值区间
- 04处理认证与算力异常
适用场景
- 01按总销量或周销量查看店铺
- 02筛选评论数或收藏数区间内的店铺
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ linkfox-ai/ linkfox-skills --skill linkfox-etsy-store-query安装后在 Claude Code 中输入/linkfox-etsy-store-query确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/api.mdonboarding.mdscripts/etsy_store_query.pyonboarding.py详细介绍
来自项目 READMEEtsy 店铺查询
要点
- 分页:
page从 1 起;pageSize默认 20、最大 100。 - 区间入参:
begin*/end*成对对应上游逗号范围;只填一侧时上游为「起始~」或「~结束」。 - 排序:
sortBy仅 8~11(8 总销量、9 周销量、10 评论数、11 收藏数)。sortDesc:1=降序,0=升序(勿与商品接口的sortDesc混用)。
脚本(可选)
命令行调试:python scripts/etsy_store_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。按本页返回条数计费;翻到下一页,本质上是再发一次请求,再按下一页返回条数重新计算。
重要:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。
评论
支持 Markdown