linkfox-youying-shopee-get-product-infos

name	linkfox-youying-shopee-get-product-infos
description	友鹰Shopee商品选品工具，支持Shopee全站点的商品查询与筛选，覆盖马来西亚、中国台湾、印尼、泰国、菲律宾、新加坡、越南、巴西、墨西哥、智利、哥伦比亚等11个站点。当用户提到Shopee选品、虾皮商品搜索、Shopee爆款、虾皮市场分析、Shopee品类选品、虾皮关键词选品、Shopee销量筛选、虾皮价格筛选、东南亚电商选品、Shopee product search, Shopee product selection, Shopee bestsellers, Shopee market analysis时触发此技能。即使用户未明确提及"友鹰"或"Shopee"，只要其需求涉及在虾皮平台上搜索商品或筛选Shopee商品数据，也应触发此技能。

友鹰-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-本土

响应处理建议

1. 先检查 JSON-RPC 外层是否包含 error。
2. 成功时读取 result，并继续解析其中的 content、data、products、items 或其他业务字段。
3. 如果响应为 text/event-stream，按 SSE 事件读取 data: 内容，再解析 JSON。
4. 保留分页字段、总数、失败明细及 costToken。
5. 向用户输出分析结论，不要直接倾倒大段原始 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。这非常重要！