---
name: goofish-overview
description: |
  闲鱼（goofish.com）自动化运营的总入口 skill。何时激活：用户首次提到
  闲鱼 / 咸鱼 / goofish / 二手交易 / 挂闲置 / 回买家消息 / 发商品到闲鱼，
  或用户询问本工具如何使用、有哪些能力、能做什么。本 skill 介绍 goofish-cli
  的定位、账号模型、17 个 MCP 工具速查、风控底线，并指向其它专项 skill
  （goofish-publish-item / goofish-reply-buyer / goofish-risk-guard /
  goofish-shop-diagnosis）。
metadata:
  author: goofish-cli
  version: "0.3.0"
  tags: [xianyu, goofish, overview, index]
---

# goofish-cli 总览

## 这是什么

`goofish-cli` 是一个 **Python CLI + MCP server + Agent Skills** 三合一工具包，
让 AI Agent 能像熟练卖家一样操作闲鱼：发商品、回消息、查风控、诊断店铺。

你（Agent）在 OpenClaw / Claude Code / Cursor 里通过 MCP 看到的工具，都来自同一个
`goofish` server（`FastMCP("goofish")`）。

## 工具命名

本文使用 registry 里的逻辑名（例如 `auth_status`）。实际调用时按宿主补前缀：

- OpenClaw：`goofish__auth_status`
- Claude Code / Cursor：`mcp__goofish__auth_status`

## 四个专项 Skill 的分工

遇到具体任务时，**优先跳到对应专项 skill**，不要在本 overview 里硬推断：

| 用户说 | 激活的 skill |
|---|---|
| "帮我发布 / 上架 / 挂闲置" | `goofish-publish-item` |
| "回复买家消息 / 看未读 / 议价" | `goofish-reply-buyer` |
| "发布前检查 / 这话能说吗 / 风控 / 被限流怎么办" | `goofish-risk-guard` |
| "我店铺怎么没流量 / 为什么曝光掉 / 诊断一下" | `goofish-shop-diagnosis` |

跨 skill 协作：**发布 / 回消息前都应该先让 `goofish-risk-guard` 过一遍**
（避免绝对化词、外联词）。这是个推荐 convention，不是硬强制。

## 账号与登录态

- 登录态由 `auth_status` 检查，返回 `{valid: bool}`。
- 自动刷新链路已内置（v0.2.2 - v0.2.4）：token 过期自动续、session 过期
  自动点 passport "快速进入"、浏览器免密失效需用户 `goofish auth login --qr`。
- **Agent 不应主动调 `auth_login`**，这是敏感命令（会覆盖磁盘 cookie）。
  只在 `auth_status` 返回 invalid 时提示用户手动 `goofish auth login` 或
  `goofish auth login --qr`。
- 账号身份细节见 `references/accounts.md`。

## 17 个 MCP 工具速查

详单在 `references/mcp-tools-index.md`。读不读看任务：
- 发商品 → 只需 `category_recommend / media_upload / location_default / item_publish`
- 回消息 → 只需 `message_watch / message_list_chats / message_history / message_send`
- 诊断 → 只需 `search_items / item_view / item_get`
- 登录态诊断 → `auth_status`
- 下架/删除 → `item_delete`
- skills 安装 → `skills_install`（辅助类工具，一般 Agent 不会直接调；由用户在终端跑）

例如 CLI 的 `message list-chats` 对应逻辑名 `message_list_chats`，调用时使用上面的宿主前缀。

## 合规硬红线（本工具禁止协助）

**以下行为写在合规声明里且 skills 拒绝指导**：
- 刷单 / 虚假交易 / 伪造物流
- 批量设备 ID 伪造 / 绕过滑块验证 / 规避封号
- 针对闲鱼平台的 SaaS 化转售
- 恶意评价 / 敲诈话术 / 外联引流（微信/VX/威信/V 信等）

若用户请求明显违反上述任一条，**拒绝执行并解释原因**，不要寻找绕过路径。

## 风控基础概念

详见 `references/xianyu-concepts.md`，这里只给 Agent 一个思维锚：

- **闲气值**：卖家信用分，< 80 开始限权（搜索曝光 -50% 起步）。
- **流量池**：每件新商品有 24 小时初始推荐窗口，错过不再有。
- **降价改标**：发布后先降价再改标题会触发"虚假促销"，流量腰斩。
- **外联词**：微信 / 威信 / V信 / VX / +我 都命中，轻则降权重则封号。

## 工作流惯例

Agent 在 goofish 任务里请遵守：

1. **任何写操作前先读 `auth_status`**，避免 token 已过期却继续写 → 白忙一场。
2. **`item_publish / media_upload / message_send` 都有速率限制**（账号业务预算），不要短时间连发。RGV587 触发后需用户手动 `goofish auth reset-guard`。
3. **所有对外发送（发商品、发消息）务必让用户先确认文案**，不要自动提交。
4. **多步任务中途报状态**：上一步完成了什么、下一步准备做什么。闲鱼任务
   通常是 3-6 步，用户期望有进度感。