What makes Etsy商品查询 notable?

1.4K downloads. Trust evidence available

How should Etsy商品查询 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Etsy商品查询

按多维度筛选 Etsy 商品（关键词/URL、价格、销量、收藏、评论、上架时间、类目、手工/复古等类型、Pick/Bestsell/Raving 等标签）。当用户提到 Etsy 商品、Etsy listing、Etsy 选品、Etsy 爆款、Etsy handmade、Etsy vintage、etsy items、Etsy商品查询时触发。即使用户未提及工具名，只要在 Etsy 上搜商品、看销量/价格/标签或筛品，也应触发此技能。 Skill: Etsy商品查询 Owner: linkfox-ai Summary: 按多维度筛选 Etsy 商品（关键词/URL、价格、销量、收藏、评论、上架时间、类目、手工/复古等类型、Pick/Bestsell/Raving 等标签）。当用户提到 Etsy 商品、Etsy listing、Etsy 选品、Etsy 爆款、Etsy handmade、Etsy vintage、etsy items、Etsy商品查询时触发。即使用户未提及工具名，只要在 Etsy 上搜商品、看销量/价格/标签或筛品，也应触发此技能。 Tags: latest:1.0.10 Version history: v1.0.10 | 2026-09-14T05:02:41.186Z | user Update from 1.0.9 to 1.0.10 v1.0.9 | 2026-08-14T14:51:09.965Z | user Update from

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.4k

Updated

Oct 10, 2026

Version

1.0.10

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.4K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.10release · observed Sep 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-etsy-product-query

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-product-query/snapshot"

Documentation

CLAWHUB

57,510 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-etsy-product-query
description: 按多维度筛选 Etsy 商品（关键词/URL、价格、销量、收藏、评论、上架时间、类目、手工/复古等类型、Pick/Bestsell/Raving 等标签）。当用户提到 Etsy 商品、Etsy listing、Etsy 选品、Etsy 爆款、Etsy handmade、Etsy vintage、etsy items、Etsy商品查询时触发。即使用户未提及工具名，只要在 Etsy 上搜商品、看销量/价格/标签或筛品，也应触发此技能。
---

# Etsy 商品查询（`_ehunt_productQuery`）

## 要点

- **分页**：`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。

## 脚本（可选）

命令行调试：`python scripts/etsy_product_query.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。

## 参考

入参/出参表见 [references/api.md](references/api.md)。

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

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

## 算力消耗规则

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

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

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-etsy-product-query",
  "version": "1.0.10",
  "publishedAt": 1789362161186
}

references/api.md

# `_ehunt_productQuery` API 参考

## 调用说明

- **工具名**：`_ehunt_productQuery`（LinkFox MCP，`serverName`：第三方数据服务）。
- **MCP 展示名**：Etsy商品查询。
- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值以实网为准。

## 请求参数（JSON）

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| beginFavorites | integer，≥0 | 否 | 收藏数（起始），与结束值共同组成上游 favorites |
| beginFavoritesWeekly | integer，≥0 | 否 | 周新增收藏数（起始），与结束值共同组成上游 favorites_weekly |
| beginPrice | number，≥0 | 否 | 价格（起始），与结束价共同组成上游 price（如 20~100）；仅填一侧时上游为 起始~ 或 ~结束 |
| beginReviews | integer，≥0 | 否 | 评论数（起始），与结束值共同组成上游 reviews |
| beginReviewsWeekly | integer，≥0 | 否 | 周新增评论数（起始），与结束值共同组成上游 reviews_weekly |
| beginSales | integer，≥0 | 否 | 总销量（起始），与结束值共同组成上游 sales |
| beginSalesWeekly | integer，≥0 | 否 | 周销量（起始），与结束值共同组成上游 sales_weekly（如 1~100） |
| category | string, maxLen=1000 | 否 | 商品分类 ID（单品类），详见 商品分类接口 |
| country | string, maxLen=1000 | 否 | 发货国家 |
| currencyCode | string, default=USD, maxLen=1000 | 否 | 货币代码 |
| endFavorites | integer，≥0 | 否 | 收藏数（结束） |
| endFavoritesWeekly | integer，≥0 | 否 | 周新增收藏数（结束） |
| endPrice | number，≥0 | 否 | 价格（结束），与起始价共同组成上游 price |
| endReviews | integer，≥0 | 否 | 评论数（结束） |
| endReviewsWeekly | integer，≥0 | 否 | 周新增评论数（结束） |
| endSales | integer，≥0 | 否 | 总销量（结束） |
| endSalesWeekly | integer，≥0 | 否 | 周销量（结束） |
| isBestsell | integer | 否 | 是否畅销商品 |
| isPick | integer | 否 | 是否 Pick 商品 |
| isRaving | integer | 否 | 是否 Raving 商品 |
| listedTime | string, pattern | 否 | 上架时间不早于该日期（YYYY-MM-DD） |
| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |
| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |
| productType | string，须符合 schema 正则 | 否 | 商品类型，多个逗号分隔：1=手工 2=复古 3=数字 4=定制 9=其他 |
| searchKey | string, maxLen=500 | 否 | 搜索关键词或 Etsy 商品 URL |
| sortBy | integer (1~6) | 否 | 排序字段（对应上游 sort_by，取值 1~6） |
| sortDesc | integer | 否 | 排序方向（对应上游 `desc`）。schema 示例：降序 `1`、升序 `2`（与店铺查询的 `sortDesc` 编码不同） |
| status | integer | 否 | 商品状态（示例：1 上架，0 下架） |

## 响应主要字段

| 字段 | 类型 | 说明 |
|------|------|------|
| total | integer | 记录数（本页返回条数，便于与列表长度对齐） |
| sourceTool | string | 工具类型：ehunt |
| sourceType | string | 来源类型：etsy |
| columns | array | 渲染的列 |
| costToken | integer | 消耗 token（按本页返回条数估算） |
| productNum | integer | 符合条件的商品总数（上游 product_num） |
| title | string | 标题 |
| type | string | 渲染的样式 |
| products | array | Etsy 商品列表 |

### `products[]` 元素

| 字段 | 类型 | 说明 |
|------|------|------|
| category | string | 类目名称 |
| favorites | integer | 收藏数 |
| favoritesWeekly | integer | 周新增收藏数 |
| imageUrl | string | 主图 URL |
| isBestsell | integer | 是否畅销：1=是 |
| isPick | integer | 是否 Pick：1=是 |
| isRaving | integer | 是否 Raving：1=是 |
| price | number | 价格 |
| productUrl | string | 商品链接 |
| releaseTime | string | 上架/发布时间 |
| reviews | integer | 评论数 |
| reviewsWeekly | integer | 周新增评论数 |
| salesTotal | integer | 总销量 |
| salesWeekly | integer | 周销量 |
| shipsFrom | string | 发货国家 |
| status | integer | 商品状态：1=上架，0=下架 |
| storeName | string | 店铺名称 |
| tags | string | 标签 |
| title | string | 商品标题 |

## 脚本调试（可选）

仓库内提供 **`scripts/etsy_product_que

references/onboarding.md

# 解决认证和算力问题

调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。

**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。
1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册
2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册
3. 手机号路径：
   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements
   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`
   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：
     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY "<key>"`
     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.zshrc && source ~/.zshrc`
     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.bashrc && source ~/.bashrc`
     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可

**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。
- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选
- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）
- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）
- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询

排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。

skill-card.md

## Description:

Etsy商品查询 helps agents filter Etsy listings by keyword or URL, price, sales, favorites, reviews, listing date, category, product type, and marketplace tags.

This skill is ready for commercial/non-commercial use.

## Publisher:

[linkfox-ai](https://clawhub.ai/user/linkfox-ai)

### License/Terms of Use:

MIT-0

## Use Case:

External sellers, ecommerce analysts, and agents use this skill to search and compare Etsy products by commercial signals such as sales, price, favorites, reviews, category, listing age, and product tags.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill handles LinkFox account onboarding, API keys, and paid billing flows.

Mitigation: Install and use it only when LinkFox is trusted, avoid exposing API keys in shared files or logs, and require explicit user confirmation before onboarding or payment commands.

Risk: Endpoint override environment variables can direct requests away from the default LinkFox services.

Mitigation: Use endpoint overrides only when the destination is controlled and expected.

Risk: Etsy product queries consume paid credits dynamically and larger result pages can increase cost.

Mitigation: Confirm page size and expected cost with the user before running large queries or pagination.

## Reference(s):

- [_ehunt_productQuery API reference](artifact/references/api.md)
- [Authentication and billing onboarding](artifact/references/onboarding.md)
- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-product-query)

## Skill Output:

**Output Type(s):** [text, markdown, JSON, files, shell commands, configuration, guidance]

**Output Format:** [Markdown guidance with inline shell commands, JSON API parameters, stdout summaries, and saved JSON response files.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Query results may be summarized when responses are large; full responses are saved as JSON files by the query script.]

## Skill Version(s):

1.0.10 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 21h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.