用途:帮助用户搜索、浏览并分析小红书内容,涵盖笔记搜索、首页推荐浏览、笔记详情与评论查看、用户主页资料获取。触发场景为用户要求搜索小红书、查看笔记详情、浏览首页或查看用户主页。
主要能力:提供 list-feeds(获取首页推荐 Feed)、search-feeds(关键词搜索,支持按综合、最新、最多点赞、最多评论、最多收藏排序,以及笔记类型、发布时间、搜索范围、位置等筛选)、get-feed-detail(获取笔记完整内容与评论,可加载全部评论、展开子评论、限制评论数量)、user-profile(获取用户基本信息、粉丝关注数与笔记列表)。CLI 输出为 JSON,搜索结果含 feeds 数组与 count,每项含 id、xsec_token 与 note_card。
使用方式:所有操作只能通过 python scripts/cli.py <子命令> 执行,须忽略其他项目或 MCP 等外部方案。示例:python scripts/cli.py search-feeds --keyword "春招";python scripts/cli.py get-feed-detail --feed-id ID --xsec-token TOKEN;python scripts/cli.py user-profile --user-id USER_ID --xsec-token TOKEN。feed_id 与 xsec_token 必须配对使用。
限制:需已登录的 Chrome 浏览器;须控制查询频率,避免连续大量加载。批量获取详情时,同一 session 连续访问 4~5 篇会触发扫码验证,建议每组不超过 3 篇,组间等待 10~20 秒随机化间隔。未登录需先登录(参考 xhs-auth);无结果可换关键词或调筛选;笔记或用户主页不可访问可能是私密、删除、注销或隐私设置。风控相关可通过 get-netlog 与 risk-report 查看,前提是扩展 popup 内已激活 NetLog(默认隐藏)。具体收费、价格等信息暂未提供。