用途:面向跨境卖家,在包括马来西亚、台湾(中国)、印度尼西亚、泰国、菲律宾、新加坡、越南、巴西、墨西哥、智利、哥伦比亚在内的 11 个 Shopee 站点查询和筛选商品,用于热销品发现、新品挖掘、类目机会扫描、竞品店铺分析及跨境与本地商品对比。不适用于 Amazon、TikTok、eBay、1688 等其他平台,也不涉及广告策略、店铺运营建议、物流仓储方案或本地 Shopee 数据文件处理。
主要能力:支持关键词(keyword,配合 keywordType:1 精确短语、2 多词 AND、3 多词 OR)、价格区间(price/minPrice/maxPrice)、销量(sold、estimateSold、historicalSold)、销售额(payment)、评分与评分数、收藏、浏览、SKU 数、上架日期、类目、店铺属性(官方店、Shopee Verified、跨境/本地)、店铺 ID 排除、关键词排除、排序(orderBy/orderByType)与分页(page 从 1 起,pageSize 1-1000)等维度组合筛选。输出字段含商品 ID、标题、描述、主图、链接、价格、销量、收入、评分、库存、SKU 数、上架时间、类目结构、店铺名称与链接、官方店状态、认证状态、履约类型、店铺位置类型、商品状态等。
使用方式:站点点位 station 为必填,可传站点名(如 malaysia)或代码(如 MY);未指定时需询问用户。接口为 POST /youying/shopee/getProductInfos。脚本用法:python scripts/shopee_product_search.py '<JSON params>' [--inline]。需设置环境变量 NEXSCOPE_API_KEY,积分管理见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-youying-shopee-get-product-infos-<timestamp>.json,禁止写入 /tmp;响应 ≤8KB 时输出完整 JSON,>8KB 时仅输出摘要;加 --inline 可强制完整输出但仍写盘。
限制:同一参数组合默认每会话只调用一次,脚本含 24 小时本地缓存;失败或结果为空时不要自动更换关键词、翻页或修改参数重试,需先告知用户将产生额外费用;单次请求最多 1000 条;价格为所选站点本地货币;数据更新取决于 YouYing 抓取计划,可查看 lastModiTime;展示时应提示货币背景,仅呈现数据,不提供主观经营建议。