mcpField
L
linkfox-etsy-store-query

linkfox-etsy-store-query

github.com/linkfox-ai营销与增长113231 次安装2 周前更新
代码仓库

关于 linkfox-etsy-store-query

linkfox-etsy-store-query 是用于查询 Etsy 店铺数据的技能,面向需要按销量、评论或收藏等指标筛选店铺的用户。它支持分页、范围条件和指定排序,并说明了认证与算力不足时的处理方式。

主要功能

  1. 01分页查询店铺
  2. 02按指标排序
  3. 03设置数值区间
  4. 04处理认证与算力异常

适用场景

  1. 01按总销量或周销量查看店铺
  2. 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.md
onboarding.md
scripts/
etsy_store_query.py
onboarding.py

详细介绍

来自项目 README

Etsy 店铺查询

要点

  • 分页: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