虾多拉 Shopee 选品与关键词分析

解决的数据痛点

在 Shopee 等跨境电商平台进行选品和市场调研时，运营团队常面临数据高度分散、手动抓取易触发风控、以及缺乏深度结构化分析等问题。虾多拉 将底层的 Shopdora OpenAPI 封装为标准化的 Agent Skill，让开发者和运营人员可以直接通过自然语言获取各站点的关键词热度、商品销量与竞品评论数据，无需再编写繁琐的爬虫脚本或手动拼接散乱的 Excel 表格。

技能如何工作

该技能的核心能力覆盖 关键词挖掘、选品分析、评论抓取 与 类目浏览 四大场景。
在执行逻辑上，它遵循严格的计费保护工作流：

• 凭证与鉴权：首次使用需在 ~/.shopdora/config.json 中配置 clientId 和 clientSecret，技能会自动管理 access_token 的获取与 31 天的续期。
• 本地缓存机制：所有成功响应会按 MD5 规则存入 ~/.shopdora/cache/，24 小时内的相同请求直接读取缓存，不扣除配额。
• 调用前确认：触发计费接口前，Agent 会主动向用户确认站点、关键词、时间范围等关键参数，避免参数错误导致的无效消耗。
• 字段级格式化：自动处理 API 返回的缩放值，如将 price 除以 100000 还原为本土货币，将 ratingScore 除以 10 转换为标准星级。

适用边界与注意点

使用该技能前，务必了解其计费与数据特性：

• 付费服务：关键词、选品和评论接口均为按次计费（成功返回非空数据即扣 1 次配额），类目浏览和余额查询不扣费。
• 禁止自动重试：当接口返回失败或空结果时，技能严禁自动修改参数、更换关键词或盲目翻页。只有在 9990 (Token 失效) 时才会自动刷新重试。
• 非实时数据：关键词和销量数据依赖平台的刷新周期，并非毫秒级实时更新，适合用于趋势分析而非瞬时监控。