{"id":"9257663d-f19a-4c23-84b8-452b4f420ec5","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-shopify-product-query","name":"Shopify商品查询","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-shopify-product-query","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-shopify-product-query","generatedAt":"2026-10-10T17:36:45.202Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T14:45:35.402Z","emptyReason":null},"description":"按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。 Skill: Shopify商品查询 Owner: linkfox-ai Summary: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:09:40.522Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-0","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-shopify-product-query","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-shopify-product-query","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-shopify-product-query","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shop"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T14:45:35.402Z","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-10T14:45:35.402Z","emptyReason":null},"stars":null,"forks":null,"downloads":1378,"packageName":null,"latestVersion":"1.0.9","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T14:45:35.401Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T14:45:35.402Z","lastCrawledAt":"2026-10-10T14:45:35.401Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T14:45:35.401Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.9","createdAt":"2026-08-14T15:09:40.522Z","changelog":"Update from 1.0.8 to 1.0.9","fileCount":7,"zipByteSize":19996},{"version":"1.0.8","createdAt":"2026-08-07T11:09:57.387Z","changelog":"Update from 1.0.7 to 1.0.8","fileCount":7,"zipByteSize":20035},{"version":"1.0.7","createdAt":"2026-07-13T12:27:07.280Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":5,"zipByteSize":11173},{"version":"1.0.6","createdAt":"2026-07-10T05:40:21.096Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":5,"zipByteSize":10398},{"version":"1.0.5","createdAt":"2026-07-09T05:44:49.833Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":5,"zipByteSize":10251},{"version":"1.0.4","createdAt":"2026-07-09T05:19:47.805Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":5,"zipByteSize":10611}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-shopify-product-query","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-shopify-product-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/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:36:45.201Z"}},"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-shopify-product-query/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-product-query/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-10T14:45:35.402Z","emptyReason":null},"readme":"Skill: Shopify商品查询\n\nOwner: linkfox-ai\n\nSummary: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n\nTags: latest:1.0.9\n\nVersion history:\n\nv1.0.9 | 2026-08-14T15:09:40.522Z | user\n\nUpdate from 1.0.8 to 1.0.9\n\nv1.0.8 | 2026-08-07T11:09:57.387Z | user\n\nUpdate from 1.0.7 to 1.0.8\n\nv1.0.7 | 2026-07-13T12:27:07.280Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-07-10T05:40:21.096Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-07-09T05:44:49.833Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-09T05:19:47.805Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nArchive index:\n\nArchive v1.0.9: 7 files, 19996 bytes\n\nFiles: references/api.md (5491b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/shopify_product_query.py (12697b), skill-card.md (2422b), SKILL.md (2301b), _meta.json (148b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: linkfox-shopify-product-query\ndescription: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n---\n\n# Shopify 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Min` / `*Max` 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。\n- **排序**：`sortBy` 为整数枚举（默认 `14`=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 `references/api.md`）。\n- **布尔类筛选**：`facebookAd`（1=有广告）、`hasSupplier`（1=有货源，0=无）、`showDeleted`（1=含已下架）均为整数开关。\n- **发货国家**：`country` 传两位国家代码（如 `US`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_product_query.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [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入参/出参表见 [references/api.md](references/api.md)。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 返回的商品数 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-shopify-product-query\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1786720180522\n}\n\nFile v1.0.9:references/api.md\n\n# Shopify 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/productQuery`）。\n- **MCP 展示名**：Shopify 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或 Shopify 商品/店铺 URL |\n| priceMin | number，≥0 | 否 | 价格区间（起始，USD），与 priceMax 组成上游 `price` |\n| priceMax | number，≥0 | 否 | 价格区间（结束，USD） |\n| salesWeeklyMin | integer，≥0 | 否 | 周销量区间（起始） |\n| salesWeeklyMax | integer，≥0 | 否 | 周销量区间（结束） |\n| publishedTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始 |\n| publishedTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| facebookAd | integer | 否 | 是否有 Facebook 广告：1=有 |\n| competitionMin | integer，≥0 | 否 | 竞争度（在售店铺数量）区间起始 |\n| competitionMax | integer，≥0 | 否 | 竞争度（在售店铺数量）区间结束 |\n| hasSupplier | integer | 否 | 是否有货源：1=有，0=无 |\n| showDeleted | integer | 否 | 是否显示已下架商品：1=是，0=否 |\n| country | string | 否 | 发货国家（两位国家代码，如 US） |\n| sortBy | integer | 否 | 排序字段（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等取值，见下方枚举） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n### `sortBy` 取值\n\n上游排序枚举，默认 `14`（周销量降序）。常见取值含价格、上架时间、广告数、竞争度、周销量、周销售额、销售额增长率等的升/降序组合；具体编码以当前网关工具 schema 注释为准，未知时使用默认值即可。\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Shopify 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 商品查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| title | - | 商品标题 |\n| productLink | `product_link` | 商品链接 |\n| previewImageUrl | `preview_image_url` | 主图 URL |\n| country | - | 发货国家 |\n| minPrice | `min_price` | 最低价 |\n| maxPrice | `max_price` | 最高价 |\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeLink | `store_link` | 店铺链接 |\n| storeRank | `store_rank` | 店铺等级 |\n| competitorCount | `competitor_count` | 竞争度（在售店铺数量） |\n| facebookAdCount | `facebook_ad_count` | Facebook 广告数 |\n| weekOrderCount | `week_order_count` | 周销量（字符串） |\n| weekRevenueCount | `week_revenue_count` | 周销售额 |\n| weekRevenueGrowth | `week_revenue_growth` | 周销售额增长率（%） |\n| shelfTime | `shelf_time` | 上架时间 |\n| isDeleted | `is_deleted` | 是否下架：0=上架，1=下架 |\n| isFavourite | `is_favourite` | 是否已收藏 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/productQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\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\nShopify商品查询 helps agents search and filter Shopify products by keyword or URL, price, weekly sales, listing date, Facebook ads, competition, supplier availability, and shipping country.\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 ecommerce operators use this skill to research Shopify products for independent-store selection, dropshipping analysis, and competitive product comparison.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill handles LinkFox account login, API key generation, paid-plan ordering, and payment QR creation in addition to Shopify product lookup.\n\nMitigation: Require explicit user confirmation before login, API-key generation, package purchase, or payment QR creation.\n\nRisk: API keys, SMS codes, and LINKFOX_* environment variables can expose account or billing access if entered into retained logs or untrusted environments.\n\nMitigation: Use trusted environments, avoid untrusted LINKFOX_* variables, do not paste secrets into retained transcripts, and prefer secure credential storage.\n\nRisk: Product-query responses and cached results may be stored in local workspace files.\n\nMitigation: Run the skill in a trusted workspace and review or remove local linkfox output files when search results contain sensitive business research.\n\n## Reference(s):\n\n- [Shopify Product Query API Reference](references/api.md)\n- [Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance, files]\n\n**Output Format:** [Markdown guidance with JSON command outputs and local JSON result files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Product-query responses may be summarized for large result sets while the full JSON response is written locally.]\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, 20035 bytes\n\nFiles: references/api.md (5491b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/shopify_product_query.py (12697b), skill-card.md (2598b), SKILL.md (2301b), _meta.json (148b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: linkfox-shopify-product-query\ndescription: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n---\n\n# Shopify 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Min` / `*Max` 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。\n- **排序**：`sortBy` 为整数枚举（默认 `14`=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 `references/api.md`）。\n- **布尔类筛选**：`facebookAd`（1=有广告）、`hasSupplier`（1=有货源，0=无）、`showDeleted`（1=含已下架）均为整数开关。\n- **发货国家**：`country` 传两位国家代码（如 `US`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_product_query.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [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入参/出参表见 [references/api.md](references/api.md)。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 返回的商品数 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-shopify-product-query\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1786100997387\n}\n\nFile v1.0.8:references/api.md\n\n# Shopify 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/productQuery`）。\n- **MCP 展示名**：Shopify 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或 Shopify 商品/店铺 URL |\n| priceMin | number，≥0 | 否 | 价格区间（起始，USD），与 priceMax 组成上游 `price` |\n| priceMax | number，≥0 | 否 | 价格区间（结束，USD） |\n| salesWeeklyMin | integer，≥0 | 否 | 周销量区间（起始） |\n| salesWeeklyMax | integer，≥0 | 否 | 周销量区间（结束） |\n| publishedTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始 |\n| publishedTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| facebookAd | integer | 否 | 是否有 Facebook 广告：1=有 |\n| competitionMin | integer，≥0 | 否 | 竞争度（在售店铺数量）区间起始 |\n| competitionMax | integer，≥0 | 否 | 竞争度（在售店铺数量）区间结束 |\n| hasSupplier | integer | 否 | 是否有货源：1=有，0=无 |\n| showDeleted | integer | 否 | 是否显示已下架商品：1=是，0=否 |\n| country | string | 否 | 发货国家（两位国家代码，如 US） |\n| sortBy | integer | 否 | 排序字段（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等取值，见下方枚举） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n### `sortBy` 取值\n\n上游排序枚举，默认 `14`（周销量降序）。常见取值含价格、上架时间、广告数、竞争度、周销量、周销售额、销售额增长率等的升/降序组合；具体编码以当前网关工具 schema 注释为准，未知时使用默认值即可。\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Shopify 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 商品查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| title | - | 商品标题 |\n| productLink | `product_link` | 商品链接 |\n| previewImageUrl | `preview_image_url` | 主图 URL |\n| country | - | 发货国家 |\n| minPrice | `min_price` | 最低价 |\n| maxPrice | `max_price` | 最高价 |\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeLink | `store_link` | 店铺链接 |\n| storeRank | `store_rank` | 店铺等级 |\n| competitorCount | `competitor_count` | 竞争度（在售店铺数量） |\n| facebookAdCount | `facebook_ad_count` | Facebook 广告数 |\n| weekOrderCount | `week_order_count` | 周销量（字符串） |\n| weekRevenueCount | `week_revenue_count` | 周销售额 |\n| weekRevenueGrowth | `week_revenue_growth` | 周销售额增长率（%） |\n| shelfTime | `shelf_time` | 上架时间 |\n| isDeleted | `is_deleted` | 是否下架：0=上架，1=下架 |\n| isFavourite | `is_favourite` | 是否已收藏 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/productQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\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\nQueries Shopify products with filters for keywords or URLs, price, weekly sales, listing date, Facebook ads, competition, supplier availability, shipping country, pagination, and sorting.\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 agents use this skill to search and compare Shopify products for independent-store product research, including sales, revenue, advertising, competition, supplier, and shipping-country signals.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: LinkFox receives Shopify query parameters and related session metadata.\n\nMitigation: Use only non-sensitive product research inputs and install only when this third-party data sharing is acceptable.\n\nRisk: The skill can help manage LinkFox account setup, API keys, and paid credit purchases.\n\nMitigation: Use phone, SMS, API-key, plan, order, and payment helpers only when explicitly requested, and review outputs before following payment or credential steps.\n\nRisk: Full Shopify query responses and cache files may be stored locally.\n\nMitigation: Delete stored LinkFox response and cache files periodically when product query results are sensitive.\n\nRisk: Endpoint environment variables can redirect LinkFox API traffic.\n\nMitigation: Verify LinkFox endpoint environment variables before execution and avoid running with untrusted overrides.\n\n## Reference(s):\n\n- [Shopify Product Query API Reference](references/api.md)\n- [Authentication and Credit Onboarding](references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query)\n- [LinkFox Agent Portal](https://agent.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with JSON responses, tabular product data, and optional shell commands for debugging or onboarding.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The query helper writes full LinkFox responses to local JSON files and may print either full JSON or a summarized response depending on response size.]\n\n## Skill Version(s):\n\n1.0.8 (source: evidence.release.version)\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, 11173 bytes\n\nFiles: references/api.md (5491b), scripts/shopify_product_query.py (12697b), skill-card.md (2565b), SKILL.md (2918b), _meta.json (148b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-shopify-product-query\ndescription: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n---\n\n# Shopify 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Min` / `*Max` 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。\n- **排序**：`sortBy` 为整数枚举（默认 `14`=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 `references/api.md`）。\n- **布尔类筛选**：`facebookAd`（1=有广告）、`hasSupplier`（1=有货源，0=无）、`showDeleted`（1=含已下架）均为整数开关。\n- **发货国家**：`country` 传两位国家代码（如 `US`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_product_query.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [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入参/出参表见 [references/api.md](references/api.md)。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 返回的商品数 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-shopify-product-query\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1783945627280\n}\n\nFile v1.0.7:references/api.md\n\n# Shopify 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/productQuery`）。\n- **MCP 展示名**：Shopify 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或 Shopify 商品/店铺 URL |\n| priceMin | number，≥0 | 否 | 价格区间（起始，USD），与 priceMax 组成上游 `price` |\n| priceMax | number，≥0 | 否 | 价格区间（结束，USD） |\n| salesWeeklyMin | integer，≥0 | 否 | 周销量区间（起始） |\n| salesWeeklyMax | integer，≥0 | 否 | 周销量区间（结束） |\n| publishedTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始 |\n| publishedTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| facebookAd | integer | 否 | 是否有 Facebook 广告：1=有 |\n| competitionMin | integer，≥0 | 否 | 竞争度（在售店铺数量）区间起始 |\n| competitionMax | integer，≥0 | 否 | 竞争度（在售店铺数量）区间结束 |\n| hasSupplier | integer | 否 | 是否有货源：1=有，0=无 |\n| showDeleted | integer | 否 | 是否显示已下架商品：1=是，0=否 |\n| country | string | 否 | 发货国家（两位国家代码，如 US） |\n| sortBy | integer | 否 | 排序字段（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等取值，见下方枚举） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n### `sortBy` 取值\n\n上游排序枚举，默认 `14`（周销量降序）。常见取值含价格、上架时间、广告数、竞争度、周销量、周销售额、销售额增长率等的升/降序组合；具体编码以当前网关工具 schema 注释为准，未知时使用默认值即可。\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Shopify 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 商品查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| title | - | 商品标题 |\n| productLink | `product_link` | 商品链接 |\n| previewImageUrl | `preview_image_url` | 主图 URL |\n| country | - | 发货国家 |\n| minPrice | `min_price` | 最低价 |\n| maxPrice | `max_price` | 最高价 |\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeLink | `store_link` | 店铺链接 |\n| storeRank | `store_rank` | 店铺等级 |\n| competitorCount | `competitor_count` | 竞争度（在售店铺数量） |\n| facebookAdCount | `facebook_ad_count` | Facebook 广告数 |\n| weekOrderCount | `week_order_count` | 周销量（字符串） |\n| weekRevenueCount | `week_revenue_count` | 周销售额 |\n| weekRevenueGrowth | `week_revenue_growth` | 周销售额增长率（%） |\n| shelfTime | `shelf_time` | 上架时间 |\n| isDeleted | `is_deleted` | 是否下架：0=上架，1=下架 |\n| isFavourite | `is_favourite` | 是否已收藏 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/productQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.7:skill-card.md\n\n## Description: <br>\nHelps agents query and filter Shopify product opportunities by keyword or URL, price, weekly sales, listing date, Facebook ads, competition, supplier availability, and shipping country. <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 research Shopify products and stores, compare sales and advertising signals, and narrow ecommerce product selections through LinkFox API queries. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill may install a separate onboarding skill from an external ZIP while resolving authentication or credit issues. <br>\nMitigation: Require explicit user authorization and separate verification before downloading or installing external onboarding content. <br>\nRisk: Full API responses may be saved in local linkfox directories, including workspace, home, or temporary fallback locations. <br>\nMitigation: Warn users before execution, avoid sensitive product-research queries when unnecessary, and remove saved response files when they are no longer needed. <br>\nRisk: LinkFox credits are consumed dynamically based on returned product count, so broad queries or pagination can cost more than expected. <br>\nMitigation: Confirm credit consumption with the user before running and prefer narrow filters or smaller page sizes for exploratory searches. <br>\n\n\n## Reference(s): <br>\n- [Shopify Product Query API Reference](references/api.md) <br>\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Configuration, Files] <br>\n**Output Format:** [Markdown guidance with JSON request parameters, API response summaries, and optional saved JSON response files.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Small responses may be printed inline; larger responses are summarized while full responses are saved in local linkfox session directories.] <br>\n\n## Skill Version(s): <br>\n1.0.7 (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>\n\nArchive v1.0.6: 5 files, 10398 bytes\n\nFiles: references/api.md (5403b), scripts/shopify_product_query.py (12778b), skill-card.md (2407b), SKILL.md (1466b), _meta.json (148b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-shopify-product-query\ndescription: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n---\n\n# Shopify 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Min` / `*Max` 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。\n- **排序**：`sortBy` 为整数枚举（默认 `14`=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 `references/api.md`）。\n- **布尔类筛选**：`facebookAd`（1=有广告）、`hasSupplier`（1=有货源，0=无）、`showDeleted`（1=含已下架）均为整数开关。\n- **发货国家**：`country` 传两位国家代码（如 `US`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_product_query.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-shopify-product-query\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1783662021096\n}\n\nFile v1.0.6:references/api.md\n\n# Shopify 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/productQuery`）。\n- **MCP 展示名**：Shopify 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或 Shopify 商品/店铺 URL |\n| priceMin | number，≥0 | 否 | 价格区间（起始，USD），与 priceMax 组成上游 `price` |\n| priceMax | number，≥0 | 否 | 价格区间（结束，USD） |\n| salesWeeklyMin | integer，≥0 | 否 | 周销量区间（起始） |\n| salesWeeklyMax | integer，≥0 | 否 | 周销量区间（结束） |\n| publishedTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始 |\n| publishedTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| facebookAd | integer | 否 | 是否有 Facebook 广告：1=有 |\n| competitionMin | integer，≥0 | 否 | 竞争度（在售店铺数量）区间起始 |\n| competitionMax | integer，≥0 | 否 | 竞争度（在售店铺数量）区间结束 |\n| hasSupplier | integer | 否 | 是否有货源：1=有，0=无 |\n| showDeleted | integer | 否 | 是否显示已下架商品：1=是，0=否 |\n| country | string | 否 | 发货国家（两位国家代码，如 US） |\n| sortBy | integer | 否 | 排序字段（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等取值，见下方枚举） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n### `sortBy` 取值\n\n上游排序枚举，默认 `14`（周销量降序）。常见取值含价格、上架时间、广告数、竞争度、周销量、周销售额、销售额增长率等的升/降序组合；具体编码以当前网关工具 schema 注释为准，未知时使用默认值即可。\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Shopify 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 商品查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| title | - | 商品标题 |\n| productLink | `product_link` | 商品链接 |\n| previewImageUrl | `preview_image_url` | 主图 URL |\n| country | - | 发货国家 |\n| minPrice | `min_price` | 最低价 |\n| maxPrice | `max_price` | 最高价 |\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeLink | `store_link` | 店铺链接 |\n| storeRank | `store_rank` | 店铺等级 |\n| competitorCount | `competitor_count` | 竞争度（在售店铺数量） |\n| facebookAdCount | `facebook_ad_count` | Facebook 广告数 |\n| weekOrderCount | `week_order_count` | 周销量（字符串） |\n| weekRevenueCount | `week_revenue_count` | 周销售额 |\n| weekRevenueGrowth | `week_revenue_growth` | 周销售额增长率（%） |\n| shelfTime | `shelf_time` | 上架时间 |\n| isDeleted | `is_deleted` | 是否下架：0=上架，1=下架 |\n| isFavourite | `is_favourite` | 是否已收藏 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/productQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.6:skill-card.md\n\n## Description: <br>\n按关键词或 Shopify 商品/店铺 URL 及价格、周销量、上架时间、Facebook 广告、竞争度、货源状态和发货国家等筛选 Shopify 独立站商品。 <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, developers, and ecommerce operators use this skill to research Shopify products and filter candidate products by pricing, sales, advertising, competition, sourcing, availability, and shipping-country signals. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Queries, API credentials, and product-research results are sent to LinkFox's gateway. <br>\nMitigation: Use only approved LinkFox credentials and avoid sending confidential product research or sensitive store URLs unless that transfer is acceptable. <br>\nRisk: Full API responses are saved locally and cached by default. <br>\nMitigation: Review and clean the linkfox output and cache directories after use, especially on shared machines or projects containing sensitive research. <br>\nRisk: The optional feedback API could disclose confidential task details if used with sensitive content. <br>\nMitigation: Do not submit confidential queries, results, or business context through the feedback API. <br>\n\n\n## Reference(s): <br>\n- [Shopify 商品查询 API 参考](references/api.md) <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [API Calls, JSON, Files, Shell commands, Guidance] <br>\n**Output Format:** [JSON responses, Markdown guidance, and optional shell command output] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [The helper script saves full API responses locally under linkfox session data and caches responses by default; large responses are summarized unless inline output is requested.] <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, 10251 bytes\n\nFiles: references/api.md (5403b), scripts/shopify_product_query.py (12778b), skill-card.md (2243b), SKILL.md (1466b), _meta.json (148b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-shopify-product-query\ndescription: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n---\n\n# Shopify 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Min` / `*Max` 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。\n- **排序**：`sortBy` 为整数枚举（默认 `14`=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 `references/api.md`）。\n- **布尔类筛选**：`facebookAd`（1=有广告）、`hasSupplier`（1=有货源，0=无）、`showDeleted`（1=含已下架）均为整数开关。\n- **发货国家**：`country` 传两位国家代码（如 `US`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_product_query.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-shopify-product-query\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1783575889833\n}\n\nFile v1.0.5:references/api.md\n\n# Shopify 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/productQuery`）。\n- **MCP 展示名**：Shopify 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或 Shopify 商品/店铺 URL |\n| priceMin | number，≥0 | 否 | 价格区间（起始，USD），与 priceMax 组成上游 `price` |\n| priceMax | number，≥0 | 否 | 价格区间（结束，USD） |\n| salesWeeklyMin | integer，≥0 | 否 | 周销量区间（起始） |\n| salesWeeklyMax | integer，≥0 | 否 | 周销量区间（结束） |\n| publishedTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始 |\n| publishedTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| facebookAd | integer | 否 | 是否有 Facebook 广告：1=有 |\n| competitionMin | integer，≥0 | 否 | 竞争度（在售店铺数量）区间起始 |\n| competitionMax | integer，≥0 | 否 | 竞争度（在售店铺数量）区间结束 |\n| hasSupplier | integer | 否 | 是否有货源：1=有，0=无 |\n| showDeleted | integer | 否 | 是否显示已下架商品：1=是，0=否 |\n| country | string | 否 | 发货国家（两位国家代码，如 US） |\n| sortBy | integer | 否 | 排序字段（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等取值，见下方枚举） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n### `sortBy` 取值\n\n上游排序枚举，默认 `14`（周销量降序）。常见取值含价格、上架时间、广告数、竞争度、周销量、周销售额、销售额增长率等的升/降序组合；具体编码以当前网关工具 schema 注释为准，未知时使用默认值即可。\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Shopify 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 商品查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| title | - | 商品标题 |\n| productLink | `product_link` | 商品链接 |\n| previewImageUrl | `preview_image_url` | 主图 URL |\n| country | - | 发货国家 |\n| minPrice | `min_price` | 最低价 |\n| maxPrice | `max_price` | 最高价 |\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeLink | `store_link` | 店铺链接 |\n| storeRank | `store_rank` | 店铺等级 |\n| competitorCount | `competitor_count` | 竞争度（在售店铺数量） |\n| facebookAdCount | `facebook_ad_count` | Facebook 广告数 |\n| weekOrderCount | `week_order_count` | 周销量（字符串） |\n| weekRevenueCount | `week_revenue_count` | 周销售额 |\n| weekRevenueGrowth | `week_revenue_growth` | 周销售额增长率（%） |\n| shelfTime | `shelf_time` | 上架时间 |\n| isDeleted | `is_deleted` | 是否下架：0=上架，1=下架 |\n| isFavourite | `is_favourite` | 是否已收藏 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/productQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.5:skill-card.md\n\n## Description: <br>\nFilters Shopify products by keyword or URL, price, weekly sales, listing date, Facebook ads, competition, supplier availability, listing status, and shipping country. <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 query LinkFox's Shopify product data for product research, dropshipping selection, competitive checks, and ad-informed merchandising decisions. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: A custom gateway setting can send the LinkFox API key, query payload, and session metadata to a non-LinkFox endpoint if misconfigured. <br>\nMitigation: Keep the gateway pointed at the official LinkFox endpoint, avoid custom gateway environment variables unless the destination is controlled, and install only when LinkFox is trusted for Shopify product-query requests. <br>\nRisk: Feedback or query content may include personal data, customer data, private prompts, or sensitive business details. <br>\nMitigation: Avoid submitting sensitive information in feedback content or product-query requests. <br>\n\n\n## Reference(s): <br>\n- [Shopify 商品查询 API 参考](references/api.md) <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [API Calls, Files, JSON, Shell commands, Guidance] <br>\n**Output Format:** [JSON saved to a session data file, with stdout returning either full JSON or a compact text summary for large responses] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires a LinkFox API key; supports pagination, caching, and an inline mode for full stdout output.] <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, 10611 bytes\n\nFiles: references/api.md (5403b), scripts/shopify_product_query.py (12828b), skill-card.md (2462b), SKILL.md (1904b), _meta.json (148b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-shopify-product-query\ndescription: 通过 Shopify 商品查询（网关路由 `ehunt/shopify/productQuery`）按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n---\n\n# Shopify 商品查询（`ehunt/shopify/productQuery`）\n\n在具备 LinkFox「第三方数据服务」MCP 时，对应网关路由 **`ehunt/shopify/productQuery`** 调用（MCP 展示名：**Shopify 商品查询**，确切工具名以当前环境下发的工具元数据为准）。鉴权与上游路由由网关处理；若响应含根级 `code` 字段，是否成功以实网为准。\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Min` / `*Max` 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。\n- **排序**：`sortBy` 为整数枚举（默认 `14`=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 `references/api.md`）。\n- **布尔类筛选**：`facebookAd`（1=有广告）、`hasSupplier`（1=有货源，0=无）、`showDeleted`（1=含已下架）均为整数开关。\n- **发货国家**：`country` 传两位国家代码（如 `US`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_product_query.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-shopify-product-query\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783574387805\n}\n\nFile v1.0.4:references/api.md\n\n# Shopify 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/productQuery`）。\n- **MCP 展示名**：Shopify 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或 Shopify 商品/店铺 URL |\n| priceMin | number，≥0 | 否 | 价格区间（起始，USD），与 priceMax 组成上游 `price` |\n| priceMax | number，≥0 | 否 | 价格区间（结束，USD） |\n| salesWeeklyMin | integer，≥0 | 否 | 周销量区间（起始） |\n| salesWeeklyMax | integer，≥0 | 否 | 周销量区间（结束） |\n| publishedTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始 |\n| publishedTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| facebookAd | integer | 否 | 是否有 Facebook 广告：1=有 |\n| competitionMin | integer，≥0 | 否 | 竞争度（在售店铺数量）区间起始 |\n| competitionMax | integer，≥0 | 否 | 竞争度（在售店铺数量）区间结束 |\n| hasSupplier | integer | 否 | 是否有货源：1=有，0=无 |\n| showDeleted | integer | 否 | 是否显示已下架商品：1=是，0=否 |\n| country | string | 否 | 发货国家（两位国家代码，如 US） |\n| sortBy | integer | 否 | 排序字段（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等取值，见下方枚举） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n### `sortBy` 取值\n\n上游排序枚举，默认 `14`（周销量降序）。常见取值含价格、上架时间、广告数、竞争度、周销量、周销售额、销售额增长率等的升/降序组合；具体编码以当前网关工具 schema 注释为准，未知时使用默认值即可。\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Shopify 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 商品查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| title | - | 商品标题 |\n| productLink | `product_link` | 商品链接 |\n| previewImageUrl | `preview_image_url` | 主图 URL |\n| country | - | 发货国家 |\n| minPrice | `min_price` | 最低价 |\n| maxPrice | `max_price` | 最高价 |\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeLink | `store_link` | 店铺链接 |\n| storeRank | `store_rank` | 店铺等级 |\n| competitorCount | `competitor_count` | 竞争度（在售店铺数量） |\n| facebookAdCount | `facebook_ad_count` | Facebook 广告数 |\n| weekOrderCount | `week_order_count` | 周销量（字符串） |\n| weekRevenueCount | `week_revenue_count` | 周销售额 |\n| weekRevenueGrowth | `week_revenue_growth` | 周销售额增长率（%） |\n| shelfTime | `shelf_time` | 上架时间 |\n| isDeleted | `is_deleted` | 是否下架：0=上架，1=下架 |\n| isFavourite | `is_favourite` | 是否已收藏 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/productQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；申请见 https://skill.linkfox.com/linkfoxskills/guide.htm ）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH`。\n\n## Feedback API\n\n> 与上方工具网关 API 独立，勿混用 Base URL。\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: 使用本 skill YAML frontmatter 中的 `name`\n- `sentiment`: `POSITIVE` / `NEUTRAL` / `NEGATIVE`\n- `category`: `BUG` / `COMPLAINT` / `SUGGESTION` / `OTHER`\n- `content`: 简述用户意图、实际结果与问题或好评原因\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\n通过 LinkFox Shopify 商品查询网关按关键词、URL、价格、周销量、上架时间、Facebook 广告、竞争度、货源状态和发货国家筛选独立站 Shopify 商品。 <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>\nDevelopers and external commerce operators use this skill to query LinkFox Shopify product data for product research, filtering products by sales, price, advertising activity, competition, supplier availability, shipping country, and listing date. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Product queries and the LinkFox API key are sent to the LinkFox gateway. <br>\nMitigation: Use the skill only for intended LinkFox Shopify product research and avoid placing unnecessary sensitive data in query parameters. <br>\nRisk: The optional feedback endpoint is separate from the product-query gateway and may receive user-derived details if used. <br>\nMitigation: Submit feedback only when intentionally choosing to do so, and keep feedback content free of sensitive user or business details. <br>\nRisk: The optional Python script saves full API responses and cache files locally. <br>\nMitigation: Review saved files under the selected LinkFox output location and remove cached or response data that should not persist. <br>\n\n\n## Reference(s): <br>\n- [Shopify 商品查询 API 参考](references/api.md) <br>\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [guidance, API calls, JSON, files, shell commands, configuration] <br>\n**Output Format:** [Markdown guidance with JSON parameters, optional shell commands, and JSON API responses] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Optional Python script can save full LinkFox responses and cache files locally while printing either full JSON or a compact summary.] <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: Shopify商品查询 Owner: linkfox-ai Summary: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:09:40.522Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-0","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}"},{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_product_query.py '{\"searchKey\": \"phone case\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n  \"skillName\": \"linkfox-shopify-product-query\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-shopify-product-query\ndescription: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。\n---\n\n# Shopify 商品查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100（建议 ≤50）。\n- **区间入参**：`*Min` / `*Max` 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。\n- **排序**：`sortBy` 为整数枚举（默认 `14`=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 `references/api.md`）。\n- **布尔类筛选**：`facebookAd`（1=有广告）、`hasSupplier`（1=有货源，0=无）、`showDeleted`（1=含已下架）均为整数开关。\n- **发货国家**：`country` 传两位国家代码（如 `US`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_product_query.py '<JSON>'`（需 `LINKFOXAGENT_API_KEY`）。详见 [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入参/出参表见 [references/api.md](references/api.md)。\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 返回的商品数 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-shopify-product-query\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1786720180522\n}"},{"path":"references/api.md","content":"# Shopify 商品查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/productQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/productQuery`）。\n- **MCP 展示名**：Shopify 商品查询（确切工具名以当前环境下发的工具元数据为准）。\n- **鉴权**：请求头 `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）。\n- **说明**：参数与返回结构以当前网关返回为准；若上游返回 JSON 根级 `code` 字段，成功值（`200`）以实网为准。无数据时网关可能抛错。\n\n## 请求参数（JSON）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| searchKey | string, maxLen=500 | 否 | 关键词或 Shopify 商品/店铺 URL |\n| priceMin | number，≥0 | 否 | 价格区间（起始，USD），与 priceMax 组成上游 `price` |\n| priceMax | number，≥0 | 否 | 价格区间（结束，USD） |\n| salesWeeklyMin | integer，≥0 | 否 | 周销量区间（起始） |\n| salesWeeklyMax | integer，≥0 | 否 | 周销量区间（结束） |\n| publishedTimeBegin | string (YYYY-MM-DD) | 否 | 上架日期区间起始 |\n| publishedTimeEnd | string (YYYY-MM-DD) | 否 | 上架日期区间结束 |\n| facebookAd | integer | 否 | 是否有 Facebook 广告：1=有 |\n| competitionMin | integer，≥0 | 否 | 竞争度（在售店铺数量）区间起始 |\n| competitionMax | integer，≥0 | 否 | 竞争度（在售店铺数量）区间结束 |\n| hasSupplier | integer | 否 | 是否有货源：1=有，0=无 |\n| showDeleted | integer | 否 | 是否显示已下架商品：1=是，0=否 |\n| country | string | 否 | 发货国家（两位国家代码，如 US） |\n| sortBy | integer | 否 | 排序字段（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等取值，见下方枚举） |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100，建议不超过 50 |\n\n### `sortBy` 取值\n\n上游排序枚举，默认 `14`（周销量降序）。常见取值含价格、上架时间、广告数、竞争度、周销量、周销售额、销售额增长率等的升/降序组合；具体编码以当前网关工具 schema 注释为准，未知时使用默认值即可。\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| productNum | integer | 符合条件的商品总数（上游 `product_num`） |\n| products | array | Shopify 商品列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 商品查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `products[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| productId | `product_id` | 商品 ID |\n| title | - | 商品标题 |\n| productLink | `product_link` | 商品链接 |\n| previewImageUrl | `preview_image_url` | 主图 URL |\n| country | - | 发货国家 |\n| minPrice | `min_price` | 最低价 |\n| maxPrice | `max_price` | 最高价 |\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeLink | `store_link` | 店铺链接 |\n| storeRank | `store_rank` | 店铺等级 |\n| competitorCount | `competitor_count` | 竞争度（在售店铺数量） |\n| facebookAdCount | `facebook_ad_count` | Facebook 广告数 |\n| weekOrderCount | `week_order_count` | 周销量（字符串） |\n| weekRevenueCount | `week_revenue_count` | 周销售额 |\n| weekRevenueGrowth | `week_revenue_growth` | 周销售额增长率（%） |\n| shelfTime | `shelf_time` | 上架时间 |\n| isDeleted | `is_deleted` | 是否下架：0=上架，1=下架 |\n| isFavourite | `is_favourite` | 是否已收藏 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_product_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/productQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_PRODUCT_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_"},{"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>`（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`。"},{"path":"skill-card.md","content":"## Description:\n\nShopify商品查询 helps agents search and filter Shopify products by keyword or URL, price, weekly sales, listing date, Facebook ads, competition, supplier availability, and shipping country.\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 ecommerce operators use this skill to research Shopify products for independent-store selection, dropshipping analysis, and competitive product comparison.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill handles LinkFox account login, API key generation, paid-plan ordering, and payment QR creation in addition to Shopify product lookup.\n\nMitigation: Require explicit user confirmation before login, API-key generation, package purchase, or payment QR creation.\n\nRisk: API keys, SMS codes, and LINKFOX_* environment variables can expose account or billing access if entered into retained logs or untrusted environments.\n\nMitigation: Use trusted environments, avoid untrusted LINKFOX_* variables, do not paste secrets into retained transcripts, and prefer secure credential storage.\n\nRisk: Product-query responses and cached results may be stored in local workspace files.\n\nMitigation: Run the skill in a trusted workspace and review or remove local linkfox output files when search results contain sensitive business research.\n\n## Reference(s):\n\n- [Shopify Product Query API Reference](references/api.md)\n- [Authentication and Billing Onboarding](references/onboarding.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-product-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance, files]\n\n**Output Format:** [Markdown guidance with JSON command outputs and local JSON result files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Product-query responses may be summarized for large result sets while the full JSON response is written locally.]\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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。 Skill: Shopify商品查询 Owner: linkfox-ai Summary: 按多维度筛选独立站 Shopify 商品（关键词/URL、价格、周销量、上架时间、Facebook 广告、竞争度、是否有货源、发货国家等）。当用户提到 Shopify 商品、Shopify 选品、独立站选品、Shopify 爆款、Shopify dropshipping、独立站铺货、Facebook 广告商品、Shopify product query、shopify items 时触发。即使用户未提及工具名，只要在 Shopify 独立站上搜商品、看周销量/销售额/竞争度或筛品，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:09:40.522Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-0","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1097,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T14:45:35.402Z","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-10T14:45:35.402Z","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:36:45.202Z","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"}]}}}