{"id":"1ba3cff3-0239-4441-9028-213152b24705","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-etsy-category-search","name":"Etsy类目搜索","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-etsy-category-search","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-etsy-category-search","generatedAt":"2026-10-10T17:37:46.513Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T15:13:06.219Z","emptyReason":null},"description":"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.","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-etsy-category-search","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-etsy-category-search","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-etsy-category-search","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:13:06.219Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:13:06.219Z","emptyReason":null},"stars":null,"forks":null,"downloads":1366,"packageName":null,"latestVersion":"1.0.10","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:13:06.219Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T15:13:06.219Z","lastCrawledAt":"2026-10-10T15:13:06.219Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T15:13:06.219Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.10","createdAt":"2026-09-14T05:02:28.876Z","changelog":"Update from 1.0.9 to 1.0.10","fileCount":7,"zipByteSize":17895},{"version":"1.0.9","createdAt":"2026-08-14T14:50:56.132Z","changelog":"Update from 1.0.8 to 1.0.9","fileCount":7,"zipByteSize":17994},{"version":"1.0.8","createdAt":"2026-08-07T10:49:12.042Z","changelog":"Update from 1.0.7 to 1.0.8","fileCount":7,"zipByteSize":18049},{"version":"1.0.7","createdAt":"2026-07-13T12:08:29.292Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":5,"zipByteSize":9125},{"version":"1.0.6","createdAt":"2026-07-10T05:39:52.825Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":5,"zipByteSize":8584},{"version":"1.0.5","createdAt":"2026-07-09T05:44:21.587Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":5,"zipByteSize":8458},{"version":"1.0.4","createdAt":"2026-07-09T05:19:17.313Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":5,"zipByteSize":8896}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-etsy-category-search","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T17:37:46.513Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-etsy-category-search/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T15:13:06.219Z","emptyReason":null},"readme":"Skill: Etsy类目搜索\n\nOwner: linkfox-ai\n\nSummary: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n\nTags: latest:1.0.10\n\nVersion history:\n\nv1.0.10 | 2026-09-14T05:02:28.876Z | user\n\nUpdate from 1.0.9 to 1.0.10\n\nv1.0.9 | 2026-08-14T14:50:56.132Z | user\n\nUpdate from 1.0.8 to 1.0.9\n\nv1.0.8 | 2026-08-07T10:49:12.042Z | user\n\nUpdate from 1.0.7 to 1.0.8\n\nv1.0.7 | 2026-07-13T12:08:29.292Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-07-10T05:39:52.825Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-07-09T05:44:21.587Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-09T05:19:17.313Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nArchive index:\n\nArchive v1.0.10: 7 files, 17895 bytes\n\nFiles: references/api.md (1986b), references/onboarding.md (1999b), scripts/etsy_category_search.py (12751b), scripts/onboarding.py (24027b), skill-card.md (2246b), SKILL.md (1518b), _meta.json (148b)\n\nFile v1.0.10:SKILL.md\n\n---\nname: linkfox-etsy-category-search\ndescription: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和算力问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 算力消耗规则\n\n不消耗算力。\n\nFile v1.0.10:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1789362148876\n}\n\nFile v1.0.10:references/api.md\n\n# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。\n\nFile v1.0.10:references/onboarding.md\n\n# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.10:skill-card.md\n\n## Description:\n\nSearches synchronized Etsy category data by keyword and returns matching category names, ids, and parentIds for product or shop filtering.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to look up Etsy category identifiers from a synchronized LinkFox category dataset for product and shop filtering workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill uses LinkFox network services and handles API keys.\n\nMitigation: 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.\n\nRisk: The onboarding flow can guide phone-based login and payment order creation.\n\nMitigation: Run login or payment commands only when explicitly intended, and confirm the selected plan and payment method before creating an order.\n\nRisk: The category search script saves full API responses as local JSON files.\n\nMitigation: Review the saved output location and avoid running the script in workspaces where persisted response data should not be retained.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search)\n- [_ehunt_etsyCategorySearch API reference](references/api.md)\n- [Authentication and billing onboarding](references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Files, Shell commands, Configuration guidance]\n\n**Output Format:** [JSON responses, saved JSON result files, and concise Markdown guidance with command snippets]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Large API responses are summarized in stdout while full responses are saved to local session data files.]\n\n## Skill Version(s):\n\n1.0.10 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.0.9: 7 files, 17994 bytes\n\nFiles: references/api.md (1986b), references/onboarding.md (2046b), scripts/etsy_category_search.py (12695b), scripts/onboarding.py (24089b), skill-card.md (2413b), SKILL.md (1518b), _meta.json (147b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: linkfox-etsy-category-search\ndescription: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1786719056132\n}\n\nFile v1.0.9:references/api.md\n\n# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。\n\nFile v1.0.9:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.9:skill-card.md\n\n## Description:\n\nThis skill helps agents search synced Etsy category data by keyword to retrieve category names, IDs, and parentIds for product or shop filtering.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to find Etsy category IDs from a synced LinkFox category library before filtering product or shop searches. The skill can also guide users through LinkFox API-key setup, authentication recovery, or billing steps when access fails.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill contacts LinkFox services and uses a LinkFox API key.\n\nMitigation: Install only when LinkFox service access is acceptable, keep API keys private, and avoid endpoint override environment variables unless you control the target endpoint.\n\nRisk: Authentication recovery can involve phone-based login, SMS codes, generated API keys, and payment-order flows.\n\nMitigation: Review onboarding actions before running them, treat SMS codes and returned API keys as sensitive, and confirm any selected plan and payment method before order creation.\n\nRisk: Lookup, cache, and onboarding outputs may leave retained data in generated LinkFox session files.\n\nMitigation: Review generated LinkFox cache and session files for sensitive or unnecessary retained data before sharing or archiving the workspace.\n\n## Reference(s):\n\n- [API Reference](references/api.md)\n- [Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with JSON API responses and shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Lookup responses may be saved under LinkFox session data; large responses are summarized while full JSON is retained on disk.]\n\n## Skill Version(s):\n\n1.0.9 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.0.8: 7 files, 18049 bytes\n\nFiles: references/api.md (1986b), references/onboarding.md (2046b), scripts/etsy_category_search.py (12695b), scripts/onboarding.py (24089b), skill-card.md (2484b), SKILL.md (1518b), _meta.json (147b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: linkfox-etsy-category-search\ndescription: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1786099752042\n}\n\nFile v1.0.8:references/api.md\n\n# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。\n\nFile v1.0.8:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nSearches previously synchronized Etsy category data by keyword and returns category names, IDs, levels, and parent IDs for product or shop filtering.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal e-commerce operators, sellers, and agent workflows use this skill to find Etsy category IDs from LinkFox-synchronized category data for product and shop search filters. It also provides guidance for LinkFox authentication and billing recovery when lookup access fails.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill handles LinkFox API keys, phone numbers, SMS codes, account tokens, and payment-order data during onboarding.\n\nMitigation: Use it only in trusted workspaces, avoid sharing logs that contain secrets or account data, and rotate credentials if they are exposed.\n\nRisk: The release includes account login, API-key issuance, and billing/payment flows beyond Etsy category lookup.\n\nMitigation: Install only when LinkFox authentication and billing management are expected, and manually confirm any selected plan or payment action before proceeding.\n\nRisk: The helper script can write full lookup responses and cache files under local LinkFox output directories.\n\nMitigation: Run it in an appropriate workspace and remove local output or cache files when category results should not persist.\n\n## Reference(s):\n\n- [API Reference](references/api.md)\n- [Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search)\n\n## Skill Output:\n\n**Output Type(s):** [text, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [JSON lookup results and Markdown-style guidance with inline shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Lookup output includes category fields such as id, name, categoryLevel, parentId, and parentIds; large responses may be summarized while full JSON is saved locally by the helper script.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.0.7: 5 files, 9125 bytes\n\nFiles: references/api.md (1986b), scripts/etsy_category_search.py (12695b), skill-card.md (2484b), SKILL.md (2135b), _meta.json (147b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-etsy-category-search\ndescription: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。\n- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。\n\n## 积分消耗规则\n\n不消耗积分。\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1783944509292\n}\n\nFile v1.0.7:references/api.md\n\n# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。\n\nFile v1.0.7:skill-card.md\n\n## Description: <br>\nSearches locally synchronized Etsy category data by keyword to retrieve category names, ids, parent ids, and parentIds for product or shop filtering workflows. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to find Etsy category identifiers from synchronized LinkFox category data before passing those ids into Etsy product or shop search tools. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill uses a LinkFox API key and can send lookup requests to the LinkFox tool gateway. <br>\nMitigation: Install only when LinkFox is trusted, scope the API key to the needed use, and review or constrain the configured gateway before use. <br>\nRisk: The helper script writes full responses and cache data to local linkfox folders, which may expose lookup results in the workspace or fallback locations. <br>\nMitigation: Run it only in appropriate workspaces, inspect generated linkfox folders, and remove cached or response files that should not persist. <br>\nRisk: The authentication fallback can guide the agent to install a separate onboarding skill from a remote ZIP. <br>\nMitigation: Require explicit manual approval and review the remote onboarding package before installing any additional skill. <br>\n\n\n## Reference(s): <br>\n- [API Reference](references/api.md) <br>\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search) <br>\n- [LinkFox Tool Gateway](https://tool-gateway.linkfox.com) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, json, shell commands, guidance] <br>\n**Output Format:** [Markdown guidance with optional shell commands and JSON API responses or summaries] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [The helper script writes full lookup responses and cache files under local linkfox folders and prints either the full JSON response or a compact summary.] <br>\n\n## Skill Version(s): <br>\n1.0.7 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers 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. <br>\n\nArchive v1.0.6: 5 files, 8584 bytes\n\nFiles: references/api.md (1975b), scripts/etsy_category_search.py (12776b), skill-card.md (2639b), SKILL.md (1001b), _meta.json (147b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-etsy-category-search\ndescription: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1783661992825\n}\n\nFile v1.0.6:references/api.md\n\n# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。\n\nFile v1.0.6:skill-card.md\n\n## Description: <br>\nSearches LinkFox-synchronized Etsy category data by keyword and returns category names, IDs, parent IDs, and pagination metadata for product or shop filtering. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal sellers, marketplace operators, and developers use this skill to find Etsy category IDs and parent-category relationships for product search, shop filtering, or related automation that needs category parameters. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Search terms and LinkFox authorization headers are sent to a remote LinkFox gateway. <br>\nMitigation: Use the skill only when sending Etsy category queries and LinkFox credentials to LinkFox is acceptable; keep API keys private and avoid overriding the gateway URL unless the destination is trusted. <br>\nRisk: Full API responses may be written to local linkfox data and cache directories. <br>\nMitigation: Run the script only in workspaces where local response files are acceptable, and remove generated linkfox response or cache files after use when the data should not persist. <br>\nRisk: Results may be empty when Etsy category data has not been synchronized into the MCP library. <br>\nMitigation: Confirm category data has been synchronized with the documented Etsy category sync tool before relying on empty search results. <br>\n\n\n## Reference(s): <br>\n- [_ehunt_etsyCategorySearch API Reference](references/api.md) <br>\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search) <br>\n- [LinkFox Authorization Guide](https://skill.linkfox.com/linkfoxskills/guide.htm) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, JSON, Shell commands, Configuration guidance] <br>\n**Output Format:** [Markdown guidance with JSON API parameters and optional command-line examples; script output is JSON or a concise text summary.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Uses keyword, page, and pageSize inputs; pageSize is capped at 200 and full script responses may be saved under local linkfox directories.] <br>\n\n## Skill Version(s): <br>\n1.0.6 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers 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. <br>\n\nArchive v1.0.5: 5 files, 8458 bytes\n\nFiles: references/api.md (1975b), scripts/etsy_category_search.py (12776b), skill-card.md (2326b), SKILL.md (1001b), _meta.json (147b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-etsy-category-search\ndescription: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1783575861587\n}\n\nFile v1.0.5:references/api.md\n\n# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。\n\nFile v1.0.5:skill-card.md\n\n## Description: <br>\nSearches synced Etsy category data by keyword and returns category names, IDs, parent IDs, and pagination details for product or shop filtering. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal developers, sellers, and operators use this skill to look up Etsy category IDs and parent category paths for product or shop filtering after Etsy categories have been synced into the LinkFox category dataset. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Etsy category search terms, the LinkFox API key, and session metadata can be sent to LinkFox or to a configured gateway. <br>\nMitigation: Install only if that data flow is acceptable, keep the API key scoped and protected, and review or lock down the configured LinkFox gateway before use. <br>\nRisk: Full API responses can be persisted locally in LinkFox session and cache output. <br>\nMitigation: Avoid sensitive query terms when possible, clear local LinkFox cache or session output when retained responses are no longer needed, and apply local retention controls. <br>\n\n\n## Reference(s): <br>\n- [API reference](references/api.md) <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search) <br>\n- [LinkFox authorization guide](https://skill.linkfox.com/linkfoxskills/guide.htm) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, JSON, shell commands, files, guidance] <br>\n**Output Format:** [Markdown guidance with JSON API results and optional shell command examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires a keyword and supports page and pageSize pagination; the optional debug script can save full JSON responses under a local LinkFox session directory and cache responses for 24 hours.] <br>\n\n## Skill Version(s): <br>\n1.0.5 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers 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. <br>\n\nArchive v1.0.4: 5 files, 8896 bytes\n\nFiles: references/api.md (1975b), scripts/etsy_category_search.py (12825b), skill-card.md (2645b), SKILL.md (1644b), _meta.json (147b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-etsy-category-search\ndescription: 通过 `_ehunt_etsyCategorySearch`（MCP 展示名「Etsy品类查询」）在已同步到 MCP 库的 Etsy 类目数据中检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、_ehunt_etsyCategorySearch、Etsy品类查询、syncEtsyCategory / _ehunt_syncEtsyCategory（Etsy品类同步）后查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索（`_ehunt_etsyCategorySearch`）\n\n在具备 LinkFox「第三方数据服务」MCP 时，按工具名 **`_ehunt_etsyCategorySearch`** 调用（MCP 展示名：**Etsy品类查询**，以当前环境下发的工具元数据为准）。数据来自 **MCP 库本地检索**。\n\n## 前置条件\n\n库内须已有 **`_ehunt_syncEtsyCategory`** 写入的全量类目（MCP 展示名：**Etsy品类同步**）。若无数据或结果为空，应先完成同步再检索。\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 `_ehunt_productQuery` / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783574357313\n}\n\nFile v1.0.4:references/api.md\n\n# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nSearches LinkFox-synchronized Etsy category data by keyword to return category names, IDs, levels, and parent category IDs for product or shop filtering. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to find Etsy category identifiers from a LinkFox MCP category library that has already been synchronized. The returned IDs can be used as category inputs for product or shop queries. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The optional script sends category search requests, credentials, and session metadata to a remote LinkFox gateway. <br>\nMitigation: Use the script only with an approved LinkFox API key and a trusted gateway; leave gateway override variables unset unless the destination is explicitly trusted. <br>\nRisk: Full API responses can be cached or written to a linkfox output directory that may be outside the current project. <br>\nMitigation: Check the resolved output directory before use, manage cached response files according to local data-handling policy, and remove stored responses when they are no longer needed. <br>\nRisk: Category lookup depends on Etsy category data already being synchronized into the LinkFox MCP library. <br>\nMitigation: Run or confirm the Etsy category sync before relying on empty or incomplete search results. <br>\n\n\n## Reference(s): <br>\n- [_ehunt_etsyCategorySearch API reference](references/api.md) <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search) <br>\n- [LinkFox authorization guide](https://skill.linkfox.com/linkfoxskills/guide.htm) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [API Calls, JSON, Files, Shell commands, Configuration instructions, Guidance] <br>\n**Output Format:** [JSON responses, saved JSON files, and concise markdown or terminal guidance] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [The optional script accepts JSON parameters, writes full responses to a linkfox data directory, and summarizes larger responses unless inline output is requested.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers 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. <br>","readmeExcerpt":"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.","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-etsy-category-search\ndescription: Etsy 类目数据。可检索类目名称、id 与 parentIds，用于商品/店铺筛选的类目 id。当用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy品类查询、syncEtsyCategory、查询类目时触发。即使用户未提及工具名，只要在本地已同步的 Etsy 类目库里按关键词找类目 id，也应触发此技能。\n---\n\n# Etsy 类目检索\n\n## 要点\n\n- **必填**：`keyword`（子串匹配类目名称、类目 id、`parentIds`）。\n- **分页**：`page` 从 1 起；`pageSize` 默认 50、最大 200。\n- 返回的 **`id`** 可作为 Etsy商品搜索 / 店铺侧 `category` 等入参的类目标识（与具体工具 schema 一致即可）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/etsy_category_search.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [references/api.md](references/api.md) 末尾。\n\n## 参考\n\n入参/出参表见 [references/api.md](references/api.md)。\n\n## 解决认证和算力问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## 算力消耗规则\n\n不消耗算力。"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-etsy-category-search\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1789362148876\n}"},{"path":"references/api.md","content":"# `_ehunt_etsyCategorySearch` API 参考\n\n## 调用说明\n\n- **工具名**：`_ehunt_etsyCategorySearch`（LinkFox MCP，`serverName`：第三方数据服务）。\n- **MCP 展示名**：Etsy品类查询。\n- **数据范围**：查询已写入 MCP 库的 Etsy 品类；库内数据需先通过 **`_ehunt_syncEtsyCategory`**（MCP 展示名：Etsy品类同步）完成同步。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string, maxLen=200 | **是** | 关键词：匹配品类名称、类目 id、parentIds 字段（子串） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~200，默认 50 | 否 | 每页条数，最大 200 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| costToken | integer | 消耗 token（本地检索不计费） |\n| categories | array | 匹配的品类列表 |\n| title | string | 标题 |\n\n### `categories[]` 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| categoryLevel | integer | 类目层级 |\n| id | string | 类目 id |\n| name | string | 类目名称 |\n| parentId | string | 规范主父类目 id |\n| parentIds | string | 全部非空父类目 id（逗号分隔） |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/etsy_category_search.py`**（Python 3，仅标准库）。\n\n- **默认路径段**：`ehunt/etsy/etsyCategorySearch`（可用 `LINKFOX_EHUNT_ETSY_CATEGORY_SEARCH_PATH` 覆盖）\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖）；**鉴权**：`LINKFOXAGENT_API_KEY`（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/etsy_category_search.py '{\"keyword\": \"jewelry\", \"page\": 1, \"pageSize\": 50}'\n```\n\n类目数据须先由 **`_ehunt_syncEtsyCategory`** 同步到 MCP 库，否则结果可能为空。"},{"path":"references/onboarding.md","content":"# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。"},{"path":"skill-card.md","content":"## Description:\n\nSearches synchronized Etsy category data by keyword and returns matching category names, ids, and parentIds for product or shop filtering.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to look up Etsy category identifiers from a synchronized LinkFox category dataset for product and shop filtering workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill uses LinkFox network services and handles API keys.\n\nMitigation: 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.\n\nRisk: The onboarding flow can guide phone-based login and payment order creation.\n\nMitigation: Run login or payment commands only when explicitly intended, and confirm the selected plan and payment method before creating an order.\n\nRisk: The category search script saves full API responses as local JSON files.\n\nMitigation: Review the saved output location and avoid running the script in workspaces where persisted response data should not be retained.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-etsy-category-search)\n- [_ehunt_etsyCategorySearch API reference](references/api.md)\n- [Authentication and billing onboarding](references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Files, Shell commands, Configuration guidance]\n\n**Output Format:** [JSON responses, saved JSON result files, and concise Markdown guidance with command snippets]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Large API responses are summarized in stdout while full responses are saved to local session data files.]\n\n## Skill Version(s):\n\n1.0.10 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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.","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":969,"uniquenessScore":51,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T15:13:06.219Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T15:13:06.219Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:37:46.513Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}