用途:面向 Walmart 美国站的关键词研究技能,通过 Sorftime 接口完成关键词发现、指标查看、商品反查词与相关词扩展,并可管理收藏关键词目录。
主要能力(每次请求只执行一个 operation,区分大小写):marketQuery 筛选当前热词;searchByName 按商品或类目名称找热词;searchProducts 查某热词的搜索结果商品;detail 查看关键词指标;productKeywords 按 productId 查商品关联词;relatedKeywords 扩展相关词;favoriteAdd 添加收藏词;favoriteChange 删除或移动收藏词;favoriteList 列出收藏词或目录。
使用方式:API 端点 POST /sorftime/walmart/keywordResearch;脚本调用 python scripts/sorftime_walmart_keyword_research.py '<JSON 参数>' [--inline]。参数为扁平 JSON,仅 marketQuery 可含 pattern 对象。分页默认第 1 页、20 条,最大 200。完整参数矩阵见 references/api.md。
输出与缓存:完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON 文件;≤8KB 全量打印,>8KB 只打印摘要,--inline 强制全量。只读操作同参数 24h 本地缓存,收藏类操作始终绕过缓存。
限制:仅支持 Walmart 美国站;热词数据、15 天商品窗口、30 天商品关键词窗口为 Sorftime 约束;单个收藏目录最多 2000 个关键词;API 收藏库与 Sorftime Professional 收藏不同步;空结果不得自动换词、翻页或改邮编;收藏变更需明确授权;计费按动态规则,以返回的 costCredit 为准。认证问题参见 references/onboarding.md。