mcpField
X
xianyu-skills

xianyu-skills

github.com/donggeaiMarketing & growth2138 installsUpdated 17w ago
Repository

About xianyu-skills

xianyu-skills is a skill for operating a user’s logged-in Xianyu account in Chrome through Xianyu Bridge and a Python CLI. It routes tasks across account, listing, browsing, interaction, and product-operations skills, with confirmation steps for actions that change account state.

Key features

  1. 01Chrome account checks and login
  2. 02Publish listings with descriptions, prices, and images
  3. 03Search listings and inspect item details
  4. 04Read messages and perform account interactions
  5. 05Route tasks to focused sub-skills

Use cases

  1. 01Check which Xianyu account is logged in
  2. 02Prepare and publish a product listing
  3. 03Search listings and review item data
  4. 04Review messages or send an authorized reply

Install

Copy the command and run it in a terminal.

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

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

Bundled files

References and scripts installed along with 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

Details

From the project 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，会按页面提示尝试相邻可发布分类。
  • 发布后商品消失或收到处罚通知：向用户说明平台审核/风控提示，并建议检查闲鱼消息与商品状态。

Comments

Markdown supported