用途:goofish-cli 是 Python CLI + MCP server + Agent Skills 三合一工具包,让 AI Agent 在 OpenClaw、Claude Code、Cursor 等宿主中操作闲鱼,完成发商品、回消息、查风控、诊断店铺等任务。MCP 工具均来自同一个 goofish server(FastMCP("goofish"))。
主要能力:共 17 个 MCP 工具。发商品涉及 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_install 为辅助工具,一般由用户在终端执行。工具名按宿主补前缀,如 OpenClaw 用 goofish__auth_status,Claude Code / Cursor 用 mcp__goofish__auth_status。
专项 Skill 分工:发布商品用 goofish-publish-item,回复买家消息用 goofish-reply-buyer,发布前风控检查用 goofish-risk-guard,店铺流量诊断用 goofish-shop-diagnosis。发布或回消息前建议先经 goofish-risk-guard 检查,属推荐惯例而非强制。
使用方式:登录态由 auth_status 检查,返回 {valid: bool}。token 与 session 过期可自动刷新,浏览器免密失效时需用户执行 goofish auth login --qr。Agent 不应主动调用 auth_login,仅在 auth_status 返回 invalid 时提示用户手动执行 goofish auth login 或 goofish auth login --qr。写操作前先读 auth_status;item_publish、media_upload、message_send 有速率限制(令牌桶 1 写/分钟),触发 RGV587 后需用户手动执行 goofish auth reset-guard。对外发送前须让用户确认文案,不自动提交。
适用场景:闲鱼商品发布、买家消息回复、风控合规检查、店铺流量与曝光诊断。
限制:禁止协助刷单、虚假交易、伪造物流、批量设备 ID 伪造、绕过滑块验证、规避封号、SaaS 化转售、恶意评价、敲诈话术及外联引流(微信/VX/威信等)。风控概念包括闲气值低于 80 开始限权、新商品 24 小时初始推荐窗口、发布后先降价再改标题触发虚假促销、外联词命中会降权或封号。账号身份细节、MCP 工具详单与风控概念分别见 references/accounts.md、references/mcp-tools-index.md、references/xianyu-concepts.md。