fancyboi999/goofish-cli

闲鱼 CLI · 原生支持 MCP · 为 AI Agent 而生 | Goofish (Xianyu) automation CLI · MCP-ready · Built for AI Agents

它是什么

goofish-cli 是一个 Python 命令行工具，封装了中国二手市场闲鱼（也称为 Goofish）的核心操作。它允许人类或 AI 代理（Claude Code、Cursor、OpenClaw 等）以编程方式发布商品、管理列表、发送和接收消息以及查询平台——全部通过一套结构化的命令集实现。

为什么对 AI 代理很重要

该工具采用 AI 优先设计：

每个命令都可以输出机器可读格式（json、yaml、csv、md、table）。
它注册为 MCP（模型上下文协议）服务器，因此代理可以将命令作为“工具”调用（例如 goofish_item_get）。
附带五个 Claude 技能，使基于 Claude 的代理能够自动加载领域特定知识（发布、回复、风险防护、店铺诊断、概览），而无需依赖零样本提示。
OpenClaw 可以将该仓库作为兼容插件包加载，向其代理框架暴露相同的命令。

核心功能（17 个命令）

领域	示例命令	功能
认证	`goofish auth login <cookies.json>`	导入浏览器 cookie 文件以创建会话；`auth status` 检查有效性。
商品	`goofish item get <id>`	获取商品详情。`goofish item publish …`
媒体	`goofish media upload <file>`	上传图片到闲鱼 CDN。
分类	`goofish category recommend <title>`	AI 辅助分类推荐。
位置	`goofish location default`	获取默认收货地址。
消息	`goofish message list-chats`、`goofish message send …`、`goofish message watch`	列出聊天、发送文本/图片，并保持三种事件类型（`message`、`read`、`new_msg`）的实时 WebSocket 流。
搜索与查看	`goofish search items …`、`goofish item view …`	浏览器自动化搜索（Playwright）和绕过反垃圾限制的全字段“查看”模式。
技能	`goofish skills install`	将五个 Claude 技能包安装到 `~/.claude/skills/`。

安全与合规

速率限制 – 每个账户上限（1 次发布/分钟，9 次媒体上传/分钟）和自动断路器（RGV587）。
风险防护 – 内置违禁词、外部链接和其他平台特定红线检查。
合规声明 – README 强调该工具仅用于个人账户自动化；不得用于欺诈、批量销售 SaaS 或规避闲鱼用户协议。

快速开始（60 秒）

pip install goofish-cli            # 或：uv pip install goofish-cli
# 从 Chrome DevTools → Application → Cookies 导出您的闲鱼 cookies
goofish auth login ~/Downloads/goofish-cookies.json
goofish auth status                # 确认登录有效
# 示例操作
goofish item get 1045171414271
goofish message watch             # 实时 IM 流
goofish message send <cid> <toid> --text "在的"

所有命令都接受 --format json|yaml|table|md|csv 以便于下游解析。

Claude Code 集成步骤（MCP）

安装工具（如上）。

在 ~/.config/claude-code/config.json 中添加条目：

{"mcpServers": {"goofish": {"command": "uvx", "args": ["goofish-cli"]}}}

Claude 现在将暴露诸如 goofish_item_publish 之类的函数，您可以在对话中直接调用。

OpenClaw / ClawHub 使用

openclaw plugins install clawhub:openclaw-goofish
# 可选：通过二维码登录
uvx --from goofish-cli==0.5.3 goofish auth login --qr
openclaw plugins inspect goofish --json
openclaw gateway restart

插件包提供相同的 MCP 工具以及五个 Claude 技能。

开发与测试

使用 uv 进行环境管理（uv venv --python 3.11）。
33 个单元测试（pytest）和静态分析使用 ruff（零警告）。
贡献指南和架构文档位于仓库中。

许可证

Apache 2.0——免费用于个人和商业用途，需遵守通常的署名要求。

底线： goofish-cli 是一个功能齐全、基于 Python 的闲鱼自动化层，专为现代 AI 代理通过 MCP 和 Claude 技能消费而设计，同时提供用户友好的 CLI 和安全机制。