友鹰-shopee商品选品
基本信息
- 业务工具名：
/youying/shopee/getProductInfos
- 所属分组：友鹰 · Shopee 选品
- 功能说明：支持shopee全站点的商品查询，发现shopee的爆款货源。
- 关键词：友鹰, shopee选品, 虾皮选品, 关键词选品, 品类选品，市场分析，过滤，选品工具，功能需求调研, 市场机会点, 选品决策
何时使用
当用户意图与“友鹰-shopee商品选品”匹配，或需要以下能力时使用本工具：支持shopee全站点的商品查询，发现shopee的爆款货源。
调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。
输入参数
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
page |
integer |
否 |
默认 1 |
当前页码 |
pids |
string |
否 |
最长 10000 |
商品id列表(单次最多500个),多个商品id使用逗号隔开，如：aaa,bbb |
pL1Id |
string |
否 |
最长 1000 |
1级类目ID |
pL2Id |
string |
否 |
最长 1000 |
2级类目ID |
pL3Id |
string |
否 |
最长 1000 |
3级类目ID |
cidList |
string |
否 |
最长 1000 |
类目id列表，每组id必须指定完整路径，可指定多组id，多个组id使用｜隔开，如：AAA,BBB,CCC｜DDD,EEE |
keyword |
string |
否 |
最长 1000 |
标题 |
orderBy |
string |
否 |
最长 1000；示例：rating, price, historical_sold, sold, payment, favorite, ratings, gen_time |
排序方式: rating(评分), price(价格), historical_sold(商品总销售件数), sold(前30天销售件数), payment(前30天销售金额), favorite(Favorite数), ratings(Ratings数), gen_time(商品上架时间), estimate_sold(估算前30天销售件数) |
soldMax |
integer |
否 |
|
前30天销售件数结束值 |
soldMin |
integer |
否 |
|
前30天销售件数起始值 |
station |
string |
是 |
最长 1000；示例：malaysia, MY, taiwan_china, Taiwan_CHN, indonesia, ID, thailand, TH |
Shopee站点国家代码 |
cbOption |
integer |
否 |
|
发货地点: 1-跨境, 0-本土, 不传的情况下为指定全部 |
merchant |
string |
否 |
最长 1000 |
店铺名称或用户名称 |
pageSize |
integer |
否 |
默认 1000 |
每一页的商品数(范围1-1000) |
priceMax |
number |
否 |
|
商品总价结束值 |
priceMin |
number |
否 |
|
商品总价起始值 |
ratingMax |
number |
否 |
|
商品评分最大值 |
ratingMin |
number |
否 |
|
商品评分最小值 |
isHotSales |
integer |
否 |
|
商品是否热销: 0-非热销, 1-热销 |
paymentEnd |
number |
否 |
|
前30天销售金额结束值 |
ratingsMax |
integer |
否 |
|
ratings数结束值 |
ratingsMin |
integer |
否 |
|
ratings数起始值 |
shopIdList |
string |
否 |
最长 1000 |
商品店铺id列表, 可指定多个id，多个id使用逗号隔开 |
favoriteMax |
integer |
否 |
|
favorite数结束值 |
favoriteMin |
integer |
否 |
|
favorite数起始值 |
keywordType |
integer |
否 |
默认 1；示例：1, 2, 3 |
商品标题查询类型: 1-整句语句(默认), 2-多个搜索词"与"关系, 3-多个搜索词"或"关系 |
orderByType |
string |
否 |
默认 "DESC"；最长 1000；示例：ASC, DESC |
排序类型: ASC-升序, DESC-降序 |
statTimeEnd |
string |
否 |
格式 ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$ |
统计时间结束值(格式:YYYY-MM-DD HH:mm:ss,如 2024-01-01 12:12:12) |
paymentStart |
number |
否 |
|
前30天销售金额起始值 |
shopLocation |
string |
否 |
最长 1000 |
店铺所在地 |
skuNumberEnd |
integer |
否 |
|
Sku总数结束值 |
listingDateTo |
string |
否 |
最长 1000 |
商品上架时间结束值(格式:年-月-日) |
statTimeStart |
string |
否 |
格式 ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$ |
统计时间起始值(格式:YYYY-MM-DD HH:mm:ss,如 2024-01-01 12:12:12) |
isOfficialShop |
integer |
否 |
|
商品所属店铺是否官方店铺: 0-否, 1-是 |
skuNumberStart |
integer |
否 |
|
Sku总数起始值 |
approvedDateEnd |
string |
否 |
最长 1000 |
店铺开张时间结束值(格式:年-月-日) |
estimateSoldEnd |
integer |
否 |
|
估算前30天销售件数结束值 |
lastModiTimeEnd |
string |
否 |
最长 1000 |
最新抓取时间结束值(格式:年-月-日) |
listingDateFrom |
string |
否 |
最长 1000 |
商品上架时间起始值(格式:年-月-日) |
notExistKeyword |
string |
否 |
最长 1000 |
商品不包含标题 |
isShopeeVerified |
integer |
否 |
示例：0, 1 |
虾皮优选: 0-非优选, 1-优选, 不传的情况下为指定全部 |
shippingIconType |
integer |
否 |
示例：1, 0 |
店铺所在地: 1-海外, 0-本地, 不传的情况下为指定全部 |
approvedDateStart |
string |
否 |
最长 1000 |
店铺开张时间起始值(格式:年-月-日) |
estimateSoldStart |
integer |
否 |
|
估算前30天销售件数起始值 |
historicalSoldEnd |
integer |
否 |
|
商品总销售件数结束值 |
lastModiTimeStart |
string |
否 |
最长 1000 |
最新抓取时间起始值(格式:年-月-日) |
notExistShopIdList |
string |
否 |
最长 1000 |
商品不包含的店铺id列表, 可指定多个id，多个id使用逗号隔开 |
historicalSoldStart |
integer |
否 |
|
商品总销售件数起始值 |
notExistKeywordType |
integer |
否 |
默认 1 |
商品不包含标题查询类型: 1-整句语句(默认), 2-多个搜索词"与"关系, 3-多个搜索词"或"关系 |
MCP 调用示例
向以下地址发起 HTTP POST：
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体：
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "/youying/shopee/getProductInfos",
"arguments": {
"station": "malaysia",
"page": 1,
"pageSize": 1000
}
}
}
示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
输出字段
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
type |
string |
否 |
|
渲染的样式 |
total |
integer |
否 |
|
记录数 |
columns |
array<object> |
否 |
|
渲染的列 |
products |
array<object> |
否 |
|
商品列表 |
costToken |
integer |
否 |
|
消耗token |
totalSize |
integer |
否 |
|
总结果数 |
sourceTool |
string |
否 |
|
来源工具 |
sourceType |
string |
否 |
|
来源类型：shopee |
嵌套输出结构：products
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
cid |
string |
否 |
|
商品归属的类目ID(由一级至子类，多个以逗号分隔) |
pid |
string |
否 |
|
商品唯一ID |
sold |
integer |
否 |
|
商品前30天销售件数 |
price |
number |
否 |
|
商品默认价 |
stock |
integer |
否 |
|
库存数 |
title |
string |
否 |
|
商品标题 |
rating |
number |
否 |
|
商品评分 |
shopId |
string |
否 |
|
商品所属店铺id |
status |
integer |
否 |
|
商品状态: 1-正常, 0-下架, 8-列表中排除 |
genTime |
string |
否 |
|
商品上架时间 |
payment |
number |
否 |
|
商品前30天销售额 |
ratings |
integer |
否 |
|
商品评分数 |
shopUrl |
string |
否 |
|
shopee店铺链接 |
cbOption |
integer |
否 |
|
发货地点: 1-跨境, 0-本土 |
currency |
string |
否 |
|
货币单位 |
favorite |
integer |
否 |
|
商品喜欢人数 |
imageUrl |
string |
否 |
|
商品主图 |
maxPrice |
number |
否 |
|
商品最高价 |
minPrice |
number |
否 |
|
商品最低价 |
notExist |
integer |
否 |
|
商品是否存在: 0-存在, 1-不存在 |
shopName |
string |
否 |
|
店铺名称 |
statTime |
string |
否 |
|
商品统计时间 |
userName |
string |
否 |
|
店主名称 |
skuNumber |
integer |
否 |
|
sku数量 |
viewCount |
integer |
否 |
|
商品浏览数 |
isHotSales |
integer |
否 |
|
商品是否热销(预留字段) |
sourceTool |
string |
否 |
|
来源工具 |
sourceType |
string |
否 |
|
来源类型：shopee |
description |
string |
否 |
|
商品描述 |
approvedDate |
string |
否 |
|
店铺开张时间 |
estimateSold |
integer |
否 |
|
估算前30天销售件数 |
lastModiTime |
string |
否 |
|
商品最新抓取时间 |
shopLocation |
string |
否 |
|
店铺所在地 |
totalSaleCnt |
integer |
否 |
|
商品总销售件数 |
estimatedDays |
integer |
否 |
|
商品预计到货时间 |
isOfficialShop |
integer |
否 |
|
商品所属店铺是否官方店铺 |
productPageUrl |
string |
否 |
|
shopee商品链接 |
isShopeeVerified |
integer |
否 |
|
商品是否虾皮优选 |
shippingIconType |
integer |
否 |
|
店铺所在地: 0-本地, 1-海外, 3或null-未知 |
categoryStructure |
string |
否 |
|
商品所属的类目结构 |
shopProductsCount |
integer |
否 |
|
店铺商品总数 |
响应处理建议
- 先检查 JSON-RPC 外层是否包含
error。
- 成功时读取
result，并继续解析其中的 content、data、products、items 或其他业务字段。
- 如果响应为
text/event-stream，按 SSE 事件读取 data: 内容，再解析 JSON。
- 保留分页字段、总数、失败明细及
costToken。
- 向用户输出分析结论，不要直接倾倒大段原始 JSON。
原始 Schema
原始的Input Schema 和 Output Schema 参考 references/schema.md
解决认证和积分问题
异常情况：未配置 LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
注意：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时必须传递channel为 workbuddy。这非常重要！
1---2name: linkfox-youying-shopee-get-product-infos-23description: 友鹰Shopee商品选品工具，支持Shopee全站点的商品查询与筛选，覆盖马来西亚、中国台湾、印尼、泰国、菲律宾、新加坡、越南、巴西、墨西哥、智利、哥伦比亚等11个站点。当用户提到Shopee选品、虾皮商品搜索、Shopee爆款、虾皮市场分析、Shopee品类选品、虾皮关键词选品、Shopee销量筛选、虾皮价格筛选、东南亚电商选品、Shopee product search, Shopee product selection, Shopee bestsellers, Shopee market analysis时触发此技能。即使用户未明确提及"友鹰"或"Shopee"，只要其需求涉及在虾皮平台上搜索商品或筛选Shopee商品数据，也应触发此技能。4---5
6# 友鹰-shopee商品选品
7
8## 基本信息
9
10- **业务工具名**：`/youying/shopee/getProductInfos`
11- **所属分组**：友鹰 · Shopee 选品
12- **功能说明**：支持shopee全站点的商品查询，发现shopee的爆款货源。
13- **关键词**：友鹰, shopee选品, 虾皮选品, 关键词选品, 品类选品，市场分析，过滤，选品工具，功能需求调研, 市场机会点, 选品决策
14
15
16## 何时使用
17
18当用户意图与“友鹰-shopee商品选品”匹配，或需要以下能力时使用本工具：支持shopee全站点的商品查询，发现shopee的爆款货源。
19
20调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。
21
22## 输入参数
23
24| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
25|---|---|:---:|---|---|
26| `page` | `integer` | 否 | 默认 `1` | 当前页码 |
27| `pids` | `string` | 否 | 最长 10000 | 商品id列表(单次最多500个),多个商品id使用逗号隔开，如：aaa,bbb |
28| `pL1Id` | `string` | 否 | 最长 1000 | 1级类目ID |
29| `pL2Id` | `string` | 否 | 最长 1000 | 2级类目ID |
30| `pL3Id` | `string` | 否 | 最长 1000 | 3级类目ID |
31| `cidList` | `string` | 否 | 最长 1000 | 类目id列表，每组id必须指定完整路径，可指定多组id，多个组id使用｜隔开，如：AAA,BBB,CCC｜DDD,EEE |
32| `keyword` | `string` | 否 | 最长 1000 | 标题 |
33| `orderBy` | `string` | 否 | 最长 1000；示例：`rating`, `price`, `historical_sold`, `sold`, `payment`, `favorite`, `ratings`, `gen_time` | 排序方式: rating(评分), price(价格), historical_sold(商品总销售件数), sold(前30天销售件数), payment(前30天销售金额), favorite(Favorite数), ratings(Ratings数), gen_time(商品上架时间), estimate_sold(估算前30天销售件数) |
34| `soldMax` | `integer` | 否 | | 前30天销售件数结束值 |
35| `soldMin` | `integer` | 否 | | 前30天销售件数起始值 |
36| `station` | `string` | 是 | 最长 1000；示例：`malaysia`, `MY`, `taiwan_china`, `Taiwan_CHN`, `indonesia`, `ID`, `thailand`, `TH` | Shopee站点国家代码 |
37| `cbOption` | `integer` | 否 | | 发货地点: 1-跨境, 0-本土, 不传的情况下为指定全部 |
38| `merchant` | `string` | 否 | 最长 1000 | 店铺名称或用户名称 |
39| `pageSize` | `integer` | 否 | 默认 `1000` | 每一页的商品数(范围1-1000) |
40| `priceMax` | `number` | 否 | | 商品总价结束值 |
41| `priceMin` | `number` | 否 | | 商品总价起始值 |
42| `ratingMax` | `number` | 否 | | 商品评分最大值 |
43| `ratingMin` | `number` | 否 | | 商品评分最小值 |
44| `isHotSales` | `integer` | 否 | | 商品是否热销: 0-非热销, 1-热销 |
45| `paymentEnd` | `number` | 否 | | 前30天销售金额结束值 |
46| `ratingsMax` | `integer` | 否 | | ratings数结束值 |
47| `ratingsMin` | `integer` | 否 | | ratings数起始值 |
48| `shopIdList` | `string` | 否 | 最长 1000 | 商品店铺id列表, 可指定多个id，多个id使用逗号隔开 |
49| `favoriteMax` | `integer` | 否 | | favorite数结束值 |
50| `favoriteMin` | `integer` | 否 | | favorite数起始值 |
51| `keywordType` | `integer` | 否 | 默认 `1`；示例：`1`, `2`, `3` | 商品标题查询类型: 1-整句语句(默认), 2-多个搜索词"与"关系, 3-多个搜索词"或"关系 |
52| `orderByType` | `string` | 否 | 默认 `"DESC"`；最长 1000；示例：`ASC`, `DESC` | 排序类型: ASC-升序, DESC-降序 |
53| `statTimeEnd` | `string` | 否 | 格式 `^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$` | 统计时间结束值(格式:YYYY-MM-DD HH:mm:ss,如 2024-01-01 12:12:12) |
54| `paymentStart` | `number` | 否 | | 前30天销售金额起始值 |
55| `shopLocation` | `string` | 否 | 最长 1000 | 店铺所在地 |
56| `skuNumberEnd` | `integer` | 否 | | Sku总数结束值 |
57| `listingDateTo` | `string` | 否 | 最长 1000 | 商品上架时间结束值(格式:年-月-日) |
58| `statTimeStart` | `string` | 否 | 格式 `^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$` | 统计时间起始值(格式:YYYY-MM-DD HH:mm:ss,如 2024-01-01 12:12:12) |
59| `isOfficialShop` | `integer` | 否 | | 商品所属店铺是否官方店铺: 0-否, 1-是 |
60| `skuNumberStart` | `integer` | 否 | | Sku总数起始值 |
61| `approvedDateEnd` | `string` | 否 | 最长 1000 | 店铺开张时间结束值(格式:年-月-日) |
62| `estimateSoldEnd` | `integer` | 否 | | 估算前30天销售件数结束值 |
63| `lastModiTimeEnd` | `string` | 否 | 最长 1000 | 最新抓取时间结束值(格式:年-月-日) |
64| `listingDateFrom` | `string` | 否 | 最长 1000 | 商品上架时间起始值(格式:年-月-日) |
65| `notExistKeyword` | `string` | 否 | 最长 1000 | 商品不包含标题 |
66| `isShopeeVerified` | `integer` | 否 | 示例：`0`, `1` | 虾皮优选: 0-非优选, 1-优选, 不传的情况下为指定全部 |
67| `shippingIconType` | `integer` | 否 | 示例：`1`, `0` | 店铺所在地: 1-海外, 0-本地, 不传的情况下为指定全部 |
68| `approvedDateStart` | `string` | 否 | 最长 1000 | 店铺开张时间起始值(格式:年-月-日) |
69| `estimateSoldStart` | `integer` | 否 | | 估算前30天销售件数起始值 |
70| `historicalSoldEnd` | `integer` | 否 | | 商品总销售件数结束值 |
71| `lastModiTimeStart` | `string` | 否 | 最长 1000 | 最新抓取时间起始值(格式:年-月-日) |
72| `notExistShopIdList` | `string` | 否 | 最长 1000 | 商品不包含的店铺id列表, 可指定多个id，多个id使用逗号隔开 |
73| `historicalSoldStart` | `integer` | 否 | | 商品总销售件数起始值 |
74| `notExistKeywordType` | `integer` | 否 | 默认 `1` | 商品不包含标题查询类型: 1-整句语句(默认), 2-多个搜索词"与"关系, 3-多个搜索词"或"关系 |
75
76
77## MCP 调用示例
78
79向以下地址发起 HTTP `POST`：
80
81```text
82https://mcp-tool-gateway.linkfox.com/mcp/any-tool
83```
84
85请求体：
86
87```json
88{
89 "jsonrpc": "2.0",
90 "id": 1,
91 "method": "tools/call",
92 "params": {
93 "name": "/youying/shopee/getProductInfos",
94 "arguments": {
95 "station": "malaysia",
96 "page": 1,
97 "pageSize": 1000
98 }
99 }
100}
101```
102
103> 示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
104
105## 输出字段
106
107| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
108|---|---|:---:|---|---|
109| `type` | `string` | 否 | | 渲染的样式 |
110| `total` | `integer` | 否 | | 记录数 |
111| `columns` | `array<object>` | 否 | | 渲染的列 |
112| `products` | `array<object>` | 否 | | 商品列表 |
113| `costToken` | `integer` | 否 | | 消耗token |
114| `totalSize` | `integer` | 否 | | 总结果数 |
115| `sourceTool` | `string` | 否 | | 来源工具 |
116| `sourceType` | `string` | 否 | | 来源类型：shopee |
117
118### 嵌套输出结构：`products`
119
120| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
121|---|---|:---:|---|---|
122| `cid` | `string` | 否 | | 商品归属的类目ID(由一级至子类，多个以逗号分隔) |
123| `pid` | `string` | 否 | | 商品唯一ID |
124| `sold` | `integer` | 否 | | 商品前30天销售件数 |
125| `price` | `number` | 否 | | 商品默认价 |
126| `stock` | `integer` | 否 | | 库存数 |
127| `title` | `string` | 否 | | 商品标题 |
128| `rating` | `number` | 否 | | 商品评分 |
129| `shopId` | `string` | 否 | | 商品所属店铺id |
130| `status` | `integer` | 否 | | 商品状态: 1-正常, 0-下架, 8-列表中排除 |
131| `genTime` | `string` | 否 | | 商品上架时间 |
132| `payment` | `number` | 否 | | 商品前30天销售额 |
133| `ratings` | `integer` | 否 | | 商品评分数 |
134| `shopUrl` | `string` | 否 | | shopee店铺链接 |
135| `cbOption` | `integer` | 否 | | 发货地点: 1-跨境, 0-本土 |
136| `currency` | `string` | 否 | | 货币单位 |
137| `favorite` | `integer` | 否 | | 商品喜欢人数 |
138| `imageUrl` | `string` | 否 | | 商品主图 |
139| `maxPrice` | `number` | 否 | | 商品最高价 |
140| `minPrice` | `number` | 否 | | 商品最低价 |
141| `notExist` | `integer` | 否 | | 商品是否存在: 0-存在, 1-不存在 |
142| `shopName` | `string` | 否 | | 店铺名称 |
143| `statTime` | `string` | 否 | | 商品统计时间 |
144| `userName` | `string` | 否 | | 店主名称 |
145| `skuNumber` | `integer` | 否 | | sku数量 |
146| `viewCount` | `integer` | 否 | | 商品浏览数 |
147| `isHotSales` | `integer` | 否 | | 商品是否热销(预留字段) |
148| `sourceTool` | `string` | 否 | | 来源工具 |
149| `sourceType` | `string` | 否 | | 来源类型：shopee |
150| `description` | `string` | 否 | | 商品描述 |
151| `approvedDate` | `string` | 否 | | 店铺开张时间 |
152| `estimateSold` | `integer` | 否 | | 估算前30天销售件数 |
153| `lastModiTime` | `string` | 否 | | 商品最新抓取时间 |
154| `shopLocation` | `string` | 否 | | 店铺所在地 |
155| `totalSaleCnt` | `integer` | 否 | | 商品总销售件数 |
156| `estimatedDays` | `integer` | 否 | | 商品预计到货时间 |
157| `isOfficialShop` | `integer` | 否 | | 商品所属店铺是否官方店铺 |
158| `productPageUrl` | `string` | 否 | | shopee商品链接 |
159| `isShopeeVerified` | `integer` | 否 | | 商品是否虾皮优选 |
160| `shippingIconType` | `integer` | 否 | | 店铺所在地: 0-本地, 1-海外, 3或null-未知 |
161| `categoryStructure` | `string` | 否 | | 商品所属的类目结构 |
162| `shopProductsCount` | `integer` | 否 | | 店铺商品总数 |
163
164## 响应处理建议
165
1661. 先检查 JSON-RPC 外层是否包含 `error`。
1672. 成功时读取 `result`，并继续解析其中的 `content`、`data`、`products`、`items` 或其他业务字段。
1683. 如果响应为 `text/event-stream`，按 SSE 事件读取 `data:` 内容，再解析 JSON。
1694. 保留分页字段、总数、失败明细及 `costToken`。
1705. 向用户输出分析结论，不要直接倾倒大段原始 JSON。
171
172## 原始 Schema
173
174原始的Input Schema 和 Output Schema 参考 references/schema.md
175
176## 解决认证和积分问题
177
178异常情况：未配置 `LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY`；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
179
180措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
181
182**注意**：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时**必须**传递channel为 workbuddy。这非常重要！
ahang1598