goofish-overview

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 都有速率限制（令牌桶 1 写/分钟），不要短时间连发。RGV587 触发后需用户手动 goofish auth reset-guard。
3. 所有对外发送（发商品、发消息）务必让用户先确认文案，不要自动提交。
4. 多步任务中途报状态：上一步完成了什么、下一步准备做什么。闲鱼任务 通常是 3-6 步，用户期望有进度感。