linkfox-sorftime-walmart-product-analysis

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Walmart 产品分析

Use Sorftime to find Walmart US products by a natural-language name or inspect one product's detail, historical trend, or daily sales-volume series.

使用Sorftime按自然语言名称查找Walmart美国站商品，或查看单个商品的详情、历史趋势或按日销量数据序列。

Core Concepts

Send exactly one
```
operation
```
per request. Never call all four operations as a default workflow.
Use
```
searchByName
```
to discover related products,
```
detail
```
for the current product summary,
```
trend
```
for historical product changes, and
```
salesVolume
```
for dated sales rows.
Every request uses a flat JSON body.
```
searchByName
```
requires
```
name
```
; the other operations require string
```
productId
```
.
```
operation
```
values are case-sensitive.
A follow-up operation or a different date range is another paid call. Reuse the 24-hour cache for identical JSON.

每个请求仅发送一个
```
operation
```
（操作）。切勿将四个操作全部调用作为默认工作流程。
使用
```
searchByName
```
发现相关商品，
```
detail
```
获取当前商品摘要，
```
trend
```
查看商品历史变化，
```
salesVolume
```
获取按日期统计的销量数据行。
每个请求使用扁平JSON格式的请求体。
```
searchByName
```
需要
```
name
```
参数；其他操作需要字符串类型的
```
productId
```
参数。
```
operation
```
的值区分大小写。
后续操作或不同日期范围的查询属于另一次付费调用。相同JSON请求可复用24小时缓存。

Operation Routing

Intent	operation	Parameters	Sorftime Request
Find related products by name	`searchByName`	`name` , optional `pageIndex`	2
Current product details	`detail`	`productId`	1
Historical product trend	`trend`	`productId`	2
Daily/variant sales rows	`salesVolume`	`productId` , optional dates/page	1

Read

references/api.md

before calling for exact date and pagination rules.

意图	operation	参数	Sorftime 请求次数
按名称查找相关商品	`searchByName`	`name` ，可选 `pageIndex`	2
当前商品详情	`detail`	`productId`	1
商品历史趋势	`trend`	`productId`	2
按日/变体销量数据行	`salesVolume`	`productId` ，可选日期/页码	1

调用前请阅读

references/api.md

了解具体日期和分页规则。

Parameter Guide

Always treat
```
productId
```
as a string, even when it contains digits only.
```
searchByName
```
accepts a natural-language product name and returns up to 100 related products per page;
```
pageIndex
```
defaults to 1.
```
salesVolume
```
accepts optional
```
queryDate
```
and
```
queryEndDate
```
in
```
yyyy-MM-dd
```
. With neither, it returns the recent 30-day range; with only
```
queryDate
```
, the end defaults to the current day.
```
pageIndex
```
applies to
```
searchByName
```
and
```
salesVolume
```
, starts at 1, and defaults to 1.
The current available historical range is controlled by Sorftime; do not promise a fixed earliest date.

始终将
```
productId
```
视为字符串类型，即使它仅包含数字。
```
searchByName
```
接受自然语言格式的商品名称，每页最多返回100个相关商品；
```
pageIndex
```
默认值为1。
```
salesVolume
```
接受可选的
```
queryDate
```
和
```
queryEndDate
```
参数，格式为
```
yyyy-MM-dd
```
。若未提供这两个参数，将返回最近30天的数据；若仅提供
```
queryDate
```
，结束日期默认设为当前日期。
```
pageIndex
```
适用于
```
searchByName
```
和
```
salesVolume
```
，起始值为1，默认值为1。
当前可用的历史数据范围由Sorftime控制；请勿承诺固定的最早日期。

调用方式

API 端点：

POST /sorftime/walmart/productAnalysis

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

python scripts/sorftime_walmart_product_analysis.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-walmart-product-analysis-<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 进入上下文。

API 端点：

POST /sorftime/walmart/productAnalysis

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

python scripts/sorftime_walmart_product_analysis.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带24h本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-walmart-product-analysis-<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/套餐到期/需充值/请充值”或类似含义

发生以下异常情况时，采用

references/onboarding.md

引导解决问题：

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

Usage Examples

bash

python scripts/sorftime_walmart_product_analysis.py '{"operation":"searchByName","name":"wireless earbuds","pageIndex":1}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"detail","productId":"5169493923"}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"trend","productId":"5169493923"}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"salesVolume","productId":"5169493923","queryDate":"2026-07-01","queryEndDate":"2026-07-31","pageIndex":1}'

bash

python scripts/sorftime_walmart_product_analysis.py '{"operation":"searchByName","name":"wireless earbuds","pageIndex":1}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"detail","productId":"5169493923"}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"trend","productId":"5169493923"}'
python scripts/sorftime_walmart_product_analysis.py '{"operation":"salesVolume","productId":"5169493923","queryDate":"2026-07-01","queryEndDate":"2026-07-31","pageIndex":1}'

Display Rules

State the operation and supplied product name or product ID, and show returned
```
requestConsumed
```
and
```
costToken
```
.
For
```
searchByName
```
, label results as related products rather than exact matches and report the requested page.
For
```
detail
```
, present only fields returned by the ProductSummeryObject; do not infer missing attributes.
For
```
trend
```
, identify time fields and units from the response before summarizing changes.
For
```
salesVolume
```
, interpret rows as
```
[date, sales, type]
```
;
```
type=2
```
marks yesterday's sales record.
Label estimates or observed values accurately; do not present them as guaranteed Walmart transactions.

说明所执行的操作以及提供的商品名称或product ID，并展示返回的
```
requestConsumed
```
和
```
costToken
```
。
对于
```
searchByName
```
操作，需将结果标注为相关商品而非精确匹配，并说明请求的页码。
对于
```
detail
```
操作，仅展示ProductSummeryObject返回的字段；请勿推断缺失的属性。
对于
```
trend
```
操作，在总结变化前需从响应中识别时间字段和单位。
对于
```
salesVolume
```
操作，将数据行解析为
```
[date, sales, type]
```
格式；
```
type=2
```
标记的是昨日的销量记录。
准确标注估算值或观测值；请勿将其表述为Walmart的确定性交易数据。

Important Limitations

This integration targets Walmart US only.
The API accepts one product name or one product ID and one operation per call.
Sorftime controls historical coverage and data availability.
Pagination or a second operation creates another paid call and requires user authorization.
```
searchByName
```
is natural-language related-product discovery, not a multi-filter product database or category-market query.

本集成仅针对Walmart美国站。
API每次调用仅接受一个商品名称或一个product ID，且仅执行一个操作。
历史数据覆盖范围和数据可用性由Sorftime控制。
分页操作或第二次操作属于另一次付费调用，需获得用户授权。
```
searchByName
```
是基于自然语言的相关商品发现功能，而非多筛选条件的商品数据库或类目市场查询。

User Expression & Scenario Quick Reference

Applicable: finding Walmart products from a natural-language product name, or queries centered on a known ProductId and its details, trend, or sales history.

Not applicable: category market research, keyword metrics/reverse lookup, or multi-condition product filtering.

Boundary judgment: Use

searchByName

only when the user needs related products from a name; use

detail

for a current snapshot,

trend

for historical attributes, and

salesVolume

only for dated sales rows.

适用场景：通过自然语言商品名称查找Walmart商品，或针对已知ProductId查询其详情、趋势或销售历史。

不适用场景：类目市场调研、关键词指标/反向查询或多条件商品筛选。

边界判断：仅当用户需要通过名称查找相关商品时使用

searchByName

；使用

detail

获取当前快照，

trend

查看历史属性，仅当需要按日期的销量数据行时使用

salesVolume

。

积分消耗规则

按动态规则计费：消耗积分 = Sorftime内部查询次数 × 12。Sorftime内部查询次数：不同 operation 需要的查询次数可能不同，实际次数由 Sorftime 决定。

用户会因积分消耗而支付费用。不要未经确认补调另一 operation 或下一页。

Feedback:

Auto-detect and report feedback via the Feedback API when behavior or results mismatch intent, the user expresses praise or dissatisfaction, or an improvement is apparent. Follow

references/api.md

without interrupting the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

按动态规则计费：消耗积分 = Sorftime内部查询次数 × 12。Sorftime内部查询次数：不同 operation 需要的查询次数可能不同，实际次数由 Sorftime 决定。

用户会因积分消耗而支付费用。不要未经确认补调另一 operation 或下一页。

Feedback:

当行为或结果与意图不符、用户表达赞扬或不满，或存在明显改进空间时，自动检测并通过Feedback API提交反馈。请遵循

references/api.md

的要求，不要打断用户的流程。

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