goofish-shop-diagnosis

name	goofish-shop-diagnosis
description	闲鱼店铺 / 商品诊断 skill。何时激活：用户说"我店铺没流量 / 曝光掉了 / 怎么没人问 / 是不是被限流 / 帮我看看为啥没单 / 哪里出问题了"。功能： 用 `search_items` 做"买家视角"查自家商品是否露出 → `item_view` 拉详情 对比排查 → 按归因清单给出"限流可能性 + 修复建议"。**本 skill 纯读， 不做任何写操作**——只诊断不修，修留给 `goofish-publish-item`。
metadata	{"author":"goofish-cli","version":"0.3.0","tags":["xianyu","diagnosis","traffic","rank"]}
allowed-tools	["mcp__goofish__auth_status","mcp__goofish__search_items","mcp__goofish__item_view","mcp__goofish__item_get"]

闲鱼店铺诊断

工具命名

正文使用 auth_status 这类逻辑名。OpenClaw 调 goofish__<逻辑名>； Claude Code / Cursor 调 mcp__goofish__<逻辑名>。frontmatter 的 allowed-tools 保留 Claude 权限预批准格式，OpenClaw 不读取该字段。

定位

纯读 skill——诊断、不修。要修的话跳到 goofish-publish-item。

这是三方工具（闲管家、鱼小铺）没做的一块——它们专注自动化，诊断全靠人看后台。本 skill 的差异化就是"像 SRE 做事后分析一样归因"。

触发姿势

• "我发了一个星期了没人问"
• "之前还有曝光最近突然没了"
• "同类商品我朋友卖得好我怎么没动静"
• "是不是被限流了"

诊断三步法

Step 1 · 买家视角搜索自检

search_items(
    keyword="<商品核心词>",  # 从用户描述或 item 标题提取
    # 可以按地理/价格 filter 更精准
)

目的：用卖家视角（登录态）搜和买家一样的关键词，看自家商品是否在前 3 页。

结果判断：

情况	含义
商品出现在前 20 条	权重正常，不是限流
商品在 50-100 条	权重偏低，可能标题/类目不够优
完全搜不到（翻 3 页+ 都没有）	强信号：搜索降权
用"商品 id"搜能出来，用"关键词"搜不出来	和上面一样，搜索降权

Step 2 · 拉自家商品详情

item_view(item_id=<问题商品>)

对比：

• 当前挂价 vs 历史价（是否降过价）
• 当前标题 vs 历史标题（是否改过）
• 当前类目 vs 该品类热销商品的类目（API 搜出来的前 5 条商品的类目）
• 图片数量 / 首图尺寸
• 描述长度

Step 3 · 按归因清单过一遍

详见 references/traffic-drop-causes.md。

Agent 读 item_view 数据 → 在清单里逐项打分 → 找出最可能的原因。

归因输出格式

【诊断对象】商品标题 (id=xxxxx)
【当前状态】挂价 XXX，发布 N 天，累计曝光 M

【搜索可见性】
- 核心词 "XX" 搜索：❌ 前 3 页找不到
- 商品 id 搜索：✅ 能找到

【嫌疑归因】
1. 【高可能性】 ⚠️ 降价改标
   - 证据：发布后 3 天内改过 2 次价格 + 1 次标题
   - 说明：触发"虚假促销"规则，搜索权重 -50%
   - 修复：等 7 天让权重恢复；期间不要继续改

2. 【中可能性】 类目偏差
   - 证据：类目是"数码-手机"，同品实际类目为"数码-手机配件"
   - 说明：类目错放降权 -30%
   - 修复：重新按 category_recommend 选类目（但要接受一次重新审核）

3. 【低可能性】 图片问题
   - 证据：首图 1200x900（非 1:1）
   - 说明：首图非 1:1 曝光打折
   - 修复：换 1:1 首图

【建议操作】
1. 优先处理降价改标 → 等 7 天观察
2. 7 天后仍无起色 → 按原类目重发（删除旧商品重发新的）
3. 同时换首图

什么算"诊断有效"

• 给出的不是"你被限流了"，而是具体哪条规则 + 哪条证据
• 给出的不是"再等等看"，而是明确下一步操作
• 错了也没关系——承认"这是经验规则，不一定 100%"

反模式（别做的）

❌ 鼓励刷数据（刷流量/刷收藏/刷评论 → 风控秒杀，账号完蛋） ❌ 建议频繁改标题/改价（改动本身就是降权源） ❌ 建议删掉重发（除非有明确理由；频繁删发 = 职业卖家嫌疑） ❌ 建议用多个账号互相收藏（同 IP 关联，饱和式封号素材）

超出本 skill 能力的

这些诊断不要硬做，建议用户去 App 后台看：

• 具体曝光时间分布曲线（CLI 当前无接口）
• 点击率、收藏率、咨询率详细数据（同上）
• 鱼塘权重 / 擦亮历史（同上）

说清楚："这部分数据 CLI 看不到，你可以去 App 的'卖家中心' → '数据参谋'看"

数据源限制

goofish-cli v0.2.4 是无状态的——它不记你昨天的曝光是多少。所以：

• "和昨天相比"的对比类诊断做不到
• 只能基于当前状态 + 已知规则推断

未来版本（Roadmap）加历史落盘后，这个 skill 可以做时序归因。

相关 skill

• goofish-publish-item — 诊断完确定要改 → 改进发布
• goofish-risk-guard — publish-red-lines.md 是本 skill 的核心知识源