linkfox-shopify-product-query

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Shopify 商品查询

Shopify Product Query

要点

Key Points

分页：
```
page
```
从 1 起；
```
pageSize
```
默认 20、最大 100（建议 ≤50）。
区间入参：
```
*Min
```
/
```
*Max
```
成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。
排序：
```
sortBy
```
为整数枚举（默认
```
14
```
=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见
```
references/api.md
```
）。
布尔类筛选：
```
facebookAd
```
（1=有广告）、
```
hasSupplier
```
（1=有货源，0=无）、
```
showDeleted
```
（1=含已下架）均为整数开关。
发货国家：
```
country
```
传两位国家代码（如
```
US
```
）。

Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 20, maximum 100 (recommended ≤50).
Range Parameters:
```
*Min
```
/
```
*Max
```
appear in pairs to form an upstream range; when only one side is filled, the upstream is "start~" or "~end".
Sorting:
```
sortBy
```
is an integer enumeration (default
```
14
```
= weekly sales descending order, also includes multiple values such as price/number of ads/competition level/sales amount, see
```
references/api.md
```
for details).
Boolean Filters:
```
facebookAd
```
(1 = has ads),
```
hasSupplier
```
(1 = has suppliers, 0 = no suppliers),
```
showDeleted
```
(1 = includes removed products) are all integer switches.
Shipping Country:
```
country
```
passes a two-digit country code (e.g.,
```
US
```
).

脚本（可选）

Script (Optional)

命令行调试：

python scripts/shopify_product_query.py '<JSON>'

（需

LINKFOXAGENT_API_KEY

）。详见 references/api.md 末尾。

Command line debugging:

python scripts/shopify_product_query.py '<JSON>'

(requires

LINKFOXAGENT_API_KEY

). See the end of references/api.md for details.

解决认证和积分问题

Resolve Authentication and Points Issues

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

When the following exceptions occur, guide users to resolve them using references/onboarding.md:

异常情况

Exception Scenarios

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

API Key Not Configured: The environment variable
```
LINKFOX_AGENT_API_KEY
```
is not configured, nor is
```
LINKFOXAGENT_API_KEY
```
.
401 or 402 Status Code Response
Response Indicates Insufficient Points or Balance: The message contains "insufficient points balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge" or similar meanings.

参考

References

入参/出参表见 references/api.md。

See references/api.md for the parameter input/output table.

积分消耗规则

Points Consumption Rules

按动态规则计费：消耗积分 = 返回的商品数 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

Billed by dynamic rules: Points consumed = Number of returned products × 1.8. Billed based on the number of items returned on this page; turning to the next page is essentially sending another request, and the points are recalculated based on the number of items returned on the next page.

Important: The service of this skill is dynamically calculated by multiples, which may consume a large number of points at one time. Users must be reminded and decide whether to continue.