# Linkfox Wb Shopify Data

> 面向独立站卖家的 Shopify 商品与店铺选品和市场研究能力。

面向独立站卖家的 Shopify 商品与店铺选品和市场研究能力。

- Page: https://ss33.ai/skills/linkfox-ai/linkfox-wb-shopify-data-87086346981
- Publisher: linkfox-ai
- Category: [Business](https://ss33.ai/skills/category/business-y1h0vy) › [Website & online store](https://ss33.ai/skills/category/business-y1h0vy/website-and-online-store-ufkq7b)
- License: MIT
- Source: https://github.com/linkfox-ai/linkfox-skills/blob/ea5581c8c727f259a4fa5ea3df00e7cec77bf5ce/skills/linkfox-wb-shopify-data/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/linkfox-ai/linkfox-wb-shopify-data-87086346981

> [!IMPORTANT]
本 Skill 必须依赖 MCP “LinkFox”。如未安装该MCP，请明确通知用户：
> 请先安装 LinkFox 连接器：
> - 在 WorkBuddy 左侧找到 “专家·技能·连接器” → “连接器”；
> - 搜索关键词 “LinkFox”，并安装连接器 “LinkFox”（注意：是 linkfox，不是 linkfox-product-selection），按指引完成登录授权；
> - 返回 WorkBuddy 重试。


# LinkFox Shopify选品数据

通过 WorkBuddy 的 `LinkFox` 查询 Shopify 商品或店铺市场数据。

## 能力边界

- 商品查询：按关键词或 URL、价格、周销量、上架日期、Facebook 广告、竞争度、货源、下架状态、发货国家和排序筛选商品。
- 店铺查询：按名称或域名、国家、创建年限、产品数、广告数、月访问量、月订单量和排序筛选店铺。
- 返回当前可用的市场快照，不提供 Shopify 后台管理、刊登、订单、库存、广告投放、历史趋势或经营结果保证。
- 商品与店铺是不同粒度；从商品转向店铺研究属于第二次收费调用，需由用户决定。

## 路由与 allowlist

| 子能力 | reference | `toolName` | 本地辅助脚本 |
|---|---|---|---|
| Shopify 商品查询 | `references/linkfox-shopify-product-query.md` | `ehunt/shopify/productQuery` | 无 |
| Shopify 店铺查询 | `references/linkfox-shopify-store-query.md` | `ehunt/shopify/storeQuery` | 无 |

只允许以上两个精确且区分大小写的 `toolName`。商品级需求使用商品查询，店铺级需求使用店铺查询，不用另一类结果补猜。

## MCP 调用契约

- MCP Server：`LinkFox`
- Server URL：`https://mcp-tool-gateway.linkfox.com/mcp/any-tool`
- 唯一工具：`proxy_call`
- 原业务请求对象直接放入 `arguments`，不得增加 `body`、`params`、`data` 或嵌套 `arguments`。
- WorkBuddy 自动注入授权信息；调用参数中不得添加认证字段或凭据。
- 禁止 curl、`urllib`、`requests`、`httpx` 或其他方式直连工具网关；MCP 缺失时禁止静默 HTTP fallback。
- 收费调用失败、空结果或不理想时不得自动重试、改词、换 URL、放宽条件或翻页。同一任务内相同 `toolName + arguments` 不得重复调用。

```json
{
  "toolName": "ehunt/shopify/productQuery",
  "arguments": {
    "searchKey": "phone case",
    "country": "US",
    "sortBy": 14,
    "page": 1,
    "pageSize": 20
  }
}
```

## 响应处理

1. 检查 MCP 连接、工具可用性、schema 错误和 `isError`。
2. 代理成功后读取 text 或 structured content；text 是 JSON 字符串时只解析一次。
3. 再检查下游 `errcode`、`errorCode`、`code`、`errmsg` 或消息字段。
4. 最后按对应 reference 读取商品或店铺列表，不把 MCP 外层对象当作业务响应。
5. 错误后不得猜测另一个 `toolName`，不得循环解析字符串化 JSON。

## 使用与展示纪律

- 两类查询的 `page` 从 1 开始，`pageSize` 默认 20、最大 100；范围条件只填一侧时由上游解释为开放区间。
- 商品 `sortBy` 默认 14；未知编码不得猜测。店铺排序枚举与方向见对应 reference。
- 展示查询范围、本页条数、总数、当前页和消耗；商品价格以 USD 口径展示，格式化指标按返回值保留。
- 区分估算、格式化值与明确数值；缺失字段标记 N/A，不推导销量保证、利润或经营结论。
- 新 MCP 链路不提供旧脚本的本地缓存、响应落盘或 stdout 摘要；追溯时保留本次参数、查询时间和原始 MCP 结果。

## 成本、异常与反馈

商品与店铺查询的动态计费均为“本页返回数 × 1.8 积分”，实际以响应和当前计费规则为准。翻页、增大页数或第二次联查前说明额外消耗，由用户决定。

MCP、授权、计费和权限异常按 `references/onboarding.md` 分层处理。Feedback 是独立端点，规则见业务 references；不得与业务 MCP 混用或阻断当前结果。