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 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。 Skill: Etsy类目搜索 Owner: linkfox-ai Summary: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。 Tags: latest:1.0.10 Version history: v1.0.10 | 2026-09-14T05:02:28.876Z | user Update from 1.0.9 to 1.0.10 v1.0.9 | 2026-08-14T14:50:56.132Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-07T10:49:12.

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-category-search

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-category-search/snapshot"

Documentation

CLAWHUB

41,635 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-etsy-category-search
description: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。
---

# Etsy 类目检索

## 要点

- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。
- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。
- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。

## 脚本（可选）

命令行调试：`python scripts/etsy_category_search.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/套餐到期/需充值/请充值"，或类似含义的内容。

## 算力消耗规则

不消耗算力。

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-etsy-category-search",
  "version": "1.0.10",
  "publishedAt": 1789362148876
}

references/api.md

# `_ehunt_etsyCategorySearch` API 参考

## 调用说明

- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。
- **MCP 展示名**：Etsy品类查询。
- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。

## 请求参数（JSON）

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |
| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |
| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |

## 响应主要字段

| 字段 | 类型 | 说明 |
|------|------|------|
| total | integer | 本页返回条数 |
| costToken | integer | 消耗 token（本地检索不计费） |
| categories | array | 匹配的品类列表 |
| title | string | 标题 |

### `categories[]` 元素

| 字段 | 类型 | 说明 |
|------|------|------|
| categoryLevel | integer | 类目层级 |
| id | string | 类目 id |
| name | string | 类目名称 |
| parentId | string | 规范主父类目 id |
| parentIds | string | 全部非空父类目 id（逗号分隔） |

## 脚本调试（可选）

仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。

- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）
- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）

```bash
export LINKFOXAGENT_API_KEY="<your-key>"
python scripts/etsy_category_search.py '{"keyword": "jewelry", "page": 1, "pageSize": 50}'
```

类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。

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:

Searches synchronized Etsy category data by keyword and returns matching category names, ids, and parentIds for product or shop filtering.

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 users and developers use this skill to look up Etsy category identifiers from a synchronized LinkFox category dataset for product and shop filtering workflows.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill uses LinkFox network services and handles API keys.

Mitigation: Install only if comfortable using LinkFox services; obtain keys through the official LinkFox UI or a secret manager and avoid pasting keys into shared transcripts or shell profiles.

Risk: The onboarding flow can guide phone-based login and payment order creation.

Mitigation: Run login or payment commands only when explicitly intended, and confirm the selected plan and payment method before creating an order.

Risk: The category search script saves full API responses as local JSON files.

Mitigation: Review the saved output location and avoid running the script in workspaces where persisted response data should not be retained.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search)
- [_ehunt_etsyCategorySearch API reference](references/api.md)
- [Authentication and billing onboarding](references/onboarding.md)

## Skill Output:

**Output Type(s):** [JSON, Files, Shell commands, Configuration guidance]

**Output Format:** [JSON responses, saved JSON result files, and concise Markdown guidance with command snippets]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Large API responses are summarized in stdout while full responses are saved to local session data files.]

## 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.