{"id":"befed91e-5538-4f88-80c1-1d4ea15098ca","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-shopify-store-query","name":"Shopify店铺查询","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-shopify-store-query","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-shopify-store-query","generatedAt":"2026-10-10T17:35:30.019Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T14:19:41.210Z","emptyReason":null},"description":"按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。 Skill: Shopify店铺查询 Owner: linkfox-ai Summary: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:09:48.020Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-07T11:10:05.038Z | use","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-store-query","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-shopify-store-query","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-store-query","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-shopify-store-query","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-store-query","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopif"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T14:19:41.210Z","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:19:41.210Z","emptyReason":null},"stars":null,"forks":null,"downloads":1390,"packageName":null,"latestVersion":"1.0.9","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T14:19:41.210Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T14:19:41.210Z","lastCrawledAt":"2026-10-10T14:19:41.210Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T14:19:41.210Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.9","createdAt":"2026-08-14T15:09:48.020Z","changelog":"Update from 1.0.8 to 1.0.9","fileCount":7,"zipByteSize":19811},{"version":"1.0.8","createdAt":"2026-08-07T11:10:05.038Z","changelog":"Update from 1.0.7 to 1.0.8","fileCount":7,"zipByteSize":19916},{"version":"1.0.7","createdAt":"2026-07-13T12:27:16.182Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":5,"zipByteSize":11043},{"version":"1.0.6","createdAt":"2026-07-10T05:40:30.304Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":5,"zipByteSize":9933},{"version":"1.0.5","createdAt":"2026-07-09T05:44:59.034Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":5,"zipByteSize":10077},{"version":"1.0.4","createdAt":"2026-07-09T05:19:58.322Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":5,"zipByteSize":10199}]},"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-store-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-store-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-query/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-query/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-query/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-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:35:30.018Z"}},"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-store-query/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-shopify-store-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:19:41.210Z","emptyReason":null},"readme":"Skill: Shopify店铺查询\n\nOwner: linkfox-ai\n\nSummary: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n\nTags: latest:1.0.9\n\nVersion history:\n\nv1.0.9 | 2026-08-14T15:09:48.020Z | user\n\nUpdate from 1.0.8 to 1.0.9\n\nv1.0.8 | 2026-08-07T11:10:05.038Z | user\n\nUpdate from 1.0.7 to 1.0.8\n\nv1.0.7 | 2026-07-13T12:27:16.182Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-07-10T05:40:30.304Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-07-09T05:44:59.034Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-09T05:19:58.322Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nArchive index:\n\nArchive v1.0.9: 7 files, 19811 bytes\n\nFiles: references/api.md (5192b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/shopify_store_query.py (12683b), skill-card.md (2604b), SKILL.md (2236b), _meta.json (146b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: linkfox-shopify-store-query\ndescription: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n---\n\n# Shopify 店铺查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100。\n- **区间入参**：`*Min` / `*Max` 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。\n- **店铺年限** `year`：1=最近 1 年、2=1~2 年、3=2~3 年、4=3 年以上。\n- **排序**：`sortBy` 整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；`orderBy` 为 `desc`（默认）/`asc`。\n- **国家**：`country` 传国家代码（如 `US`、`CN`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_store_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-store-query\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1786720188020\n}\n\nFile v1.0.9:references/api.md\n\n# Shopify 店铺查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/storeQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/storeQuery`）。\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 | 否 | 店铺名称或域名关键词 |\n| country | string | 否 | 国家代码（如 US、CN） |\n| year | integer | 否 | 店铺创建年份：1=最近 1 年，2=1~2 年，3=2~3 年，4=3 年以上 |\n| productNumMin | integer，≥0 | 否 | 产品数区间（起始） |\n| productNumMax | integer，≥0 | 否 | 产品数区间（结束） |\n| advertiseCountMin | integer，≥0 | 否 | 广告数区间（起始） |\n| advertiseCountMax | integer，≥0 | 否 | 广告数区间（结束） |\n| monthlyVisitMin | integer，≥0 | 否 | 月访问量区间（起始） |\n| monthlyVisitMax | integer，≥0 | 否 | 月访问量区间（结束） |\n| monthOrderMin | integer，≥0 | 否 | 月订单量区间（起始） |\n| monthOrderMax | integer，≥0 | 否 | 月订单量区间（结束） |\n| sortBy | integer | 否 | 排序字段：0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数（默认） |\n| orderBy | string | 否 | 排序方向：`desc`（默认）/`asc` |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| storeNum | integer | 符合条件的店铺总数（上游 `store_num`） |\n| stores | array | Shopify 店铺列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 店铺查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `stores[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeName | `store_name` | 店铺名称 |\n| storeDomain | `store_domain` | 店铺域名 |\n| storeLink | `store_link` | 店铺链接 |\n| country | - | 国家 |\n| createdTime | `created_time` | 创建时间 |\n| productNum | `product_num` | 产品数 |\n| categoryNum | `category_num` | 类目数 |\n| categories | - | 类目列表（元素含 `id`、`name`） |\n| monthlyVisit | `monthly_visit` | 月访问量（格式化） |\n| monthOrderNum | `month_order_num` | 月订单量（格式化） |\n| fbFollowers | `fb_followers` | Facebook 粉丝数 |\n| insFollowers | `ins_followers` | Instagram 粉丝数 |\n| advertiseCount | `advertise_count` | 广告数 |\n| adLink | `ad_link` | 广告库链接 |\n| email | - | 联系邮箱 |\n| facebookUrl | `facebook_url` | Facebook 主页 |\n| instagramUrl | `instagram_url` | Instagram 主页 |\n| socialLinks | `social_links` | 社媒链接（Map） |\n| globalRank | `global_rank` | 全球排名 |\n| logo | - | 店铺 Logo URL |\n| availableStatus | `available_status` | 是否活跃：1=活跃 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_store_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/storeQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_STORE_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_STORE_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-store-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\nSearch and filter independent Shopify stores by name or domain, country, store age, product count, ad count, monthly visits, monthly orders, and social follower metrics.\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\nE-commerce analysts, marketers, and sellers use this skill to discover Shopify stores and compare independent-store metrics for prospecting, competitor research, and market analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill includes LinkFox account, login, billing, and payment-order flows in addition to Shopify store querying.\n\nMitigation: Review those flows before installation and use them only when the user intends to create or recover an account, configure access, or buy credits.\n\nRisk: Custom gateway or login URL environment variables could redirect requests away from trusted LinkFox services.\n\nMitigation: Use the default LinkFox endpoints unless a trusted administrator provides an approved override.\n\nRisk: API keys, SMS codes, and phone numbers may be exposed if pasted into chat logs or shell startup files without care.\n\nMitigation: Store API keys in a proper secret manager or protected environment configuration, and share SMS codes or phone numbers only when intentionally completing LinkFox onboarding.\n\nRisk: Queries consume credits dynamically based on returned store count, so broad filters or pagination can increase cost.\n\nMitigation: Warn users before running broad searches, use narrower filters and page sizes when possible, and ask for confirmation before follow-up pages.\n\n## Reference(s):\n\n- [Shopify Store 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-store-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with JSON API results and optional shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Large API responses may be saved as JSON files and summarized in text.]\n\n## Skill Version(s):\n\n1.0.9 (source: 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, 19916 bytes\n\nFiles: references/api.md (5192b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/shopify_store_query.py (12683b), skill-card.md (2659b), SKILL.md (2236b), _meta.json (146b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: linkfox-shopify-store-query\ndescription: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n---\n\n# Shopify 店铺查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100。\n- **区间入参**：`*Min` / `*Max` 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。\n- **店铺年限** `year`：1=最近 1 年、2=1~2 年、3=2~3 年、4=3 年以上。\n- **排序**：`sortBy` 整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；`orderBy` 为 `desc`（默认）/`asc`。\n- **国家**：`country` 传国家代码（如 `US`、`CN`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_store_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-store-query\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1786101005038\n}\n\nFile v1.0.8:references/api.md\n\n# Shopify 店铺查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/storeQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/storeQuery`）。\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 | 否 | 店铺名称或域名关键词 |\n| country | string | 否 | 国家代码（如 US、CN） |\n| year | integer | 否 | 店铺创建年份：1=最近 1 年，2=1~2 年，3=2~3 年，4=3 年以上 |\n| productNumMin | integer，≥0 | 否 | 产品数区间（起始） |\n| productNumMax | integer，≥0 | 否 | 产品数区间（结束） |\n| advertiseCountMin | integer，≥0 | 否 | 广告数区间（起始） |\n| advertiseCountMax | integer，≥0 | 否 | 广告数区间（结束） |\n| monthlyVisitMin | integer，≥0 | 否 | 月访问量区间（起始） |\n| monthlyVisitMax | integer，≥0 | 否 | 月访问量区间（结束） |\n| monthOrderMin | integer，≥0 | 否 | 月订单量区间（起始） |\n| monthOrderMax | integer，≥0 | 否 | 月订单量区间（结束） |\n| sortBy | integer | 否 | 排序字段：0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数（默认） |\n| orderBy | string | 否 | 排序方向：`desc`（默认）/`asc` |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| storeNum | integer | 符合条件的店铺总数（上游 `store_num`） |\n| stores | array | Shopify 店铺列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 店铺查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `stores[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeName | `store_name` | 店铺名称 |\n| storeDomain | `store_domain` | 店铺域名 |\n| storeLink | `store_link` | 店铺链接 |\n| country | - | 国家 |\n| createdTime | `created_time` | 创建时间 |\n| productNum | `product_num` | 产品数 |\n| categoryNum | `category_num` | 类目数 |\n| categories | - | 类目列表（元素含 `id`、`name`） |\n| monthlyVisit | `monthly_visit` | 月访问量（格式化） |\n| monthOrderNum | `month_order_num` | 月订单量（格式化） |\n| fbFollowers | `fb_followers` | Facebook 粉丝数 |\n| insFollowers | `ins_followers` | Instagram 粉丝数 |\n| advertiseCount | `advertise_count` | 广告数 |\n| adLink | `ad_link` | 广告库链接 |\n| email | - | 联系邮箱 |\n| facebookUrl | `facebook_url` | Facebook 主页 |\n| instagramUrl | `instagram_url` | Instagram 主页 |\n| socialLinks | `social_links` | 社媒链接（Map） |\n| globalRank | `global_rank` | 全球排名 |\n| logo | - | 店铺 Logo URL |\n| availableStatus | `available_status` | 是否活跃：1=活跃 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_store_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/storeQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_STORE_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_STORE_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-store-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 and filters independent Shopify stores by dimensions such as name or domain, country, store age, product count, ad count, monthly visits, monthly orders, and social followers.\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 discover Shopify stores and compare storefront signals for prospecting, competitive research, or market analysis. It also provides guidance for LinkFox credential setup and billing remediation when access or balance issues block a query.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a LinkFox API key and can persist query results in local LinkFox session or cache files.\n\nMitigation: Install only when the user is comfortable granting that access, and periodically delete local LinkFox cache or session files when query results are sensitive.\n\nRisk: Troubleshooting can involve SMS login, API key generation, and paid plan ordering.\n\nMitigation: Prefer the self-service LinkFox account page for credentials, do not share OTPs unless the user intends to authenticate, and review any plan purchase before confirming it.\n\nRisk: Queries consume credits dynamically based on the number of stores returned, so broad searches or additional pages can create higher-than-expected cost.\n\nMitigation: Warn the user before large or repeated queries, keep page size scoped to the task, and ask for confirmation before continuing when a query may consume many credits.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-store-query)\n- [Shopify 店铺查询 API 参考](references/api.md)\n- [解决认证和积分问题](references/onboarding.md)\n- [LinkFox account page](https://agent.linkfox.com/)\n\n## Skill Output:\n\n**Output Type(s):** [Text, JSON, Files, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with JSON query responses, summaries, and file paths to saved result data]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Full Shopify query responses are saved to LinkFox session data files; larger responses are summarized unless inline output is requested.]\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, 11043 bytes\n\nFiles: references/api.md (5192b), scripts/shopify_store_query.py (12683b), skill-card.md (2937b), SKILL.md (2853b), _meta.json (146b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-shopify-store-query\ndescription: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n---\n\n# Shopify 店铺查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100。\n- **区间入参**：`*Min` / `*Max` 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。\n- **店铺年限** `year`：1=最近 1 年、2=1~2 年、3=2~3 年、4=3 年以上。\n- **排序**：`sortBy` 整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；`orderBy` 为 `desc`（默认）/`asc`。\n- **国家**：`country` 传国家代码（如 `US`、`CN`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_store_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-store-query\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1783945636182\n}\n\nFile v1.0.7:references/api.md\n\n# Shopify 店铺查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/storeQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/storeQuery`）。\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 | 否 | 店铺名称或域名关键词 |\n| country | string | 否 | 国家代码（如 US、CN） |\n| year | integer | 否 | 店铺创建年份：1=最近 1 年，2=1~2 年，3=2~3 年，4=3 年以上 |\n| productNumMin | integer，≥0 | 否 | 产品数区间（起始） |\n| productNumMax | integer，≥0 | 否 | 产品数区间（结束） |\n| advertiseCountMin | integer，≥0 | 否 | 广告数区间（起始） |\n| advertiseCountMax | integer，≥0 | 否 | 广告数区间（结束） |\n| monthlyVisitMin | integer，≥0 | 否 | 月访问量区间（起始） |\n| monthlyVisitMax | integer，≥0 | 否 | 月访问量区间（结束） |\n| monthOrderMin | integer，≥0 | 否 | 月订单量区间（起始） |\n| monthOrderMax | integer，≥0 | 否 | 月订单量区间（结束） |\n| sortBy | integer | 否 | 排序字段：0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数（默认） |\n| orderBy | string | 否 | 排序方向：`desc`（默认）/`asc` |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| storeNum | integer | 符合条件的店铺总数（上游 `store_num`） |\n| stores | array | Shopify 店铺列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 店铺查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `stores[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeName | `store_name` | 店铺名称 |\n| storeDomain | `store_domain` | 店铺域名 |\n| storeLink | `store_link` | 店铺链接 |\n| country | - | 国家 |\n| createdTime | `created_time` | 创建时间 |\n| productNum | `product_num` | 产品数 |\n| categoryNum | `category_num` | 类目数 |\n| categories | - | 类目列表（元素含 `id`、`name`） |\n| monthlyVisit | `monthly_visit` | 月访问量（格式化） |\n| monthOrderNum | `month_order_num` | 月订单量（格式化） |\n| fbFollowers | `fb_followers` | Facebook 粉丝数 |\n| insFollowers | `ins_followers` | Instagram 粉丝数 |\n| advertiseCount | `advertise_count` | 广告数 |\n| adLink | `ad_link` | 广告库链接 |\n| email | - | 联系邮箱 |\n| facebookUrl | `facebook_url` | Facebook 主页 |\n| instagramUrl | `instagram_url` | Instagram 主页 |\n| socialLinks | `social_links` | 社媒链接（Map） |\n| globalRank | `global_rank` | 全球排名 |\n| logo | - | 店铺 Logo URL |\n| availableStatus | `available_status` | 是否活跃：1=活跃 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_store_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/storeQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_STORE_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nexport LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_STORE_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-store-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 independent store records through LinkFox by keyword or domain, country, store age, product count, ad count, traffic, orders, and social followers. <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 discover Shopify sellers, competitor stores, and store performance signals for market research or ecommerce analysis. It is useful when an agent needs structured Shopify store results and documented filter, sort, and pagination parameters. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can consume paid LinkFox credits because billing is based on returned Shopify store count and each page is a new request. <br>\nMitigation: Confirm the intended query scope, page size, and pagination plan with the user before running searches that may return many stores. <br>\nRisk: The skill sends Shopify query parameters and the LinkFox API key to the LinkFox gateway. <br>\nMitigation: Use only approved LinkFox credentials and avoid sending sensitive or unnecessary query terms. <br>\nRisk: The script saves full API responses locally, which may include store contact details or other business data. <br>\nMitigation: Store results only in an appropriate workspace and remove local response files when they are no longer needed. <br>\nRisk: The skill directs agents to fetch and install a secondary onboarding skill from an external URL during some authentication or credit failures. <br>\nMitigation: Install the secondary skill only after verifying the source and obtaining user approval for the download. <br>\n\n\n## Reference(s): <br>\n- [Shopify Store Query API Reference](references/api.md) <br>\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-store-query) <br>\n- [LinkFox API Key Guide](https://skill.linkfox.com/linkfoxskills/guide.htm) <br>\n- [LinkFox Account and Credits Portal](https://os.linkfox.com/) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [JSON, Files, Shell commands, Guidance] <br>\n**Output Format:** [Markdown guidance with shell command examples, JSON API responses, and saved JSON files] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires a LinkFox API key; paginated results may consume paid credits; full responses are saved locally and large responses may be summarized in stdout.] <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, 9933 bytes\n\nFiles: references/api.md (5104b), scripts/shopify_store_query.py (12764b), skill-card.md (2122b), SKILL.md (1401b), _meta.json (146b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-shopify-store-query\ndescription: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n---\n\n# Shopify 店铺查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100。\n- **区间入参**：`*Min` / `*Max` 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。\n- **店铺年限** `year`：1=最近 1 年、2=1~2 年、3=2~3 年、4=3 年以上。\n- **排序**：`sortBy` 整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；`orderBy` 为 `desc`（默认）/`asc`。\n- **国家**：`country` 传国家代码（如 `US`、`CN`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_store_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-store-query\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1783662030304\n}\n\nFile v1.0.6:references/api.md\n\n# Shopify 店铺查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/storeQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/storeQuery`）。\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 | 否 | 店铺名称或域名关键词 |\n| country | string | 否 | 国家代码（如 US、CN） |\n| year | integer | 否 | 店铺创建年份：1=最近 1 年，2=1~2 年，3=2~3 年，4=3 年以上 |\n| productNumMin | integer，≥0 | 否 | 产品数区间（起始） |\n| productNumMax | integer，≥0 | 否 | 产品数区间（结束） |\n| advertiseCountMin | integer，≥0 | 否 | 广告数区间（起始） |\n| advertiseCountMax | integer，≥0 | 否 | 广告数区间（结束） |\n| monthlyVisitMin | integer，≥0 | 否 | 月访问量区间（起始） |\n| monthlyVisitMax | integer，≥0 | 否 | 月访问量区间（结束） |\n| monthOrderMin | integer，≥0 | 否 | 月订单量区间（起始） |\n| monthOrderMax | integer，≥0 | 否 | 月订单量区间（结束） |\n| sortBy | integer | 否 | 排序字段：0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数（默认） |\n| orderBy | string | 否 | 排序方向：`desc`（默认）/`asc` |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| storeNum | integer | 符合条件的店铺总数（上游 `store_num`） |\n| stores | array | Shopify 店铺列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 店铺查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `stores[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeName | `store_name` | 店铺名称 |\n| storeDomain | `store_domain` | 店铺域名 |\n| storeLink | `store_link` | 店铺链接 |\n| country | - | 国家 |\n| createdTime | `created_time` | 创建时间 |\n| productNum | `product_num` | 产品数 |\n| categoryNum | `category_num` | 类目数 |\n| categories | - | 类目列表（元素含 `id`、`name`） |\n| monthlyVisit | `monthly_visit` | 月访问量（格式化） |\n| monthOrderNum | `month_order_num` | 月订单量（格式化） |\n| fbFollowers | `fb_followers` | Facebook 粉丝数 |\n| insFollowers | `ins_followers` | Instagram 粉丝数 |\n| advertiseCount | `advertise_count` | 广告数 |\n| adLink | `ad_link` | 广告库链接 |\n| email | - | 联系邮箱 |\n| facebookUrl | `facebook_url` | Facebook 主页 |\n| instagramUrl | `instagram_url` | Instagram 主页 |\n| socialLinks | `social_links` | 社媒链接（Map） |\n| globalRank | `global_rank` | 全球排名 |\n| logo | - | 店铺 Logo URL |\n| availableStatus | `available_status` | 是否活跃：1=活跃 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_store_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/storeQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_STORE_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_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_STORE_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-store-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>\nFilters Shopify stores by store name or domain, country, store age, product count, advertising count, monthly visits, monthly orders, and social follower signals. <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, analysts, and commerce operators use this skill to query and compare Shopify stores for market research, competitor discovery, and store-performance screening. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Shopify search parameters are sent to LinkFox services. <br>\nMitigation: Use approved API keys and avoid submitting sensitive research terms unless LinkFox processing is acceptable for the workspace. <br>\nRisk: Full query results are saved locally and may be cached. <br>\nMitigation: Run the skill in a controlled workspace, verify the output directory, disable cache when appropriate, and delete saved linkfox result files after use. <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-store-query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON files] <br>\n**Output Format:** [Markdown guidance with optional shell commands; the helper script returns JSON or a text summary and saves full JSON responses locally.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [The helper script requires a LinkFox API key, can use a 24-hour local cache, and writes full query results under a local linkfox data directory.] <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, 10077 bytes\n\nFiles: references/api.md (5104b), scripts/shopify_store_query.py (12764b), skill-card.md (2213b), SKILL.md (1401b), _meta.json (146b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-shopify-store-query\ndescription: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n---\n\n# Shopify 店铺查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100。\n- **区间入参**：`*Min` / `*Max` 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。\n- **店铺年限** `year`：1=最近 1 年、2=1~2 年、3=2~3 年、4=3 年以上。\n- **排序**：`sortBy` 整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；`orderBy` 为 `desc`（默认）/`asc`。\n- **国家**：`country` 传国家代码（如 `US`、`CN`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_store_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-store-query\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1783575899034\n}\n\nFile v1.0.5:references/api.md\n\n# Shopify 店铺查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/storeQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/storeQuery`）。\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 | 否 | 店铺名称或域名关键词 |\n| country | string | 否 | 国家代码（如 US、CN） |\n| year | integer | 否 | 店铺创建年份：1=最近 1 年，2=1~2 年，3=2~3 年，4=3 年以上 |\n| productNumMin | integer，≥0 | 否 | 产品数区间（起始） |\n| productNumMax | integer，≥0 | 否 | 产品数区间（结束） |\n| advertiseCountMin | integer，≥0 | 否 | 广告数区间（起始） |\n| advertiseCountMax | integer，≥0 | 否 | 广告数区间（结束） |\n| monthlyVisitMin | integer，≥0 | 否 | 月访问量区间（起始） |\n| monthlyVisitMax | integer，≥0 | 否 | 月访问量区间（结束） |\n| monthOrderMin | integer，≥0 | 否 | 月订单量区间（起始） |\n| monthOrderMax | integer，≥0 | 否 | 月订单量区间（结束） |\n| sortBy | integer | 否 | 排序字段：0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数（默认） |\n| orderBy | string | 否 | 排序方向：`desc`（默认）/`asc` |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| storeNum | integer | 符合条件的店铺总数（上游 `store_num`） |\n| stores | array | Shopify 店铺列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 店铺查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `stores[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeName | `store_name` | 店铺名称 |\n| storeDomain | `store_domain` | 店铺域名 |\n| storeLink | `store_link` | 店铺链接 |\n| country | - | 国家 |\n| createdTime | `created_time` | 创建时间 |\n| productNum | `product_num` | 产品数 |\n| categoryNum | `category_num` | 类目数 |\n| categories | - | 类目列表（元素含 `id`、`name`） |\n| monthlyVisit | `monthly_visit` | 月访问量（格式化） |\n| monthOrderNum | `month_order_num` | 月订单量（格式化） |\n| fbFollowers | `fb_followers` | Facebook 粉丝数 |\n| insFollowers | `ins_followers` | Instagram 粉丝数 |\n| advertiseCount | `advertise_count` | 广告数 |\n| adLink | `ad_link` | 广告库链接 |\n| email | - | 联系邮箱 |\n| facebookUrl | `facebook_url` | Facebook 主页 |\n| instagramUrl | `instagram_url` | Instagram 主页 |\n| socialLinks | `social_links` | 社媒链接（Map） |\n| globalRank | `global_rank` | 全球排名 |\n| logo | - | 店铺 Logo URL |\n| availableStatus | `available_status` | 是否活跃：1=活跃 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_store_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/storeQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_STORE_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_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_STORE_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-store-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>\n按多维度筛选独立站 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, ecommerce operators, and analysts use this skill to find and compare Shopify stores by traffic, order, product, advertising, country, age, and social audience filters. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill uses LinkFox's external API with a LinkFox API key, so search parameters and request metadata may leave the user's environment. <br>\nMitigation: Install only if that external API use is acceptable, keep LinkFox credentials controlled through environment variables, and avoid sending sensitive prompts or private business data as search parameters. <br>\nRisk: The scanner summary says saved results and credential-handling behavior may be broader or less clearly disclosed than users expect. <br>\nMitigation: Review and delete local linkfox output or cache directories after use when results may contain private business information. <br>\n\n\n## Reference(s): <br>\n- [Shopify 店铺查询 API 参考](references/api.md) <br>\n- [LinkFox API key guide](https://skill.linkfox.com/linkfoxskills/guide.htm) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, JSON, shell commands, guidance] <br>\n**Output Format:** [JSON responses, saved data files, and concise text summaries] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Full API responses may be saved under a local linkfox session directory; query results may be cached 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, 10199 bytes\n\nFiles: references/api.md (5104b), scripts/shopify_store_query.py (12812b), skill-card.md (2232b), SKILL.md (1833b), _meta.json (146b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-shopify-store-query\ndescription: 通过 Shopify 店铺查询（网关路由 `ehunt/shopify/storeQuery`）按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n---\n\n# Shopify 店铺查询（`ehunt/shopify/storeQuery`）\n\n在具备 LinkFox「第三方数据服务」MCP 时，对应网关路由 **`ehunt/shopify/storeQuery`** 调用（MCP 展示名：**Shopify 店铺查询**，确切工具名以当前环境下发的工具元数据为准）。鉴权与上游路由由网关处理；若响应含根级 `code` 字段，是否成功以实网为准。\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100。\n- **区间入参**：`*Min` / `*Max` 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。\n- **店铺年限** `year`：1=最近 1 年、2=1~2 年、3=2~3 年、4=3 年以上。\n- **排序**：`sortBy` 整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；`orderBy` 为 `desc`（默认）/`asc`。\n- **国家**：`country` 传国家代码（如 `US`、`CN`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_store_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-store-query\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783574398322\n}\n\nFile v1.0.4:references/api.md\n\n# Shopify 店铺查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/storeQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/storeQuery`）。\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 | 否 | 店铺名称或域名关键词 |\n| country | string | 否 | 国家代码（如 US、CN） |\n| year | integer | 否 | 店铺创建年份：1=最近 1 年，2=1~2 年，3=2~3 年，4=3 年以上 |\n| productNumMin | integer，≥0 | 否 | 产品数区间（起始） |\n| productNumMax | integer，≥0 | 否 | 产品数区间（结束） |\n| advertiseCountMin | integer，≥0 | 否 | 广告数区间（起始） |\n| advertiseCountMax | integer，≥0 | 否 | 广告数区间（结束） |\n| monthlyVisitMin | integer，≥0 | 否 | 月访问量区间（起始） |\n| monthlyVisitMax | integer，≥0 | 否 | 月访问量区间（结束） |\n| monthOrderMin | integer，≥0 | 否 | 月订单量区间（起始） |\n| monthOrderMax | integer，≥0 | 否 | 月订单量区间（结束） |\n| sortBy | integer | 否 | 排序字段：0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数（默认） |\n| orderBy | string | 否 | 排序方向：`desc`（默认）/`asc` |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| storeNum | integer | 符合条件的店铺总数（上游 `store_num`） |\n| stores | array | Shopify 店铺列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 店铺查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `stores[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeName | `store_name` | 店铺名称 |\n| storeDomain | `store_domain` | 店铺域名 |\n| storeLink | `store_link` | 店铺链接 |\n| country | - | 国家 |\n| createdTime | `created_time` | 创建时间 |\n| productNum | `product_num` | 产品数 |\n| categoryNum | `category_num` | 类目数 |\n| categories | - | 类目列表（元素含 `id`、`name`） |\n| monthlyVisit | `monthly_visit` | 月访问量（格式化） |\n| monthOrderNum | `month_order_num` | 月订单量（格式化） |\n| fbFollowers | `fb_followers` | Facebook 粉丝数 |\n| insFollowers | `ins_followers` | Instagram 粉丝数 |\n| advertiseCount | `advertise_count` | 广告数 |\n| adLink | `ad_link` | 广告库链接 |\n| email | - | 联系邮箱 |\n| facebookUrl | `facebook_url` | Facebook 主页 |\n| instagramUrl | `instagram_url` | Instagram 主页 |\n| socialLinks | `social_links` | 社媒链接（Map） |\n| globalRank | `global_rank` | 全球排名 |\n| logo | - | 店铺 Logo URL |\n| availableStatus | `available_status` | 是否活跃：1=活跃 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_store_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/storeQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_STORE_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_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'\n```\n\n若返回 404，说明部署上该工具的 HTTP 路径与默认不一致，请用 `listEnabledTool` 或运维确认实际 path 后设置 `LINKFOX_EHUNT_SHOPIFY_STORE_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-store-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>\nHelps agents query and filter Shopify stores through LinkFox by keyword, country, store age, product count, advertising count, traffic, order volume, and social followers. <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, filter, and analyze Shopify stores and competitor storefronts using LinkFox store-query data. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Shopify store search queries and filters are sent to LinkFox. <br>\nMitigation: Use the skill only when the user is comfortable sharing those query terms with LinkFox. <br>\nRisk: Returned store records may include sensitive business data such as emails, social profiles, traffic, order volume, and analytics. <br>\nMitigation: Treat returned records as sensitive data and avoid sharing or retaining them beyond the user's task. <br>\nRisk: The optional script may save full responses and cache files locally. <br>\nMitigation: Clean up local LinkFox output and cache files when retained results are no longer needed. <br>\n\n\n## Reference(s): <br>\n- [Shopify 店铺查询 API 参考](artifact/references/api.md) <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-shopify-store-query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration] <br>\n**Output Format:** [Markdown guidance with JSON API parameters, tabular result descriptions, and optional shell commands.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Optional script can save full LinkFox query responses as local JSON files and print either the full response or a summary.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (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>","readmeExcerpt":"Skill: Shopify店铺查询 Owner: linkfox-ai Summary: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:09:48.020Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-07T11:10:05.038Z | use","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export LINKFOXAGENT_API_KEY=\"<your-key>\"\npython scripts/shopify_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n  \"skillName\": \"linkfox-shopify-store-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_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n  \"skillName\": \"linkfox-shopify-store-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_store_query.py '{\"searchKey\": \"fashion\", \"country\": \"US\", \"page\": 1, \"pageSize\": 20}'"},{"language":"json","snippet":"{\n  \"skillName\": \"linkfox-shopify-store-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-store-query\ndescription: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。\n---\n\n# Shopify 店铺查询\n\n## 要点\n\n- **分页**：`page` 从 1 起；`pageSize` 默认 20、最大 100。\n- **区间入参**：`*Min` / `*Max` 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。\n- **店铺年限** `year`：1=最近 1 年、2=1~2 年、3=2~3 年、4=3 年以上。\n- **排序**：`sortBy` 整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；`orderBy` 为 `desc`（默认）/`asc`。\n- **国家**：`country` 传国家代码（如 `US`、`CN`）。\n\n## 脚本（可选）\n\n命令行调试：`python scripts/shopify_store_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-store-query\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1786720188020\n}"},{"path":"references/api.md","content":"# Shopify 店铺查询 API 参考\n\n## 调用说明\n\n- **网关路由**：`POST ehunt/shopify/storeQuery`（完整：`${LINKFOX_TOOL_GATEWAY}/ehunt/shopify/storeQuery`）。\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 | 否 | 店铺名称或域名关键词 |\n| country | string | 否 | 国家代码（如 US、CN） |\n| year | integer | 否 | 店铺创建年份：1=最近 1 年，2=1~2 年，3=2~3 年，4=3 年以上 |\n| productNumMin | integer，≥0 | 否 | 产品数区间（起始） |\n| productNumMax | integer，≥0 | 否 | 产品数区间（结束） |\n| advertiseCountMin | integer，≥0 | 否 | 广告数区间（起始） |\n| advertiseCountMax | integer，≥0 | 否 | 广告数区间（结束） |\n| monthlyVisitMin | integer，≥0 | 否 | 月访问量区间（起始） |\n| monthlyVisitMax | integer，≥0 | 否 | 月访问量区间（结束） |\n| monthOrderMin | integer，≥0 | 否 | 月订单量区间（起始） |\n| monthOrderMax | integer，≥0 | 否 | 月订单量区间（结束） |\n| sortBy | integer | 否 | 排序字段：0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数（默认） |\n| orderBy | string | 否 | 排序方向：`desc`（默认）/`asc` |\n| page | integer，≥1，默认 1 | 否 | 页码（从 1 开始） |\n| pageSize | integer，1~100，默认 20 | 否 | 每页条数，最大 100 |\n\n## 响应主要字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 本页返回条数 |\n| storeNum | integer | 符合条件的店铺总数（上游 `store_num`） |\n| stores | array | Shopify 店铺列表 |\n| columns | array | 渲染的列 |\n| title | string | 标题（`Shopify 店铺查询`） |\n| sourceType | string | 来源类型：shopify |\n| sourceTool | string | 工具类型：ehunt |\n| type | string | 渲染的样式：tableListWorkbenches |\n\n### `stores[]` 元素\n\n| 字段 | 上游别名 | 说明 |\n|------|----------|------|\n| storeId | `store_id` | 店铺 ID |\n| shopId | `shop_id` | Shopify shop ID |\n| storeName | `store_name` | 店铺名称 |\n| storeDomain | `store_domain` | 店铺域名 |\n| storeLink | `store_link` | 店铺链接 |\n| country | - | 国家 |\n| createdTime | `created_time` | 创建时间 |\n| productNum | `product_num` | 产品数 |\n| categoryNum | `category_num` | 类目数 |\n| categories | - | 类目列表（元素含 `id`、`name`） |\n| monthlyVisit | `monthly_visit` | 月访问量（格式化） |\n| monthOrderNum | `month_order_num` | 月订单量（格式化） |\n| fbFollowers | `fb_followers` | Facebook 粉丝数 |\n| insFollowers | `ins_followers` | Instagram 粉丝数 |\n| advertiseCount | `advertise_count` | 广告数 |\n| adLink | `ad_link` | 广告库链接 |\n| email | - | 联系邮箱 |\n| facebookUrl | `facebook_url` | Facebook 主页 |\n| instagramUrl | `instagram_url` | Instagram 主页 |\n| socialLinks | `social_links` | 社媒链接（Map） |\n| globalRank | `global_rank` | 全球排名 |\n| logo | - | 店铺 Logo URL |\n| availableStatus | `available_status` | 是否活跃：1=活跃 |\n\n## 脚本调试（可选）\n\n仓库内提供 **`scripts/shopify_store_query.py`**（Python 3，仅标准库），向 LinkFox 工具网关 POST 与 MCP 入参一致的 JSON。\n\n- **网关**：`https://tool-gateway.linkfox.com`（可用 `LINKFOX_TOOL_GATEWAY_BASE` 覆盖根 URL）\n- **默认路径段**：`ehunt/shopify/storeQuery`（可用 `LINKFOX_EHUNT_SHOPIFY_STORE_QUERY_PATH` 覆盖，不含域名）\n- **鉴权**：环境变量 `LINKFOXAGENT_API_KEY`（与其他 `linkfox-*` skill 相同；如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n```bash\nex"},{"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\nSearch and filter independent Shopify stores by name or domain, country, store age, product count, ad count, monthly visits, monthly orders, and social follower metrics.\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\nE-commerce analysts, marketers, and sellers use this skill to discover Shopify stores and compare independent-store metrics for prospecting, competitor research, and market analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill includes LinkFox account, login, billing, and payment-order flows in addition to Shopify store querying.\n\nMitigation: Review those flows before installation and use them only when the user intends to create or recover an account, configure access, or buy credits.\n\nRisk: Custom gateway or login URL environment variables could redirect requests away from trusted LinkFox services.\n\nMitigation: Use the default LinkFox endpoints unless a trusted administrator provides an approved override.\n\nRisk: API keys, SMS codes, and phone numbers may be exposed if pasted into chat logs or shell startup files without care.\n\nMitigation: Store API keys in a proper secret manager or protected environment configuration, and share SMS codes or phone numbers only when intentionally completing LinkFox onboarding.\n\nRisk: Queries consume credits dynamically based on returned store count, so broad filters or pagination can increase cost.\n\nMitigation: Warn users before running broad searches, use narrower filters and page sizes when possible, and ask for confirmation before follow-up pages.\n\n## Reference(s):\n\n- [Shopify Store 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-store-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with JSON API results and optional shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Large API responses may be saved as JSON files and summarized in text.]\n\n## Skill Version(s):\n\n1.0.9 (source: 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 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。 Skill: Shopify店铺查询 Owner: linkfox-ai Summary: 按多维度筛选独立站 Shopify 店铺（店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等）。当用户提到 Shopify 店铺、Shopify 店铺分析、独立站店铺、Shopify seller、独立站竞品店铺、Shopify 月访问量、独立站广告库、shopify stores、Shopify store query 时触发。即使用户未提及工具名，只要在 Shopify 独立站上找店铺、筛店铺数据或分析店铺表现，也应触发此技能。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-08-14T15:09:48.020Z | user Update from 1.0.8 to 1.0.9 v1.0.8 | 2026-08-07T11:10:05.038Z | use","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1131,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T14:19:41.210Z","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:19:41.210Z","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:35:30.019Z","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"}]}}}