用 pyxianyu 打通闲鱼商品、搜索、消息能力GitHub 仓库DoLovya/pyxianyu前言闲鱼自动化先别急着写业务先把签名、登录态和接口入口封稳定。一、问题直接调闲鱼 Web 端接口基本都会卡在这 3 个点请求参数里有sign不能裸调Cookie 会刷新常驻进程容易失效商品、搜索、消息能力分散业务代码很快写乱目标做一个可复用的 Python 库把签名、请求、鉴权、业务 API统一起来。二、方案1. 统一签名和请求所有业务 API 都走同一套签名链路这层一定先收口。importtimeimportrequestsfrompyxianyu.utils.xianyu_utilsimportgenerate_signclassXianyuClient:def__init__(self,cookies,device_id):self.sessionrequests.Session()self.session.cookies.update(cookies)# 登录态注入self.device_iddevice_iddefbuild_mtop_params(self,api):return{jsv:2.7.2,appKey:34839810,t:str(int(time.time())*1000),sign:,api:api,type:originaljson,dataType:json,}defbuild_signed_form(self,params,data_val):tokenself.session.cookies.get(_m_h5_tk,).split(_)[0]params[sign]generate_sign(params[t],token,data_val)# 生成 signreturn{data:data_val}defensure_api_success(self,payload):retpayload.get(ret)or[]ifretandnotret[0].startswith(SUCCESS):raiseRuntimeError(ret[0])# 统一失败出口returnpayload后面所有接口只管组装data不用重复处理签名和异常。2. 业务 API 模块化登录态、商品、搜索、媒体分模块对外只暴露一个入口。classXianyuApis:def__init__(self,cookies,device_id):self.clientXianyuClient(cookies,device_id)self.auth_apiAuthApi(self.client)self.item_apiItemApi(self.client)self.search_apiSearchApi(self.client)defget_token(self):returnself.auth_api.get_token()defget_item_info(self,item_id):returnself.item_api.get_item_info(item_id)defsearch_items(self,keyword,page_number1,rows_per_page20):returnself.search_api.search_items(keyword,page_numberpage_number,rows_per_pagerows_per_page)调用层只面向XianyuApis不用关心底层 URL 和签名细节。3. 先安装再调用1.0.0版本开始对外入口已经统一为xianyu命名直接安装即可。# 方式1安装正式版pipinstall-Upyxianyu# 方式2uv 安装uv pipinstall-Upyxianyu如果你是本地调试仓库源码也可以直接安装当前项目cdthird_party/pyxianyu pipinstall-e.环境变量准备exportXIANYU_COOKIE你的完整Cookie可直接运行的示例importosfrompyxianyu.xianyu_apisimportXianyuApisfrompyxianyu.utils.xianyu_utilsimportgenerate_device_id,trans_cookiesdefmain():cookie_stros.environ[XIANYU_COOKIE]# 完整 Cookiecookiestrans_cookies(cookie_str)user_idcookies.get(unb,0)# 从 Cookie 中拿当前用户标识device_idgenerate_device_id(user_id)apiXianyuApis(cookies,device_id)token_resultapi.get_token()nav_resultapi.get_user_page_nav()print(token ok:,bool(token_result.get(data)))print(nav_result)# 直接看接口原始返回if__name____main__:main()运行方式python demo.py这个示例只依赖XIANYU_COOKIE更适合先验证登录态和基础调用链路如果字段结构有变化先看print(nav_result)的原始结果最稳。完整功能清单模块功能方法鉴权获取登录 tokenget_token()鉴权刷新登录态refresh_token()商品获取商品详情get_item_info(item_id)商品获取用户商品分页列表get_user_items(user_id, ...)商品自动翻页拉取全部商品get_all_user_items(user_id, page_size20)商品下架商品downshelf_item(item_id)商品发布前校验prepublish_check(item_idNone)商品获取发布/编辑预置参数preget(item_idNone, source_idNone, publish_sceneNone, bizcodeNone)商品获取商品编辑详情get_item_edit_detail(item_id)商品编辑商品edit_item(payload)商品发布全新商品publish_item(payload)商品构造重新上架 payloadbuild_reshelf_payload(edit_detail_result, item_idNone, source_idNone)商品一步重新上架商品reshelf_item(item_id, source_idNone)搜索按关键词搜索商品search_items(keyword, page_number1, rows_per_page20, ...)用户获取当前登录用户信息get_user_page_nav()媒体上传图片/视频/音频upload_media(media_path)消息创建单聊会话create_chat(ws, toid, item_id)消息发送文本/图片消息send_msg(ws, cid, toid, message)消息单次发送消息send_msg_once(toid, item_id, send_message)消息拉取指定会话历史消息list_all_conversations(cid)消息WebSocket 初始化注册init(ws)消息心跳保活heart_beat(ws)消息HTTP 登录态保活user_alive()消息启动消息监听主循环main()消息处理收到的消息handle_message(message, websocket)消息类型构造文本消息make_text(text)消息类型构造图片消息make_image(url, width0, height0)消息类型构造音频消息make_audio(url, duration_ms0)如果只想记住一件事XianyuApis负责 HTTP 能力聚合XianyuLive负责 WebSocket 消息收发。三、踩坑⚠️sign依赖_m_h5_tkCookie 缺这个字段就会直接失败。⚠️get_token()要限制重试次数别把“令牌过期”写成死循环。⚠️ 编辑商品时部分布尔值是字符串提交前要先归一化。⚠️XIANYU_COOKIE走环境变量别写死在代码里。四、总结pyxianyu先解决的是签名、请求、鉴权不是先堆接口数量。模块拆开对外聚合成XianyuApis业务代码会干净很多。底层库先封稳后面接 MCP、机器人、运营脚本才省事。