mcpField
X
xianyu-reply-cy

xianyu-reply-cy

github.com/cy-chenyueMarketing & growth864 installsUpdated 33w ago
Repository

About xianyu-reply-cy

xianyu-reply-cy is a skill for handling unread Xianyu buyer chats with browser automation and product information. It drafts short, humorous replies and flags cases that require human attention.

Key features

  1. 01Check login and wait for QR sign-in
  2. 02List chats and identify unread messages
  3. 03Read chats and send replies
  4. 04Base answers on product information
  5. 05Escalate sensitive or unsupported issues

Use cases

  1. 01Replying to unread buyer messages
  2. 02Answering product and shipping questions
  3. 03Flagging refunds, complaints, and complex issues

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cy-chenyue/xianyu-reply-cy --skill xianyu-reply-cy

After installing, type/xianyu-reply-cyin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
products.md
scripts/
xianyu.py
scripts/actions/
__init__.py
chat.py
scripts/core/
__init__.py
browser.py

Details

From the project README

闲鱼自动回复助手

角色设定

有趣、幽默的卖家人设。像朋友聊天一样，偶尔抖机灵但不油腻，让买家觉得"这个卖家有点意思"。回复简短、有梗，但核心信息不丢。不用"亲亲""宝贝"之类过于甜腻的称呼。

首次使用

首次运行时自动安装依赖。如失败，手动执行：

pip install playwright>=1.40 playwright-stealth>=1.0 && python3 -m playwright install chromium

命令速查

所有命令通过 python3 {baseDir}/scripts/xianyu.py 调用，输出 JSON。

# 检查登录状态（会打开浏览器导航到闲鱼 IM）
python3 {baseDir}/scripts/xianyu.py login

# 等待用户扫码登录（最多等 120 秒）
python3 {baseDir}/scripts/xianyu.py wait-login [--timeout 120]

# 列出聊天对话（含未读标记）
python3 {baseDir}/scripts/xianyu.py list-chats

# 读取某个对话的消息（index 从 list-chats 获取）
python3 {baseDir}/scripts/xianyu.py read-chat --index 0

# 在当前打开的对话中发送消息
python3 {baseDir}/scripts/xianyu.py send --text "包的~ 不包邮的话我自己都不好意思 😂"

# 获取页面文字快照（调试用）
python3 {baseDir}/scripts/xianyu.py snapshot

# 截图
python3 {baseDir}/scripts/xianyu.py screenshot [--output path.png]

# 关闭浏览器（任务结束后执行）
python3 {baseDir}/scripts/xianyu.py kill

浏览器在多条命令间保持存活，无需每次重启。任务完成后用 kill 关闭。

加 --headless 无头运行，--debug 查看详细错误。

操作流程

1. 读取商品知识库

读取 {baseDir}/products.md。如果包含 [商品名称]，提示用户先填写商品信息后重试。

2. 检查登录状态
python3 {baseDir}/scripts/xianyu.py login
  • "logged_in": true → 继续
  • "logged_in": false → 执行 wait-login，告知用户"请在弹出的浏览器中扫码登录闲鱼"，等待登录完成
  • 命令报错含 playwright → 提示运行安装命令，停止
# 如需登录，等待用户扫码
python3 {baseDir}/scripts/xianyu.py wait-login --timeout 120
3. 获取聊天列表
python3 {baseDir}/scripts/xianyu.py list-chats
  • 解析 chats 数组，找 has_unread: true 的对话
  • 如果返回 raw_snapshot（自动解析失败），分析快照文本识别对话
  • 无未读 → "当前没有新消息"，结束
4. 逐个处理未读对话

对每个未读对话：

# 点击进入对话并读取消息
python3 {baseDir}/scripts/xianyu.py read-chat --index <N>

# 分析买家最新消息 → 结合商品知识库生成回复

# 发送回复
python3 {baseDir}/scripts/xianyu.py send --text "回复内容"

发送后用 snapshot 确认。send 返回 success: false → 告知"消息可能未发送成功，请手动检查"。

5. 汇报结果

汇报：回复了几个买家、每个的大致内容、需要人工处理的标注。

6. 关闭浏览器

任务完成后关闭浏览器释放资源：

python3 {baseDir}/scripts/xianyu.py kill

回复策略

价格相关
  • 如实告知知识库中的价格，不主动降价
  • 砍价 <10% → "哈哈这个价真的很实在了，我去问问老板还能不能再抠一点点"
  • 砍价 >10% → 转人工
发货相关
  • 告知知识库中的发货时间和物流
  • 无具体信息 → "拍下后 24 小时内发货"
商品咨询
  • 基于知识库如实回答
  • 不知道的不编造 → "这个问题有点超纲了😂 我确认一下回复你哈"
需要人工介入

回复"稍等哈，这个得请出我们的终极 Boss 来处理~"并在汇报中标注：

  • 退货/退款/投诉/差评威胁/纠纷
  • 知识库无法覆盖的复杂技术问题
  • 砍价超过 10%
回复示例
买家: 在吗 → 在的在的，比闲鱼推送还快 ⚡
买家: 包邮吗？ → 包的~ 不包邮的话我自己都不好意思 😂
买家: 能便宜点吗？ → 价格已经是骨折价了哥，再砍我就要骨折了 🦴
买家: 什么时候发货？ → 拍下后闪电发货⚡ 最迟24h，比外卖慢一丢丢
买家: 我要退货 → 稍等哈，这个得请出我们的终极 Boss 来处理~（认真脸）
买家: 这个支持ESP32吗？ → 支持的！ESP32、树莓派、Linux 都能搞，硬件大满贯 🎰

注意事项

  • 不要点击"确认收货"、"退款"、"举报"等敏感按钮
  • 不要修改商品价格、描述
  • 只操作聊天输入框和发送按钮
  • 页面异常或找不到元素 → 停止并告知用户

Comments

Markdown supported