关键词一拉市场数据：SellerSprite 选品技能使用指南
六条命令把卖家精灵市场数据接进 AI 助手：market/product/competitor/asin/keyword/quota 各管什么、bun 运行时与密钥配置、蓝海指数怎么看，以及把 CLI 版本锁住的安全建议。
本文目录 · 10 节
关键词一拉市场数据：SellerSprite 选品技能使用指南
"这个词还能不能做？"——装上 SellerSprite 选品技能后，你在 agent 对话框里问这句话，它会拉卖家精灵的市场数据、算蓝海指数，直接给你一个有数字支撑的答案。
实测：技能触发与 Key 检查
本机在 Claude Code 里真实触发过一次（截图为真实会话捕获）：agent 读技能说明后检查 SELLERSPRITE_SECRET_KEY，未配置时如实提示。
在 WorkBuddy 图形界面里实测（2026-09-16）
WorkBuddy 是腾讯出品的图形界面版 AI 助手（和 Claude Code 一样属于"能装技能的那个软件"，不用敲命令行）。把技能包装进它的技能目录后，新建任务、照上面的模板说一句话，它会真实加载技能、跑检查脚本，把"缺什么"说清楚。下面是本机实测（28 秒，消耗 0.76 积分）：
它检查后如实汇报：
- 已就绪：接口路径确认：POST /v1/keyword-research（美国站 marketplace: US，返回月搜索量、购买转化率、关键词均价、供需比）；本机没装 bun 也不是问题，用 Python 直接带 secret-key 请求头就能调
- 阻断项：环境变量 SELLERSPRITE_SECRET_KEY 未配置（唯一阻断项）
- 它给出的下一步：到 SellerSprite 开放平台获取 Secret Key 发给 agent；拿到后它先调 GET /v1/visits 查配额验证凭证，再查词并整理竞争度小结
看图要点：回复底部有"已完成"耗时与积分消耗（模型 GLM-5.3-Flash）；因为没配 Key，agent 没有编造数据，而是按技能规范停下来向用户要 Key——装对了技能就该是这个表现。
装好后，你可以这样开口
进场判断：
用卖家精灵查 "yoga mat" 美国站本月的市场数据：搜索量、竞争度、头部集中度，再查这个词的蓝海指数，最后回答我这个类目适不适合小卖家进场，说理由。
竞品对比：
用卖家精灵查这个 ASIN 的竞品列表，对比它们的销量、价格和评分分布。
关键词筛选：
用卖家精灵做关键词研究：以 "dog toy" 为种子词，列出蓝海指数最高的 10 个长尾词，做成表格。
agent 会怎么回应（官方文档口径）
按技能说明书，agent 会拼出对应的 CLI 命令（比如 bunx @teamclaw/sellersprite-cli product --keyword "yoga mat"）→ 执行并拿回数据 → 按你的要求整理成表格和结论。六条命令分别管：市场调研（market）、关键词选品（product）、竞品查询（competitor）、ASIN 详情加优惠券趋势（asin）、关键词研究（keyword）、配额查询（quota）。默认美国站，可切站点和历史月份。
第一次跑通前要准备什么
- 装技能：
npx clawhub@latest install @boyd4y/sellersprite-api，或用本站固定版本包（见文末，附三份 API 参考文档）。 - 装 bun 运行时：命令靠 bunx 执行，没装的话先装 bun（bun.sh 官网，纯文本地址复制到浏览器打开）。
- 配 Key：在 open.sellersprite.com（纯文本地址复制到浏览器打开）开通 Open API，设环境变量
SELLERSPRITE_SECRET_KEY。 - 费用预期：按卖家精灵 API 配额计费。开口第一句可以先问："用卖家精灵查一下我的配额还剩多少"（quota 命令），心里有数再查大的。
出问题怎么办
- 报 bun 不存在：先装 bun——官网 bun.sh 有 macOS 一条命令安装说明（纯文本地址，复制到浏览器打开后按官网最新指引执行）。
- 报配额不足/未授权：回 open.sellersprite.com 检查 API 开通状态和配额包。
- 数字和你体感差很多：所有选品工具都是估算模型口径，方向性可靠、精确值以平台后台为准；换个月份再看趋势线。
安全注意
注册表扫描提示这条 CLI 没锁版本（每次 bunx 拉当时版本）。第一次跑通后让 agent 告诉你实际用的版本号并记下来，之后锁定版本执行更稳。密钥只走环境变量。
怎么算成功
quota 查得到余量、关键词能拉出带搜索量和蓝海指数的表格，就是通了。第一次用一个你熟悉的类目验证数字合理性，再扩到陌生类目。
配对资源
固定版本 v1.0.0 完整包（含中文说明与三份 API 参考）点此打开本站资源页：SellerSprite 选品研究技能（免费下载）。
文字来源：开工科技原创教程。命令与参数事实依据 sellersprite-api v1.0.0 包内 SKILL.md（SHA256 核对一致）转述；三份 references API 规格文档随包。 技能事实依据包内 SKILL.md 固定版本转述；实测截图为本机 WorkBuddy 与 Claude Code 真实会话捕获。