linkfox-etsy-store-query

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Etsy 店铺查询

Etsy Store Inquiry

要点

Key Points

分页：
```
page
```
从 1 起；
```
pageSize
```
默认 20、最大 100。
区间入参：
```
begin*
```
/
```
end*
```
成对对应上游逗号范围；只填一侧时上游为「起始~」或「~结束」。
排序：
```
sortBy
```
仅 8~11（8 总销量、9 周销量、10 评论数、11 收藏数）。
```
sortDesc
```
：1=降序，0=升序（勿与商品接口的
```
sortDesc
```
混用）。

Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 20, maximum 100.
Range Parameters:
```
begin*
```
/
```
end*
```
correspond to upstream comma-separated ranges in pairs; if only one side is filled, the upstream will be "start~" or "~end".
Sorting:
```
sortBy
```
only supports values 8~11 (8 = total sales, 9 = weekly sales, 10 = number of reviews, 11 = number of favorites).
```
sortDesc
```
: 1=descending order, 0=ascending order (do not confuse with
```
sortDesc
```
in the product API).

脚本（可选）

Script (Optional)

命令行调试：

python scripts/etsy_store_query.py '<JSON>'

（需

LINKFOXAGENT_API_KEY

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

Command line debugging:

python scripts/etsy_store_query.py '<JSON>'

(requires

LINKFOXAGENT_API_KEY

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

参考

References

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

See references/api.md for input/output parameter tables.

解决认证和积分问题

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: Neither
```
LINKFOX_AGENT_API_KEY
```
nor
```
LINKFOXAGENT_API_KEY
```
is configured in environment variables.
Response returns 401 or 402 status code
Response indicates insufficient points or balance: The message contains content such as "insufficient points balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge", or similar meanings.

积分消耗规则

Points Consumption Rules

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

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

Billing follows dynamic rules: Consumed points = number of returned stores × 1.8. Billing is based on the number of results returned on the current page; turning to the next page is essentially sending another request, and points are recalculated based on the number of results 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 it is up to the user to decide whether to continue.