让 AI 自动管你的闲鱼店铺xianyu-mcp-server 开源项目体验每天手动上架、回消息、改价格、查竞品太费时间这个开源项目把闲鱼能力封装成标准 MCP 工具让 Trae、Claude Desktop、Cursor、VS Code、Cherry Studio 这类 AI 客户端直接操作你的闲鱼账号。20 个 MCP 工具 | 5 大客户端 | 扫码登录 | 风控护栏 |uvx即用GitHub 仓库DoLovya/xianyu-mcp-server能干什么你发一句话AI 直接替你操作闲鱼接入之后你在 AI 客户端里直接说自然语言就行。“把我店里所有价格低于 50 的商品下架”AI 会自动拉取你的全部商品筛选符合条件的条目然后逐个执行下架。这个过程不是简单暴力地一口气猛点接口而是带着项目内置的风控护栏去跑自动控制写操作间隔和重试节奏。“看看最近有没有人给我发消息有的话帮我回一下”AI 可以先拉会话列表再读指定会话历史最后调用发消息工具回复买家。对卖家来说这一步已经很接近“AI 客服”。“帮我搜一下闲鱼上有没有二手 Switch按最新发布排序”AI 会直接调用搜索接口把最新发布的商品列表整理出来不用你再手动打开 App 一页页翻。这不是 PPT 式设想而是当前仓库已经封装好的 MCP 工具能力。你不需要自己研究 Cookie 签名、接口参数、消息协议AI 客户端会直接调用这些工具。现在有哪些能力20 个 MCP 工具覆盖卖家高频场景当前xianyu-mcp-server已开放20 个 MCP 工具大致分成 5 组。1. 登录与登录态维护工具说明validate_login校验当前 Cookie 是否有效refresh_login刷新当前登录态qr_login_generate生成扫码登录二维码qr_login_status查询扫码登录状态必要时返回验证信息qr_login_cookie在扫码成功后提取完整 Cookieqr_login_save_env把扫码得到的 Cookie 直接写回.env这套链路最大的价值是第一次使用时可以不手动抓 Cookie。把.env留空启动项目就能引导你扫码登录成功后还可以直接写回环境文件。2. 商品搜索、详情与店铺管理工具说明search_items按关键词搜索闲鱼商品支持分页与排序get_item_detail获取指定商品详情get_item_edit_detail获取商品在 PC 编辑页的详情list_my_items自动翻页拉取当前账号下全部商品downshelf_item下架指定商品reshelf_item通过 PC 编辑重发布链路重新上架商品edit_item编辑商品标题、价格、描述等信息publish_physical_item发布新的实体商品支持自动上传图片对于卖家来说这一组已经能覆盖“查商品、改商品、上下架、发新品”这些最常用动作。3. 用户信息与会话消息工具说明get_my_profile获取当前登录账号的个人资料信息list_conversations拉取最近会话列表list_conversation_messages获取指定会话历史消息send_text_message发送文本消息send_image_message发送图片消息这让项目不只是“自动上下架工具”而是已经具备向客服和卖家助手方向继续扩展的基础。4. 媒体上传工具说明upload_media上传本地文件或 URL 素材返回可复用媒体链接这个能力既能给publish_physical_item服务也能给图片消息或后续编辑商品时复用。5. 风控友好的调用护栏这部分不是单独的 MCP 工具但恰恰是项目很有价值的地方。仓库内已经实现了请求护栏读写分离限速读操作和写操作使用不同节奏写操作串行化避免多条写请求并发触发风控指数退避遇到可疑错误自动退避重试冷却机制识别强风控信号后主动进入冷却自动化不等于无脑猛调接口这套护栏决定了它更适合长期真实使用。为什么这个项目值得关注不是脚本堆砌而是标准 MCP 接入价值一标准 MCP 协议主流 AI 客户端都能接项目基于标准 MCPModel Context Protocol实现不绑定某一个 AI 产品。客户端接入方式Trae项目内配置.trae/mcp.jsonClaude Desktop写入claude_desktop_config.jsonCursor配置.cursor/mcp.jsonVS Code配置.vscode/mcp.jsonCherry StudioUI 中新增 MCP 服务可选stdio或 HTTP对用户来说这意味着你只需要把服务跑起来接入哪个 AI 客户端都比较顺手。价值二扫码登录友好第一次使用门槛低很多自动化项目最劝退的一步就是让你自己抓 Cookie。这个项目把扫码登录能力做成了完整链路生成二维码手机扫码确认查询登录状态拿到完整 Cookie一键写回.env如果遇到人脸验证或额外风控工具也会把状态暴露出来而不是让你只看到一个模糊的失败提示。价值三从“会调接口”进化到“可接入真实工作流”很多项目把接口打通就结束了但 MCP 项目的价值在于它天然适合接到 Agent 工作流里。比如用 AI 批量整理店铺商品用 AI 自动做竞品搜索用 AI 帮你回复买家后续继续扩展成消息监听 自动回复 Worker这类能力一旦接入标准 MCP复用成本会低很多。三步快速上手这里分两种方式直接使用以及源码开发。方式一uvx直接启动推荐如果你只是想先体验最省事的方式是uvx xianyu-mcp如果想以 HTTP 模式启动uvx xianyu-mcp--http默认地址是http://localhost:8000/mcp方式二源码开发模式如果你要改代码、联调或本地开发再 clone 仓库gitclone https://github.com/DoLovya/xianyu-mcp-server.gitcdxianyu-mcp-servercp.env.example .env uvsyncuv run xianyu-mcp这里的third_party/pyxianyu更适合作为开发调试用源码依赖理解而不是普通使用者必须手动维护的安装步骤。没有 Cookie 也能先跑起来.env可以先留空。项目支持扫码登录流程首次启动时会引导你完成登录并把 Cookie 写回本地环境文件。对第一次上手非常友好。Trae / Cursor / Claude Desktop 怎么接大多数 MCP 客户端都使用stdio模式。对源码开发场景推荐直接让客户端用工作区里的uv环境启动服务。Trae 项目级配置示例{mcpServers:{xianyu-mcp-server:{command:uv,args:[--directory,${workspaceFolder},run,xianyu-mcp]}}}如果你不打算 clone 仓库而是想直接跑已安装的包也可以使用{mcpServers:{xianyu-mcp-server:{command:uvx,args:[xianyu-mcp]}}}几个关键点Trae / Cursor / Claude Desktop / VS Code一般优先走stdioCherry Studio除了stdio也可以接 HTTP 模式源码开发场景优先使用uv --directory ${workspaceFolder} run xianyu-mcp普通试用场景优先使用uvx xianyu-mcp实战场景这些事 AI 已经能帮你做场景一批量店铺运维“把我店里所有价格低于 100 的商品都下架”AI 会先调用list_my_items拉完整个商品列表再筛选再逐个调用downshelf_item。这个流程对卖家特别友好因为它避免了你自己在 App 里重复机械操作。场景二竞品搜索与价格观察“搜一下闲鱼上二手 Switch按最新发布排序”AI 直接调用search_items把最新发布结果整理出来。你后续还可以继续追问哪些价格更低哪些卖家在同城哪些成色描述更好场景三AI 帮你做客服“看看最近有没有人问我商品问题有的话帮我回一下”这个流程会串起list_conversationslist_conversation_messagessend_text_message/send_image_message对于经常被买家反复问同类问题的卖家来说这已经很接近“把客服交给 AI 打底处理”。场景四一键发布新品“帮我发一个九成新 Kindle Oasis价格 800配这几张图”AI 可以先上传图片再调用publish_physical_item完成发布。对经常在电脑端整理素材的人来说这比在手机里反复填表单顺手很多。工程质量它已经不是玩具项目了当前仓库能核实到的工程状态大致如下指标当前情况MCP 工具数20Python 测试矩阵3.11 / 3.12 / 3.13测试文件8单元测试24包入口xianyu-mcp依赖管理uvCIGitHub Actions 持续集成更关键的是项目现在已经不只是“本地脚本 子模块硬拼装”的状态而是在往标准 Python 包依赖和标准 MCP 接入方式上收敛。这意味着使用者安装成本更低IDE / AI 客户端接入更顺后续发布到 PyPI、通过uvx启动这条路也更清晰已知限制和接下来的方向先说目前的边界这样更真实。当前已知限制虚拟商品通常受闲鱼 PC 端发布/编辑限制当前无法稳定走reshelf_item重新上架常驻消息监听与自动回复 Worker 还没有 MCP 化语音、视频类消息工具还没开放出来接下来最值得期待的方向消息监听和自动回复拆成独立 Worker更多商品类型支持面向卖家的数据分析能力更完善的多客户端接入文档所以这个项目现在最适合的定位是已经能用、适合接入 AI 工作流、仍在持续扩展的闲鱼 MCP 基础设施。适合谁用如果你属于下面几类人这个项目会特别有感觉经常在闲鱼卖二手、想减少重复操作的人喜欢把日常工作流交给 AI 自动化的人正在研究 MCP 落地案例的人想做 AI 客服、AI 店铺助手、Agent 自动运维的人它不是“一个只能演示的 Demo”而是已经具备继续往真实卖家工作流里长的基础。开始用起来先用最短命令跑起来uvx xianyu-mcp如果你要在工作区里和 Trae 一起联调就用uv--directory${workspaceFolder}run xianyu-mcpGitHub 仓库DoLovya/xianyu-mcp-server如果你最近正好在折腾 AI 自动化、MCP 或卖家工具这个项目很值得实际跑一遍。因为它不是单纯“能连上接口”而是已经把登录、商品、消息、上传、风控这些关键拼图接起来了。风险提示与免责声明本项目仅供学习、技术研究与个人自动化实践使用不用于任何商业用途。闲鱼Goofish是阿里巴巴集团旗下的二手交易平台本项目未获得平台授权或认可。项目通过逆向分析闲鱼 Web 端接口实现自动化操作使用过程中可能触发平台风控、功能限制、临时封禁或永久封号等后果。项目开发者与贡献者不对因使用本项目产生的直接或间接损失负责。使用前请自行评估风险并遵守所在地区法律法规与平台规则。