用途:搜索、读取和分析闲鱼商品数据,支持竞品调研与发布后状态反查。所有命令通过 python scripts/cli.py <command> 执行。
主要能力:搜索商品;查看商品详情、价格、卖家、浏览数、想要数;查看当前账号商品列表;发布后反查商品状态;为竞品分析或发布优化收集样本。
常用命令: 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 get-item-detail --url "https://www.goofish.com/item?id=..." python scripts/cli.py user-profile python scripts/cli.py list-my-items python scripts/cli.py get-item-stats --item-id ITEM_ID
推荐流程:搜索竞品时选定品类词、场景词或服务词,运行 search-items --keyword ... --limit N,优先关注标题清晰、价格明确、想要数高的商品,再对重点商品运行 get-item-detail,总结价格带、卖点、标题关键词、图片方向和服务承诺。发布后反查时记录商品 ID,运行 get-item-stats --item-id ITEM_ID,记录价格、浏览数、想要数和 URL,后续复盘重复读取并比较变化。
输出字段:id/item_id、title、price、wanted、views、seller、url、raw_text/text。
限制:搜索结果受登录状态、地区、排序和平台推荐影响,不保证每次一致;不要一次抓取过多页面,批量分析应分批并保留间隔;详情页可能含“为你推荐”区域,分析时优先使用脚本解析出的主商品字段;wanted 为 null 表示页面未展示主商品想要数,不要误读推荐商品数据。搜索为空可换关键词或减少限制条件;详情读取失败可尝试完整 URL 或确认是否下架;我的商品列表不含刚发布商品可能因审核、下架或刷新延迟,可稍后重试并检查消息通知。