linkfox-etsy-product-query

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Etsy 商品查询（

_ehunt_productQuery

）

Etsy Product Query (

_ehunt_productQuery

)

要点

Key Points

分页：
```
page
```
从 1 起；
```
pageSize
```
默认 20、最大 100（建议 ≤50）。
区间入参：与店铺接口相同思路，
```
begin*
```
/
```
end*
```
成对。
排序：
```
sortBy
```
为 1~6（上游
```
sort_by
```
）。
```
sortDesc
```
：1=降序，2=升序（与
```
_ehunt_storeQuery
```
的 1/0 不同）。
商品类型
```
productType
```
：
```
1
```
手工、
```
2
```
复古、
```
3
```
数字、
```
4
```
定制、
```
9
```
其他，多选用逗号。
货币：
```
currencyCode
```
默认
```
USD
```
。
类目 id：
```
category
```
为单品类 ID；可先通过类目检索类技能拿到 id。

Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 20, maximum 100 (recommended ≤50).
Range Parameters: Same logic as the store API,
```
begin*
```
/
```
end*
```
are paired.
Sorting:
```
sortBy
```
is 1~6 (upstream
```
sort_by
```
).
```
sortDesc
```
: 1=Descending, 2=Ascending (different from 1/0 in
```
_ehunt_storeQuery
```
).
Product Type
```
productType
```
:
```
1
```
Handmade,
```
2
```
Vintage,
```
3
```
Digital,
```
4
```
Custom,
```
9
```
Others; use commas for multiple selections.
Currency:
```
currencyCode
```
defaults to
```
USD
```
.
Category ID:
```
category
```
is a single category ID; you can obtain the ID through category retrieval skills first.

脚本（可选）

Script (Optional)

命令行调试：

python scripts/etsy_product_query.py '<JSON>'

（需

LINKFOXAGENT_API_KEY

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

Command-line debugging:

python scripts/etsy_product_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 the input/output parameter table.

解决认证和积分问题

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 with 401 or 402 Status Code
Response Indicates Insufficient Points or Balance: The message contains content like "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: Points consumed = Number of returned products × 1.8. Billing is based on the number of items returned on the current page; turning to the next page is essentially sending another request, and 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 it is up to the user to decide whether to continue.

linkfox-etsy-product-query

Original

Translation

Etsy 商品查询（
`_ehunt_productQuery`
）

Etsy Product Query (
`_ehunt_productQuery`
)

要点

Key Points

脚本（可选）

Script (Optional)

参考

References

解决认证和积分问题

Resolve Authentication and Points Issues

异常情况

Exception Scenarios

积分消耗规则

Points Consumption Rules

linkfox-etsy-product-query

Original

Translation

Etsy 商品查询（_ehunt_productQuery）

Etsy Product Query (_ehunt_productQuery)

要点

Key Points

脚本（可选）

Script (Optional)

参考

References

解决认证和积分问题

Resolve Authentication and Points Issues

异常情况

Exception Scenarios

积分消耗规则

Points Consumption Rules

Etsy 商品查询（
`_ehunt_productQuery`
）

Etsy Product Query (
`_ehunt_productQuery`
)