纳富通甄选选品

概述

[!IMPORTANT]

本 Skill 必须依赖本站 SellerSprite MCP（连接名 aiploutos-credit-mcp，提供 sellersprite_get_credits、sellersprite_start_selection 与 sellersprite_finish_selection 三个工具）。如当前会话完全没有 sellersprite_* 工具，立即停止取数并明确通知用户（逐字原样输出以下步骤，通知不得替换为其它诊断、启动建议或改配置提议；不要代用户改 MCP 配置或自行注册连接，除非用户明确要求）：

请先启用 SellerSprite MCP：

• 在 WorkBuddy 左侧找到 「专家·技能·连接器」 → 「连接器」；
• 在连接器面板中找到 aiploutos-credit-mcp 并启用/连接——它可能是连接器市场里的「纳富通甄选积分」连接器，也可能是自定义 MCP 条目（配置在 ~/.workbuddy/mcp.json）；Qoder 等客户端的入口是 MCP 面板；
• 若连接报 fetch failed 等不可达错误：指向本地（http://127.0.0.1:8128/mcp）的条目是本地后端没启动，先在 sellersprite 仓库以 SPRING_PROFILES_ACTIVE=streamable 启动本地 MCP 再启用；指向生产端点（https://www.aiploutos.com/mcp）的条目是生产服务不可达，通知用户稍后重试；
• 首次连接按提示完成 OAuth 登录与只读授权（站点账号登录、站点账号绑定）；
• 返回 WorkBuddy 重试。

MCP 缺失即停止：禁止 HTTP 直连 fallback、禁止索取密钥、禁止用模型记忆编造数据。

本站 MCP 只做授权与计费，不提供任何卖家精灵数据工具。如果 sellersprite_* 工具在、但当前会话没有任何裸名数据工具（如 product_research、keyword_research），同样立即停止取数，通知用户启用卖家精灵官方 MCP 连接 sellersprite-mcp（其密钥由该连接自行管理，本 Skill 不索取、不代填），然后返回重试。

目标

根据用户的 Amazon 站点、ASIN、关键词、类目和筛选条件，调用卖家精灵官方 MCP 的只读工具取得数据，再给出可追溯的分析。授权状态与积分余额通过本站 MCP 查询：一次选品开始时用 sellersprite_start_selection 过门禁并取得单据号，交付结论前用 sellersprite_finish_selection 结算一次，全程不需要任何本地凭证、脚本或环境变量。

两个 MCP 互相独立、职责不重叠：

• 卖家精灵官方 MCP（取数）：提供 asin_detail、product_research、keyword_research、market_research 等裸名只读工具，鉴权与上游额度都由卖家精灵自己管理。其密钥由该连接配置持有，本 Skill 不索取、不展示、不配置，也不得要求用户把它填进任何地方。
• 本站 MCP（授权与计费）：只提供 sellersprite_get_credits、sellersprite_start_selection、sellersprite_finish_selection 三个工具，负责 MCP 登录授权、站点账号绑定、积分余额查询与按选品结算。它不持有卖家精灵密钥，也无法查询任何卖家精灵数据。

根据当前环境实际可用的工具调整：

• 两个 MCP 都可用（正常形态）：官方工具取数，本站工具负责授权、余额与结算。
• 只有本站 sellersprite_* 工具：本站没有任何数据工具，因此无法取数。停止查询，向用户说明卖家精灵官方 MCP 未启用/未授权，引导其在「连接器」中启用 sellersprite-mcp 后重试；不得以模型记忆补数据，也不得声称已完成查询。
• 没有本站 sellersprite_* 工具：积分、授权与结算都无法完成。此时禁止调用任何数据工具，向用户说明本站 MCP 未连接/未授权，按文首 IMPORTANT 块引导启用 aiploutos-credit-mcp；不得以「官方工具自带额度」为由绕过。本站连接器尚未上架市场，禁止把引导写成"搜索并安装卖家精灵连接器"。

不声称已经查询 SellerSprite，不用模型记忆填充数据。全程不得向用户索取、展示或记录任何 API Key、令牌或密码，也不要要求用户配置环境变量或运行脚本；授权失效时请用户重新完成授权，不得改为让用户粘贴密钥。

积分与计费

计费单位是选品：一次用户请求 = 一次扣费。该次请求里的所有官方取数（无论几次、几个工具、多少轮澄清追问与补图）都算在这一笔里，不再额外计费。一次选品所需积分由 sellersprite_get_credits 返回的 creditsPerSelection 给出（该查询工具本身免费）。

• 开始一次选品：参数齐备、准备调第一个官方数据工具之前调用一次 sellersprite_start_selection（无需参数）。它校验授权与余额，并返回本次选品的 selectionId：
  • 返回 reused=true：上一次选品尚未结算，直接用返回的 selectionId 继续，不要重复开始。
  • 返回的 previousSettlement.settled=true：说明上一次没有收尾的选品（例如用户中途暂停、断线）已被服务端补扣一次积分——如实告知用户这笔费用对应上一次未完成的选品，不要把它说成本次请求的费用。
  • 不要因为取数轮次多、工具多就重复调用开始工具；一次用户请求只需一次。
  • 返回的 message 提示暂时读不到余额时，可以继续取数：收尾结算会再校验一次余额。
  • 被 SITE_LOGIN_REQUIRED 或 ORDER_REQUIRED 拦下时，按下面的分支表处理并停止取数。
• 澄清往返（缺站点、缺 ASIN 之类的追问）放在开始之前：不要为只做了澄清、还没取数的请求开始选品。
• 收尾结算：把最终结论交付给用户之前，用同一个 selectionId 调用一次 sellersprite_finish_selection，扣一次 creditsPerSelection。一次选品只调用一次；同一个 selectionId 重复调用不会重复扣费（返回 alreadySettled=true）。
• 中间的每一轮取数都不要调用结算工具，也不要逐次结算：取数与交互本身不计费。中途汇报进度、先给一张图，都不算交付结论，也不要提前结算。
• 只有尚未取数就被拦下（未授权、余额不足、缺参数无法继续）时才不结算；已经完成取数与分析、无论结论是推荐还是数据不足，都要在交付结论前结算。
• 用户在中途手动暂停、或客户端断开时，你不会有机会结算——不需要做任何补救：服务端会在下一次开始选品时用同一个单据补扣一次，也绝不会因此多扣。若用户回来后仍要结论，按新需求正常开始一次选品即可。
• 返回 settled=false：如实说明本次选品未完成结算、未扣费，不要重复调用结算工具，也不要说成已扣费，更不要另开一笔选品重试。
• 交付结论时说明本次结算结果（credits 与 balance）；alreadySettled=true 时说明此前已结算、未重复扣费。

门禁（硬前置，任何数据工具调用之前都必须先过）：调用一次 sellersprite_start_selection，以下三种结果都要求停止取数：

• 工具不存在或调用失败：停止，不调用任何数据工具，说明本站 MCP 未连接/未授权及处理办法。
• 被 SITE_LOGIN_REQUIRED 拦下：原样输出错误 JSON 里的 actionLink（actionUrl 同值），停止取数，请用户登录卖家精灵账号并授权后再查询。（用 sellersprite_get_credits 查余额时返回 authorized=false，处理方式相同，用它的 authorizeUrl。）
• 被 ORDER_REQUIRED 拦下（余额低于 creditsPerSelection）：说明余额不足，并把 actionLink（或查余额返回的 rechargeUrl）原样渲染成链接（站点积分下单付费页，不得自行拼地址），停止取数，等用户完成付费后再继续。

sellersprite_get_credits 只在用户单独问余额或核对单价时用，不是选品流程的一步：开始选品的返回里已经带了余额与 creditsPerSelection，不要为了「先看看余额」再调一次（多一次调用就是多一轮上下文重发）。它也不替代开始工具；余额以本次查询结果为准，不根据历史对话推断。

工具被计费条件拦下时，错误信息是一段 JSON，含 errorType、actionLink、userHint、nextAction；积分不足时还含 requiredCredits 和 currentBalance：

要求：必须原样渲染 actionLink、authorizeUrl 与余额不足时返回的 rechargeUrl，不得自行拼登录或充值地址（登录链接里带 app_id 与 state，自造会丢失防 CSRF 的随机数）；不得用索取 SellerSprite API Key 代替登录或充值；充值完成后重新发起查询，未拿到数据前如实报告。

澄清追问：一律走卡片，不要文字提问

需要用户补充会改变查询的参数时，必须调用结构化提问卡片工具 ask_user_question（WorkBuddy 与 DSH 都是这个名字，别名 AskUserQuestion；某客户端若工具名不同，就用它的等价提问卡片工具），把候选项做成卡片让用户点选。禁止只在回复正文里写一段「请问要跑哪个站点？」「重点放哪块？」的文字提问——只要会话里有 ask_user_question，这类追问就必须走卡片。

• 一次调用把要问的问题一起放进 questions（客户端会渲染成 1/2、2/2 分页卡片）；用户可点选项、可用「其他补充…」填自定义内容，也可「跳过」。
• 卡片追问属于澄清，发生在 sellersprite_start_selection 之前，不计费；也不要为只做澄清、还没取数的请求开始选品。
• 选项标签保持短：label 用下面的固定文案，解释放进 description，不要把整段分析塞进标签。
• 用户点选即视为参数已确定，直接继续。「其他补充…」按用户填写的内容执行。
• 用户「跳过」时的兜底：站点题——能从上下文推断就用推断值并在正文写明这是假设，推断不出就如实说明缺少站点、不猜站点、不开始取数（停在澄清）；分析重点题——采用推荐项「类目市场结构」。

下面两处是固定卡片，问题文案与选项顺序照抄（<类目> 换成用户给的类目或关键词）：

1. Amazon 站点（用户没给站点、也无法从上下文推断时才问）
   • 问题：这次<类目>类目分析要跑哪个 Amazon 站点?
   • 选项：美国站 US、日本站 JP、英国站 UK、德国站 DE
   • FR/IT/ES/CA/IN 不单独占位，走「其他补充…」；不预设、不默认美国站。
2. 分析重点
   • 问题：分析重点想放在哪一块?
   • 选项：类目市场结构（推荐）、市场结构 + 关键词机会、只看头部竞品

两个问题可以在同一次 ask_user_question 调用里一起发；同一问题只用卡片问一次，不再用文字重复。只有客户端确实没有提问卡片工具时，才退回文字提问，且必须把同样的选项逐条列出、请用户直接回复编号。

取数：最小集优先

数据取数只使用卖家精灵官方 MCP 的裸名工具。默认取数集（类目/市场分析，≤6 次）：

• market_research 必须显式传 size=1：它的响应是分页明细，默认 size=50 会把 50 条 × 100 多个字段（含 top10Images 图片列表）塞进上下文，而结论要用的聚合字段（totalProducts、brands、sellers、top3/5/10/20*、l1/l3/l6/l12New*、returnRatio、ebcProportion、avgVolume 等）单条就全部带齐。注意它用的是 topNum，不是兄弟工具的 topN。
• 按需追加（先说明为什么要，再调）：market_research_statistics（只需要 hl*、newProducts、firstShelfDate 这类聚合时）、market_ebc_distribution、market_listing_date_distribution、评论、流量、关键词、商标。各域可用工具清单见 references/indicators.md。
• 默认取数集可以在同一轮里并行发出：参数要逐个工具分别组装（见下一条），但这几次调用不必一轮一个——一轮一个会把同一份上下文重复发送多次，纯属浪费。
• 硬预算：单次选品默认不超过 8 次数据工具调用；超出要在正文说明理由。
• 逐个工具组装参数，不要把同一个 request 对象并发喂给多个工具：兄弟工具的筛选字段不通用（例如 market_product_demand_trend 只接受 marketplace、nodeIdPath、month、topN）。字段一旦不被该工具接受，上游不会报错，而是返回 code=OK 却把 data 填成空壳（关键指标为 null、items: []）。
• 遇到「调用成功但关键字段全空」：先用最小参数集重试一次（收敛到 marketplace + nodeIdPath，需要历史月份时再加 month，去掉 topN、newProduct 等全部筛选字段）再判定空结果。没有做过这次重试，不得宣称工具无数据、不得据此跳图。
• 大多数查询需要 Amazon 站点，当前支持 US、JP、UK、DE、FR、IT、ES、CA、IN；用户未提供站点且无法从上下文确定时，按「澄清追问：一律走卡片」发站点卡片，不默认为美国站。单 ASIN 查询必须使用合法的 10 位 ASIN。
• 保留返回数据中的站点、时间范围、货币、单位和分页范围；月份、分页、排序、类目节点与筛选字段严格遵循所选工具的参数定义，不确定字段含义时减少筛选条件或向用户确认，不猜测枚举值。

证据约束

• 所有具体数值必须来自本次 SellerSprite 工具返回结果或可复算的确定性计算；计算指标时说明公式、样本范围或比较口径。
• 数据不足时直接说明证据不足；不得虚构搜索量、销量、销售额、转化率、广告预算、ACOS、ROI、评论内容或市场份额。
• 不把不同站点、不同月份或不同货币的数据直接合并比较；SellerSprite 返回空结果时如实报告，不将空结果解释为零。
• 销量、销额、毛利率是卖家精灵模型估算值：在表格里给这类字段加 *，并在表下注明「* 为卖家精灵模型估算值，非实测」，不得当成精确值呈现。
• 工具失败时保留关键错误信息，不生成替代性的虚假结果。官方工具返回 secret_expired、secret_unauthorized、secret_invalid 或 secret_no_remaining 时，说明该连接的卖家精灵密钥失效或额度用尽，请用户到卖家精灵官方 MCP 连接处自行处理——不要让用户误判成自己的站点积分不足而去充值；本 Skill 不索取、不代填密钥。

工作流程

1. 判断问题属于商品、竞品、ASIN、关键词、流量、市场、评论还是商标。
2. 检查站点、ASIN、关键词、类目和时间条件，只补问会改变查询的缺失参数——追问一律走 ask_user_question 卡片（站点与分析重点见「澄清追问：一律走卡片」），澄清往返放在开始选品之前。
3. 过门禁并开始选品：调用一次 sellersprite_start_selection，确认已授权且余额够用并取得 selectionId；无法调用、未授权或余额不足时停止取数。
4. 按「取数：最小集优先」调用官方工具；需要组合分析时先取得基础结果，再按问题补充趋势、流量、评论或市场分布数据。
5. 计算与分析：派生指标一律按 references/indicators.md 的口径。
6. 交付：正文与单文件 HTML 归档件按 references/delivery.md 组织；要出市场结构图时按 references/charts.md。
7. 收尾结算：把最终结论交付给用户之前，用同一个 selectionId 调用一次 sellersprite_finish_selection。
8. 将原始事实、确定性计算和分析判断分开；给出结论、依据、限制和可执行的下一步。

按需加载（不要一次性全读，按需取用）