闲鱼命令行工具 — 基于逆向工程的 Goofish CLI。
pip install -e .# 登录（QR码扫码）
xianyu login
# 查看登录状态
xianyu status
# 搜索商品
xianyu search "iPhone 15"
# 查看商品详情
xianyu item detail <item_id>
# 发送消息给卖家（需要 --item-id 创建会话）
xianyu message send <seller_id> "你好，请问还在吗？" --item-id <item_id>
# 群发消息给多个卖家
xianyu message broadcast "请问具体折扣？" --item-ids "id1,id2,id3"
# 查看消息列表
xianyu message list
# 查看聊天记录
xianyu message read <conversation_id>
# 实时监听新消息
xianyu message watch --timeout 180
# 收集指定卖家的回复
xianyu message collect --seller-ids "id1,id2" --timeout 120
# 全自动比价（一条命令搞定）
xianyu agent-flow "深圳外婆家" "具体折扣" --top 10 --timeout 180agent-flow 是一条命令完成从搜索到推荐的完整闭环：
搜索商品 → 信用排序取 Top N → 群发询价 → 收集卖家回复 → AI 分析 → 推荐最优卖家
流程详解：
- 搜索 — 根据关键词搜索闲鱼商品，支持价格筛选（
--min-price/--max-price） - 排序筛选 — 按卖家信用分降序排序，取前 N 个（
--top，默认 10） - 群发询价 — 通过 WebSocket 逐个给卖家发送询价消息，每条间隔随机延迟（
--delay，默认 2 秒，防风控） - 收集回复 — WebSocket 实时监听卖家回复（
--timeout，默认 300 秒），支持自动重连和 HTTP API 补捞漏掉的消息 - AI 分析 — 将所有回复发送给 LLM 分析，综合价格、折扣、信用等因素推荐最优卖家
使用示例：
# 基本用法
xianyu agent-flow "oeat代金券" "请问具体折扣是多少？"
# 指定参数
xianyu agent-flow "星巴克券" "几折？有效期多久？" --top 5 --timeout 120 --min-price 50 --max-price 200
# JSON 输出（适合脚本/Bot 调用）
xianyu -o json agent-flow "深圳外婆家" "具体折扣"LLM 配置（任选其一）：
export ANTHROPIC_API_KEY=sk-ant-... # Claude（推荐）
export OPENAI_API_KEY=sk-... # OpenAI 兼容 API未设置 API Key 时，使用启发式规则（推荐信用最高的回复卖家）。
通过环境变量 XIANYU_PROXY_URL 配置 HTTP 代理。未设置时直接使用服务器本机 IP 连接。
# 在 ~/.bashrc 中添加
export XIANYU_PROXY_URL="http://<username>:<password>@<host>:<port>"
# 示例
export XIANYU_PROXY_URL="http://ap-bxljp7reeghi:fGPS4pETatWR2sZS@222.167.190.131:6022"
# 生效
source ~/.bashrc代理要求：
- 必须支持 HTTPS CONNECT 隧道
- 支持 HTTP Basic Auth 认证
- 建议使用日本/东南亚的住宅代理 IP，降低风控触发率
测试代理是否可用：
curl -x "$XIANYU_PROXY_URL" --connect-timeout 10 -s -o /dev/null -w "%{http_code}" \
"https://h5api.m.goofish.com/h5/mtop.gaia.nodejs.gaia.idle.data.gw.v2.index.get/1.0/"
# 返回 200 = 正常- 认证: QR码登录、浏览器Cookie提取、凭证管理
- 搜索: 关键词搜索、价格筛选、排序
- 商品: 查看详情、管理上下架、擦亮
- 消息: 会话列表、收发消息、发送图片、实时监听（WebSocket）
- 订单: 订单列表、订单详情
- 个人: 资料查看、收藏列表、浏览历史
所有命令支持 --output json / -o json 输出结构化 JSON。
闲鱼（阿里系）有多层风控机制：
| 风控类型 | 触发条件 | 应对方式 |
|---|---|---|
| Token 过期 | _m_h5_tk 过期（几小时） |
自动刷新，无需手动处理 |
| 频率限制（RGV587） | 短时间大量请求、IP 异常 | 群发消息自动加随机延迟 |
| Cookie 漂移 | 换代理后 cookie 与 IP 不匹配 | 代码已冻结登录 cookie，不随响应更新 |
| 滑块验证 | 异地 IP、频繁登录 | 浏览器完成验证后用 --cookie-source chrome 登录 |
| WebSocket 断连 | 长连接超时、网络波动 | 自动重连（最多 3 次）+ HTTP API 补捞消息 |