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