SuperAPI AI 工具集

xhs-search-workflow

数据与分析

查看项目

更新于 10-15 17:33

技能介绍

用途:把该技能当作独立的小红书工作流工具箱使用,而非原仓库的薄封装,用于登录、搜索、提取、导出和创作者数据采集,并支持在脱离原仓库时稳定复用 Spider_XHS 核心能力。

主要能力与入口脚本:scripts/xhs_full_cli.py 为统一入口,用于登录、状态检查、用户、评论、消息、首页、创作者、无水印链接等通用任务;scripts/search_notes.py 只做笔记搜索;scripts/fetch_note_texts.py 提取标题、正文、图片链接或下载无水印图片;scripts/export_notes.py 导出 Excel 与媒体文件。支持内置 JS 签名与 Cookie/二维码登录。

使用方式:先用 skills/xhs-search-workflow/scripts/setup_env.sh 初始化依赖,执行脚本优先使用 skills/xhs-search-workflow/.venv/bin/python。已有有效 COOKIES 时用 --cookie 或 --env-file;无登录态时运行 xhs_full_cli.py login 做二维码登录,会自动 bootstrap 匿名态 cookie、生成终端二维码与本地 PNG,并把成功会话保存到本地 cookies.json。返回量大的接口优先用 --out 落文件,批量导出用 export_notes.py,稳妥抓取保留 fetch_note_texts.py 的节流与重试参数。

资源与约束:references/quickstart.md 提供安装、鉴权、常用命令与校验命令;references/troubleshooting.md 处理风控、登录失效、结果为空等;scripts/xhs_auth.py 负责二维码登录与会话保存;scripts/xhs_client.py 负责签名请求与统一 API 封装;assets/js/ 存放离线签名资源,不要删除 assets/js/vendor/crypto-js.js。不要依赖原仓 Spider_XHS 运行时模块;不要把 Cookie、会话文件或截图泄露到聊天、日志或 Git 仓库;不要把系统 Python 当默认解释器;不要擅自改成有水印媒体链路。用户明确要求下载媒体时默认使用无水印链接,仅当明确要求保留原始或带水印版本时才用原始媒体地址。其他细节暂未提供。