mcpField
L
linkfox-sorftime-walmart-category-market

linkfox-sorftime-walmart-category-market

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

关于 linkfox-sorftime-walmart-category-market

该 LinkFox skill 使用 Sorftime 数据查询 Walmart 美国站类目层级、匹配自然语言类目名称，或查看单个已知类目的市场报告及返回的 Best Seller 商品。它按请求执行单一操作，不涵盖商品或关键词数据。

主要功能

  1. 01获取完整类目树
  2. 02匹配自然语言类目名称
  3. 03按已知路径查询类目报告
  4. 04查看报告返回的 Best Seller 商品

适用场景

  1. 01浏览 Walmart 美国站类目层级
  2. 02将类目描述匹配到相关类目
  3. 03分析已知类目的市场指标与热销商品

MCP 相关

未说明 MCP 接口或 MCP 相关能力。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-sorftime-walmart-category-market

安装后在 Claude Code 中输入/linkfox-sorftime-walmart-category-market确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
onboarding.md
scripts/
onboarding.py
sorftime_walmart_category_market.py

详细介绍

Walmart 类目市场研究

使用 Sorftime 数据获取 Walmart 美国站的类目层级、匹配自然语言类目名称，或查看某个类目的市场报告和返回的 Best Seller 商品。

核心概念

  • 每个请求只能发送一个 operation。不要自动串联操作；每次调用都会消耗 Sorftime 请求次数。
  • tree 返回完整的类目层级，无需其他业务参数。
  • searchByName 接受自然语言类目名称，并最多返回三个相关类目匹配项。
  • marketReport 需要已知的 nodePath。切勿根据类目名称猜测路径。
  • 所有字段都平铺在 JSON 请求体的顶层。operation 的值区分大小写。

操作路由

意图operation其他参数Sorftime 请求次数
下载类目树tree无5
匹配自然语言类目名称searchByNamename1
查询类目市场报告marketReportnodePath5

完整参数和响应详情见 references/api.md。

调用方式

  • API 端点：POST /sorftime/walmart/categoryMarket（完整参数、响应和错误码见 references/api.md）
  • Python 脚本：python scripts/sorftime_walmart_category_market.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗算力；同一会话中相同参数组合默认只调用一次，脚本带有 24h 本地缓存。失败或结果为空时，不得自动更换关键词、翻页或更改邮编连续试探；需要继续检索时，先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-walmart-category-market-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 中即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写时则报错）
  • 响应体 ≤ 8 KB：写入文件后，将完整 JSON 打印到 stdout
  • 响应体 > 8 KB：写入文件后，stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度及前 3 条样本）
  • 添加 --inline 可强制将完整内容打印到 stdout（同样写入文件）

读取数据建议：先查看摘要，判断信息是否足够；需要具体字段时，优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件中按需提取，避免将整份 JSON 加载到上下文中。

解决认证和算力问题

发生以下异常情况时，按照 references/onboarding.md 中的说明解决问题：

  • 未配置 API Key：未配置环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY
  • 响应 401 或 402 状态码
  • 响应提示算力或余额不足：消息中包含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义

使用示例

python scripts/sorftime_walmart_category_market.py '{"operation":"tree"}'
python scripts/sorftime_walmart_category_market.py '{"operation":"searchByName","name":"patio furniture"}'
python scripts/sorftime_walmart_category_market.py '{"operation":"marketReport","nodePath":"4044_623679_1032619_5842891_9823303"}'

用户提供自然语言类目名称时，优先使用 searchByName。仅在需要遍历完整层级时使用 tree。树形响应可能约为 10 MB；通常应有选择地查看保存的 JSON，而不是使用 --inline。

显示规则

  1. 说明所选操作，并在返回时展示 requestConsumed、costCredit 和 costToken。如果 _cache.hit=true，需明确说明缓存值描述的是原始实时请求，且没有产生新的生产费用。
  2. 对于 tree，展示匹配的类目名称、其 ID 层级以及推导出的 nodePath；切勿将完整树形数据倾倒到对话中。
  3. 对于 searchByName，最多展示返回的三个 NodeId 和 CategoryName 配对；将其标注为相关匹配项，而非精确分类。
  4. 对于 marketReport，仅总结返回的指标，并简洁列出 Best Seller 商品。
  5. 说明实际返回的 Best Seller 商品数量，且不得将结果描述为整个类目目录。
  6. 保留上游字段的含义，切勿臆造缺失的类目关系或指标。

重要限制

  • 三种操作都针对 Walmart 美国站（后端会应用 domain=21）。
  • Sorftime 可能会省略不适合第三方卖家的类目；未返回某个类目并不能证明 Walmart 没有该类目。
  • marketReport 接受由数字和下划线组成的 nodePath，不接受自由文本类目名称。
  • searchByName 最多返回三个相关类目，且不保证精确匹配。
  • tree 和 marketReport 各消耗 5 次上游请求；searchByName 消耗 1 次。未经用户授权，不得重试或运行其他操作。
  • 此技能不涵盖商品或关键词数据。

用户表达与场景速查

适用范围：Walmart 类目树、自然语言类目匹配、类目 NodeId/路径、类目市场和类目 Best Seller 请求。

不适用范围：产品详情/趋势/销量、关键词指标或已保存关键词管理。

边界判断：如果主要对象是 Walmart 产品 ID，请使用产品分析。查询类目名称时使用 searchByName，遍历层级时使用 tree，已知类目路径时使用 marketReport。

算力消耗规则

按动态规则计费：单个 Sorftime Request 当前显示为 6 算力；多 Request 操作由网关按整单计算并取整，最终以入口脚本返回的 costCredit 为准，不要简单用 requestConsumed × 6 代替实际账单。

用户会因算力消耗而支付费用。必须提醒用户，并让用户决定是否继续执行另一个 operation。

反馈：

当技能行为或结果与意图不符、用户表达赞赏或不满，或发现可改进之处时，通过 Feedback API 自动检测并提交反馈。按照 references/api.md 中的说明调用，不要打断用户的流程。

如需了解更多优质、专业的跨境电商技能，请访问 LinkFox Skills。

评论

支持 Markdown