SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-youying-shopee-get-product-infos

linkfox-youying-shopee-get-product-infos

营销与增长

查看项目

更新于 10-15 18:18

技能介绍

用途

友鹰Shopee商品选品工具用于查询和筛选Shopee多站点的商品数据，帮助跨境卖家发现热销商品与市场机会。适用于Shopee选品、虾皮商品搜索、Shopee爆款挖掘、虾皮市场分析、Shopee品类选品、虾皮关键词选品、销量筛选、价格筛选等场景。

支持站点

覆盖11个站点，station为必填参数，可传站点名或代码：

  • 马来西亚（malaysia / MY）
  • 中国台湾（taiwan_china / Taiwan_CHN）
  • 印度尼西亚（indonesia / ID）
  • 泰国（thailand / TH）
  • 菲律宾（philippines / PH）
  • 新加坡（singapore / SG）
  • 越南（vietnam / VN）
  • 巴西（brazil / BR）
  • 墨西哥（mexico / MX）
  • 智利（chile / CL）
  • 哥伦比亚（columbia / CO）

用户未指定站点时，需要询问用户想查询哪个站点。

主要能力

数据维度

  • 销量数据：前30天销售件数（sold）、估算前30天销售件数（estimateSold）、商品总销售件数（historicalSold）、前30天销售额（payment）
  • 价格数据：默认价（price）、最低价（minPrice）、最高价（maxPrice）
  • 店铺数据：店铺名称、是否官方店铺、虾皮优选、本地/海外、跨境/本土
  • 商品属性：评分、评分数、收藏数、浏览数、SKU数量、上架时间、类目结构

输出字段

商品ID（pid）、商品标题（title）、商品描述（description）、商品主图（imageUrl）、商品链接（productUrl）、Shopee商品链接（shopeeUrl）、默认价（price）、最低价（minPrice）、最高价（maxPrice）、前30天销售件数（sold）、估算前30天销量（estimateSold）、总销售件数（historicalSold）、前30天销售额（payment）、商品评分（rating）、评分数（ratings）、收藏数（favorite）、浏览数（viewCount）、库存（stock）、SKU数量（skuNumber）、上架时间（genTime）、类目结构（categoryStructure）、店铺名称（shopName）、店铺链接（shopUrl）、是否官方店铺（isOfficialShop）、虾皮优选（isShopeeVerified）、发货类型（cbOption，1=跨境，0=本土）、店铺所在地类型（shippingIconType，0=本地，1=海外）、商品状态（status，1=正常，0=下架）。

使用方式

调用方式

  • API 端点：POST /youying/shopee/getProductInfos（完整参数/响应/错误码见 references/api.md）
  • Python 脚本：python scripts/youying_shopee_search.py '<JSON 参数>' [--inline]

查询构建原则

  • 必填站点：每次调用必须指定 station
  • 关键词搜索：keyword 为标题关键词，keywordType 控制匹配模式（1=整句匹配，2=多词AND，3=多词OR）
  • 数值范围：多数筛选条件使用 Start/End 或 Min/Max 成对参数，可设置单侧或双侧
  • 排序：orderBy 指定排序字段，orderByType 指定升/降序（默认 DESC 降序）
  • 分页：page 从 1 开始，pageSize 范围 1-1000，默认 1000
  • 排除逻辑：notExistKeyword 可排除包含特定词的商品，notExistShopIdList 可排除特定店铺

常见查询场景

  • 关键词选品：按销量筛选热销商品
  • 新品发现：近期上架且有一定销量的商品
  • 高潜力商品：低价高销量
  • 跨境卖家商品筛选
  • 品类选品：按类目 + 销售额筛选
  • 竞品店铺分析：查看特定店铺的商品
  • 优选商品筛选：虾皮优选 + 高评分
  • 大卖排除：发现中小卖家机会

输出策略

脚本默认行为：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-youying-shopee-get-product-infos-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
  • 加 --inline 强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

认证与算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决：

  • 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY
  • 响应401或402状态码
  • 响应提示算力或余额不足

展示规则

  • 仅展示数据：以清晰表格呈现查询结果，不给出主观业务建议
  • 货币提示：不同站点使用不同货币（MYR、TWD、IDR、THB、PHP、SGD、VND、BRL、MXN、CLP、COP），展示价格/销售额数据时需提醒用户货币背景
  • 数据量提示：结果较多时展示核心数据（标题、价格、销量、销售额、评分），并提醒用户可通过分页查看更多
  • 关键指标突出：优先展示 sold（前30天销量）、payment（前30天销售额）、price、rating
  • 错误处理：查询失败时根据错误响应说明原因并建议调整查询条件
  • 图片展示：有 imageUrl 时展示商品图片

适用场景

  • "虾皮上什么好卖""Shopee爆款"——热销商品发现
  • "帮我在Shopee上搜xx商品"——关键词商品搜索
  • "马来站最近上架的新品"——按上架时间发现新品
  • "销量过千的商品有哪些"——按销量筛选
  • "东南亚哪些品类有机会"——品类级机会扫描
  • "帮我看看这个店铺的商品"——竞品店铺分析
  • "跨境商品和本土商品对比"——跨境与本土对比
  • "Shopee优选商品筛选"——虾皮优选筛选
  • "低价高销量的商品"——价格-销量机会挖掘

限制

  • 结果上限：pageSize 每次请求最多1000条记录
  • 必填字段：station 始终必填——若缺失，需询问用户查询哪个站点
  • 价格货币：价格为所选站点的当地货币，不是美元
  • 数据时效：数据依赖友鹰的抓取计划，可查看 lastModiTime 获取最后更新时间
  • 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带24h本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗
  • 算力消耗：消耗4算力。用户会因算力消耗而支付费用，高频调用或用户对消耗预期不足时需提醒用户，由用户决定是否继续

不适用场景

  • Amazon、TikTok、eBay、1688 等其他平台的商品搜索
  • Shopee 广告投放策略
  • Shopee 店铺运营建议
  • Shopee 物流/仓储方案
  • 已有本地 Shopee 数据文件的处理

边界判断：当用户说"东南亚选品""虾皮市场分析""跨境电商选品"，如果归结为在Shopee上按各种条件搜索和筛选商品，则适用；如果问的是物流规划、广告策略或店铺运营，则不适用。