mcpField
X
xianyu-skills

xianyu-skills

github.com/donggeaiマーケティング・グロース2138 回インストール17 週間前に更新
リポジトリ

xianyu-skills について

xianyu-skillsは、Xianyu BridgeとPython CLIを使い、Chromeでログイン済みの闲鱼アカウントを操作するスキルです。アカウント確認、出品、閲覧、交流、運用のタスクをサブスキルに振り分け、状態を変更する操作では事前確認を求めます。

主な機能

  1. 01Chromeのアカウントとログイン状態の確認
  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 対応