mcpField
X
xianyu-skills

xianyu-skills

github.com/donggeai营销与增长2138 次安装17 周前更新
代码仓库

关于 xianyu-skills

xianyu-skills 通过 Xianyu Bridge 和 Python CLI 操作 Chrome 中已登录的闲鱼账号。它将账号、发布、浏览、互动和运营任务分配给不同子技能，并要求对会改变账号状态的操作先行确认。

主要功能

  1. 01检查 Chrome 账号及登录状态
  2. 02填写商品描述、价格和图片并发布
  3. 03搜索商品并查看详情
  4. 04读取消息并执行账号互动
  5. 05按任务分发至专用子技能

适用场景

  1. 01检查当前登录的闲鱼账号
  2. 02准备并发布商品信息
  3. 03搜索商品并查看商品数据
  4. 04查看消息或发送已获授权的回复

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/donggeai/xianyu-skills --skill xianyu-skills

安装后在 Claude Code 中输入/xianyu-skills确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
pyproject.toml
uv.lock
extension/
popup.js
manifest.json
popup.html
content.js
background.js
scripts/
run_lock.py
cli.py
bridge_server.py
scripts/xianyu/
__init__.py
errors.py
interact.py
bridge.py
product_ops.py
profile.py
messages.py
login.py
item_detail.py
publish.py
search.py
urls.py
selectors.py

详细介绍

来自项目 README

xianyu-skills

使用本项目自带的 Xianyu Bridge 扩展和 Python CLI 操作用户已登录的 Chrome 闲鱼账号。整体策略：能力完整暴露，文档层提醒确认和合理频率，CLI 层不硬编码阉割功能。

技能边界

  • 所有闲鱼操作只通过本目录的 python scripts/cli.py <command> 完成。
  • 不要改用 Codex Chrome 插件、Playwright CLI、外部 MCP 或其他浏览器自动化方案来替代 Xianyu Bridge。
  • 命令输出为 JSON；向用户汇报时提取关键字段，不要倾倒整段页面文本。
  • 发布、私信、收藏、想要等外部动作会改变账号状态，用户未明确授权时先确认。
  • 不要读取、导出或展示 cookies、密码、手机号验证码等敏感信息。

子技能路由

按用户意图选择最小必要子 Skill：

  • 登录、检查账号、确认当前账号：skills/xianyu-auth/SKILL.md
  • 发布商品、上传商品图、填写/确认发布表单：skills/xianyu-publish/SKILL.md
  • 搜索商品、查看详情、查看我的商品、读取商品数据：skills/xianyu-explore/SKILL.md
  • 查看消息、打开聊天、发送消息、收藏、我想要：skills/xianyu-interact/SKILL.md
  • 竞品分析、价格带分析、流量复盘、发布测试、咨询辅助：skills/xianyu-product-ops/SKILL.md

通用流程

  1. 进入 .agents/skills/xianyu-skills。
  2. 使用 .venv/Scripts/python.exe 或已安装 websockets 的 Python 环境运行 CLI。
  3. 先执行 check-login；未登录时执行 login，让用户在 Chrome 里完成登录。
  4. 根据任务调用对应子 Skill 的命令。
  5. 对高影响动作，优先采用“先填表/生成草稿 -> 用户确认 -> 点击发布/发送”的分步模式。

常用命令

python scripts/cli.py check-login
python scripts/cli.py fill-publish --description-file D:/abs/desc.txt --price 29.9 --images D:/abs/pic.png
python scripts/cli.py click-publish
python scripts/cli.py publish --description-file D:/abs/desc.txt --price 29.9 --images D:/abs/pic.png
python scripts/cli.py search-items --keyword "PPT代做" --limit 20
python scripts/cli.py get-item-detail --item-id ITEM_ID
python scripts/cli.py list-my-items
python scripts/cli.py list-messages
python scripts/cli.py analyze-competitors --keyword "PPT代做" --limit 10

环境准备

  1. 运行 uv sync 安装依赖，或使用已有 Python 环境安装 requests websockets。
  2. Chrome 打开 chrome://extensions/。
  3. 开启开发者模式，加载本目录的 extension/。
  4. 确认扩展名为 Xianyu Bridge，默认 Bridge 地址为 ws://localhost:9444。

失败处理

  • No module named websockets：使用 .venv/Scripts/python.exe，或先运行 uv sync。
  • Bridge 连接超时：确认 scripts/bridge_server.py 正在运行，Chrome 扩展已启用。
  • 扩展无响应：在 chrome://extensions/ 重新加载 Xianyu Bridge。
  • 上传图片失败：确认图片是本地绝对路径、文件存在、格式为平台可接受图片。
  • 页面提示分类不支持：发布命令默认使用 --category auto-safe，会按页面提示尝试相邻可发布分类。
  • 发布后商品消失或收到处罚通知：向用户说明平台审核/风控提示，并建议检查闲鱼消息与商品状态。

评论

支持 Markdown