linkfox-shopify-store-query

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Shopify 店铺查询

Shopify Store Query

要点

Key Points

分页：
```
page
```
从 1 起；
```
pageSize
```
默认 20、最大 100。
区间入参：
```
*Min
```
/
```
*Max
```
成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。
店铺年限
```
year
```
：1=最近 1 年、2=1~~2 年、3=2~~3 年、4=3 年以上。
排序：
```
sortBy
```
整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；
```
orderBy
```
为
```
desc
```
（默认）/
```
asc
```
。
国家：
```
country
```
传国家代码（如
```
US
```
、
```
CN
```
）。

Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 20, maximum 100.
Range Parameters:
```
*Min
```
/
```
*Max
```
appear in pairs (number of products, number of ads, monthly visits, monthly orders) to form upstream ranges.
Store Age
```
year
```
: 1 = within the last year, 2 = 1-2 years, 3 = 2-3 years, 4 = over 3 years.
Sorting:
```
sortBy
```
is an integer enumeration (0=number of products, 1=number of categories, 2=monthly visits, 3=FB followers, 4=Ins followers, 5=number of ads, 6=relevance, 7=monthly orders (default));
```
orderBy
```
is
```
desc
```
(default) /
```
asc
```
.
Country:
```
country
```
uses country codes (e.g.,
```
US
```
,
```
CN
```
).

脚本（可选）

Script (Optional)

命令行调试：

python scripts/shopify_store_query.py '<JSON>'

（需

LINKFOXAGENT_API_KEY

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

Command line debugging:

python scripts/shopify_store_query.py '<JSON>'

(requires

LINKFOXAGENT_API_KEY

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

解决认证和积分问题

Resolve Authentication and Points Issues

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

For the following exceptions, 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
```
or
```
LINKFOXAGENT_API_KEY
```
is not configured.
401 or 402 Status Code Response
Insufficient Points or Balance Prompt: Messages containing "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 input/output parameter table.

积分消耗规则

Points Consumption Rules

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

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

Billed by dynamic rules: Consumed points = number of returned stores × 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 calculated dynamically by multiples, which may consume a large number of points at once. Users must be reminded and decide whether to continue.