---
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 的核心知识源