Back to Details

linkfox-youying-shopee-product-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

友鹰-Shopee 商品选品

友鹰-Shopee 商品选品

This skill guides you on how to query and filter Shopee product data across 11 marketplaces, helping cross-border sellers discover trending products and market opportunities on Shopee.
本技能将指导您如何在11个站点查询和筛选Shopee商品数据，帮助跨境卖家发掘Shopee平台上的热门商品与市场机会。

Core Concepts

核心概念

友鹰（YouYing）Shopee 商品选品工具提供 Shopee 全站商品的结构化查询能力。卖家可通过关键词、价格区间、销量、上架时间、店铺属性等多维度条件灵活组合筛选，发现爆款货源与市场机会。
核心数据维度：
  • 销量数据：前30天销售件数（sold）、估算前30天销售件数（estimateSold）、商品总销售件数（historicalSold）、前30天销售额（payment）
  • 价格数据：默认价（price）、最低价（minPrice）、最高价（maxPrice）
  • 店铺数据：店铺名称、是否官方店铺、虾皮优选、本地/海外、跨境/本土
  • 商品属性：评分、评分数、收藏数、浏览数、SKU 数量、上架时间、类目结构
友鹰（YouYing）Shopee 商品选品工具提供 Shopee 全站商品的结构化查询能力。卖家可通过关键词、价格区间、销量、上架时间、店铺属性等多维度条件灵活组合筛选，发现爆款货源与市场机会。
核心数据维度：
  • 销量数据：前30天销售件数（sold）、估算前30天销售件数（estimateSold）、商品总销售件数（historicalSold）、前30天销售额（payment）
  • 价格数据：默认价（price）、最低价（minPrice）、最高价（maxPrice）
  • 店铺数据：店铺名称、是否官方店铺、虾皮优选、本地/海外、跨境/本土
  • 商品属性：评分、评分数、收藏数、浏览数、SKU 数量、上架时间、类目结构

Data Fields

数据字段

Product Fields (Output)

商品字段（输出）

FieldAPI NameDescriptionExample
商品IDpid商品唯一标识12345678
商品标题title商品名称Storage Box Organizer
商品描述description商品详细描述...
商品主图imageUrl商品主图URLhttps://...
商品链接productUrlShopee商品页面链接https://...
默认价price商品默认价格（当地货币）29.90
最低价minPriceSKU最低价19.90
最高价maxPriceSKU最高价39.90
前30天销售件数sold近30天实际销量1500
估算前30天销量estimateSold估算的近30天销量1200
总销售件数historicalSold商品累计总销量50000
前30天销售额payment近30天销售金额（当地货币）45000
商品评分rating0-5分4.8
评分数ratings收到的评分总数320
收藏数favorite被收藏次数2800
浏览数viewCount浏览次数15000
库存stock当前库存数量500
SKU数量skuNumberSKU变体数量8
上架时间genTime商品首次上架日期2025-06-01
类目结构categoryStructure所属类目层级路径Home & Living > Storage
店铺名称shopName所属店铺名称BestHome Official
店铺链接shopUrl店铺页面链接https://...
是否官方店铺isOfficialShop1=是, 0=否1
虾皮优选isShopeeVerified1=优选, 0=非优选1
发货类型cbOption1=跨境, 0=本土0
店铺所在地类型shippingIconType0=本地, 1=海外0
商品状态status1=正常, 0=下架1
字段API名称描述示例
商品IDpid商品唯一标识12345678
商品标题title商品名称Storage Box Organizer
商品描述description商品详细描述...
商品主图imageUrl商品主图URLhttps://...
商品链接productUrlShopee商品页面链接https://...
默认价price商品默认价格（当地货币）29.90
最低价minPriceSKU最低价19.90
最高价maxPriceSKU最高价39.90
前30天销售件数sold近30天实际销量1500
估算前30天销量estimateSold估算的近30天销量1200
总销售件数historicalSold商品累计总销量50000
前30天销售额payment近30天销售金额（当地货币）45000
商品评分rating0-5分4.8
评分数ratings收到的评分总数320
收藏数favorite被收藏次数2800
浏览数viewCount浏览次数15000
库存stock当前库存数量500
SKU数量skuNumberSKU变体数量8
上架时间genTime商品首次上架日期2025-06-01
类目结构categoryStructure所属类目层级路径Home & Living > Storage
店铺名称shopName所属店铺名称BestHome Official
店铺链接shopUrl店铺页面链接https://...
是否官方店铺isOfficialShop1=是, 0=否1
虾皮优选isShopeeVerified1=优选, 0=非优选1
发货类型cbOption1=跨境, 0=本土0
店铺所在地类型shippingIconType0=本地, 1=海外0
商品状态status1=正常, 0=下架1

Supported Marketplaces

支持站点

站点station 值代码
马来西亚malaysiaMY
台湾taiwan_chinaTaiwan_CHN
印度尼西亚indonesiaID
泰国thailandTH
菲律宾philippinesPH
新加坡singaporeSG
越南vietnamVN
巴西brazilBR
墨西哥mexicoMX
智利chileCL
哥伦比亚columbiaCO
station
为必填参数，可传站点名（如 
malaysia
）或代码（如 
MY
）。当用户未指定站点时，需要询问用户想查询哪个站点。
站点station 值代码
马来西亚malaysiaMY
台湾taiwan_chinaTaiwan_CHN
印度尼西亚indonesiaID
泰国thailandTH
菲律宾philippinesPH
新加坡singaporeSG
越南vietnamVN
巴西brazilBR
墨西哥mexicoMX
智利chileCL
哥伦比亚columbiaCO
station
为必填参数，可传站点名（如 
malaysia
）或代码（如 
MY
）。当用户未指定站点时，需要询问用户想查询哪个站点。

API Usage

API 使用说明

This tool calls the LinkFox tool gateway API. See 
references/api.md
for calling conventions, request parameters, and response structure. You can also execute 
scripts/youying_shopee_search.py
directly to run queries.
本工具调用LinkFox工具网关API。调用规范、请求参数及响应结构请参考
references/api.md
。您也可以直接执行
scripts/youying_shopee_search.py
来运行查询。

How to Build Queries

查询构建方法

根据用户需求，将自然语言转换为 API 参数组合。核心原则是精确映射用户的筛选条件到对应参数。
根据用户需求，将自然语言转换为 API 参数组合。核心原则是精确映射用户的筛选条件到对应参数。

Principles for Building API Calls

API调用构建原则

  1. 必填站点：每次调用必须指定 
    station
    。用户说"马来""马来西亚"→ 
    malaysia
    ；"台湾"→ 
    taiwan_china
    ；"印尼"→ 
    indonesia
    等
  2. 关键词搜索：
    keyword
    为标题关键词，搭配 
    keywordType
    控制匹配模式（1=整句匹配，2=多词AND，3=多词OR）
  3. 数值范围：大多数筛选条件使用 Start/End 或 Min/Max 成对参数，按需设置单侧或双侧
  4. 排序：
    orderBy
    指定排序字段，
    orderByType
    指定升/降序（默认 DESC 降序）
  5. 分页：
    page
    从 1 开始，
    pageSize
    范围 1-1000，默认 1000
  6. 排除逻辑：
    notExistKeyword
    可排除包含特定词的商品，
    notExistShopIdList
    可排除特定店铺
  1. 必填站点：每次调用必须指定 
    station
    。用户说"马来""马来西亚"→ 
    malaysia
    ；"台湾"→ 
    taiwan_china
    ；"印尼"→ 
    indonesia
    等
  2. 关键词搜索：
    keyword
    为标题关键词，搭配 
    keywordType
    控制匹配模式（1=整句匹配，2=多词AND，3=多词OR）
  3. 数值范围：大多数筛选条件使用Start/End或Min/Max成对参数，按需设置单侧或双侧
  4. 排序：
    orderBy
    指定排序字段，
    orderByType
    指定升/降序（默认DESC降序）
  5. 分页：
    page
    从1开始，
    pageSize
    范围1-1000，默认1000
  6. 排除逻辑：
    notExistKeyword
    可排除包含特定词的商品，
    notExistShopIdList
    可排除特定店铺

Common Query Scenarios

常见查询场景

1. 关键词选品 — 按销量筛选热销商品
station: malaysia
keyword: Storage Box
keywordType: 2
soldMin: 100
orderBy: sold
orderByType: DESC
pageSize: 100
2. 新品发现 — 近期上架且有一定销量的商品
station: thailand
keyword: Phone Case
listingDateFrom: 2025-06-01
soldMin: 50
orderBy: gen_time
orderByType: DESC
3. 高潜力商品 — 低价高销量
station: indonesia
keyword: LED Light
priceMax: 50000
soldMin: 500
orderBy: payment
orderByType: DESC
4. 跨境卖家商品筛选
station: malaysia
keyword: Wireless Earbuds
cbOption: 1
soldMin: 200
orderBy: sold
orderByType: DESC
5. 品类选品 — 按类目 + 销售额筛选
station: vietnam
pL1Id: 11036379
paymentStart: 10000000
orderBy: payment
orderByType: DESC
pageSize: 200
6. 竞品店铺分析 — 查看特定店铺的商品
station: malaysia
shopIdList: 123456789
orderBy: sold
orderByType: DESC
7. 优选商品筛选 — 虾皮优选 + 高评分
station: philippines
keyword: Beauty
isShopeeVerified: 1
ratingMin: 4.5
soldMin: 100
orderBy: rating
orderByType: DESC
8. 大卖排除 — 发现中小卖家机会
station: taiwan_china
keyword: 收纳盒
notExistShopIdList: 111111,222222,333333
soldMin: 50
soldMax: 500
orderBy: sold
orderByType: DESC
1. 关键词选品 — 按销量筛选热销商品
station: malaysia
keyword: Storage Box
keywordType: 2
soldMin: 100
orderBy: sold
orderByType: DESC
pageSize: 100
2. 新品发现 — 近期上架且有一定销量的商品
station: thailand
keyword: Phone Case
listingDateFrom: 2025-06-01
soldMin: 50
orderBy: gen_time
orderByType: DESC
3. 高潜力商品 — 低价高销量
station: indonesia
keyword: LED Light
priceMax: 50000
soldMin: 500
orderBy: payment
orderByType: DESC
4. 跨境卖家商品筛选
station: malaysia
keyword: Wireless Earbuds
cbOption: 1
soldMin: 200
orderBy: sold
orderByType: DESC
5. 品类选品 — 按类目 + 销售额筛选
station: vietnam
pL1Id: 11036379
paymentStart: 10000000
orderBy: payment
orderByType: DESC
pageSize: 200
6. 竞品店铺分析 — 查看特定店铺的商品
station: malaysia
shopIdList: 123456789
orderBy: sold
orderByType: DESC
7. 优选商品筛选 — 虾皮优选 + 高评分
station: philippines
keyword: Beauty
isShopeeVerified: 1
ratingMin: 4.5
soldMin: 100
orderBy: rating
orderByType: DESC
8. 大卖排除 — 发现中小卖家机会
station: taiwan_china
keyword: 收纳盒
notExistShopIdList: 111111,222222,333333
soldMin: 50
soldMax: 500
orderBy: sold
orderByType: DESC

Display Rules

展示规则

  1. Present data only: Show query results in clear tables without subjective business advice
  2. Currency notice: Different marketplaces use different currencies (MYR, TWD, IDR, THB, PHP, SGD, VND, BRL, MXN, CLP, COP). Always remind users of the currency context when showing price/payment data
  3. Volume notice: When results are large, show core data (title, price, sold, payment, rating) and remind users they can view more via pagination
  4. Key metrics highlight: Prioritize showing 
    sold
    (前30天销量), 
    payment
    (前30天销售额), 
    price
    , 
    rating
    as these are the most decision-relevant metrics
  5. Error handling: When a query fails, explain the reason based on the error response and suggest adjusting query criteria
  6. Image display: When 
    imageUrl
    is available, include product images to help users make visual assessments
  1. 仅展示数据：以清晰表格形式呈现查询结果，不提供主观商业建议
  2. 货币提示：不同站点使用不同货币（MYR、TWD、IDR、THB、PHP、SGD、VND、BRL、MXN、CLP、COP）。展示价格/销售额数据时，务必提醒用户注意货币背景
  3. 结果量提示：当结果数量较多时，展示核心数据（标题、价格、销量、销售额、评分），并提醒用户可通过分页查看更多内容
  4. 关键指标优先：优先展示
    sold
    （前30天销量）、
    payment
    （前30天销售额）、
    price
    、
    rating
    这些与决策最相关的指标
  5. 错误处理：当查询失败时，根据错误响应说明原因，并建议调整查询条件
  6. 图片展示：当
    imageUrl
    可用时，展示商品图片以帮助用户进行视觉评估

Important Limitations

重要限制

  • Result cap: 
    pageSize
    maximum is 1000 records per request
  • Required field: 
    station
    is always required — if missing, ask the user which marketplace to query
  • Price currency: Prices are in local currency of the selected marketplace, not USD
  • Data freshness: Data depends on 友鹰's crawling schedule, see 
    lastModiTime
    for last update time
  • 结果上限：每次请求的
    pageSize
    最大值为1000条记录
  • 必填字段：
    station
    始终为必填项——如果缺失，请询问用户要查询哪个站点
  • 价格货币：价格为所选站点的本地货币，非美元
  • 数据新鲜度：数据取决于友鹰的爬取计划，可查看
    lastModiTime
    了解最后更新时间

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable - Shopee product search and filtering:
User SaysScenario
"虾皮上什么好卖" "Shopee爆款"Hot-selling product discovery
"帮我在Shopee上搜xx商品"Keyword product search
"马来站最近上架的新品"New product discovery by listing date
"销量过千的商品有哪些"Volume-based product filtering
"东南亚哪些品类有机会"Category-level opportunity scan
"帮我看看这个店铺的商品"Competitor shop analysis
"跨境商品和本土商品对比"Cross-border vs local comparison
"Shopee优选商品筛选"Shopee Verified product filtering
"低价高销量的商品"Price-volume opportunity mining
Not applicable - Needs beyond Shopee product search:
  • Amazon, TikTok, eBay, 1688 等其他平台的商品搜索
  • Shopee 广告投放策略
  • Shopee 店铺运营建议
  • Shopee 物流/仓储方案
  • 已有本地 Shopee 数据文件的处理
Boundary judgment: When users say "东南亚选品", "虾皮市场分析", or "跨境电商选品", if it boils down to searching and filtering products on Shopee by various criteria, this skill applies. If they're asking about logistics planning, advertising strategy, or store operations, it does not apply.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in 
references/api.md
. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
适用场景 - Shopee商品搜索与筛选：
用户表述场景
"虾皮上什么好卖" "Shopee爆款"热销商品发掘
"帮我在Shopee上搜xx商品"关键词商品搜索
"马来站最近上架的新品"按上架日期发掘新品
"销量过千的商品有哪些"按销量筛选商品
"东南亚哪些品类有机会"类目级机会扫描
"帮我看看这个店铺的商品"竞品店铺分析
"跨境商品和本土商品对比"跨境与本土商品对比
"Shopee优选商品筛选"虾皮优选商品筛选
"低价高销量的商品"价格-销量机会挖掘
不适用场景 - 超出Shopee商品搜索的需求：
  • Amazon、TikTok、eBay、1688等其他平台的商品搜索
  • Shopee广告投放策略
  • Shopee店铺运营建议
  • Shopee物流/仓储方案
  • 已有本地Shopee数据文件的处理
边界判断：当用户提及“东南亚选品”“虾皮市场分析”或“跨境电商选品”时，如果核心需求是通过各类条件在Shopee上搜索和筛选商品，则适用本技能；如果是询问物流规划、广告策略或店铺运营，则不适用。
反馈：
当出现以下任一情况时，自动检测并通过Feedback API提交反馈：
  1. 本技能描述的功能或用途与实际行为不符
  2. 本技能的结果不符合用户意图
  3. 用户表达了对本技能的不满或赞扬
  4. 任何您认为可以改进的内容
请按照
references/api.md
中的说明调用反馈API，不要打断用户流程。
如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。