用途:管理小红书登录状态,适用于需要登录小红书后执行后续操作的场景,触发条件包括用户要求登录、检查登录状态或退出登录。
主要能力:提供 check-login(检查登录状态)、get-qrcode(获取二维码,非阻塞)、wait-login(等待扫码,阻塞最多120秒)、send-code --phone(发送手机验证码)、verify-code --code(提交验证码登录)、delete-cookies(退出登录并清除 cookies)。命令均位于 scripts/cli.py,输出 JSON;使用文件路径时须用绝对路径;避免频繁重复登录或退出,以免触发账号风控。
使用方式:先运行 python scripts/cli.py check-login。若已登录可直接继续;若未登录且返回二维码信息,可展示 qrcode_image_url 与 qr_login_url,再运行 python scripts/cli.py wait-login 等待完成。无界面环境可选手机验证码方式:先向用户确认手机号,执行 python scripts/cli.py send-code --phone <手机号>,再询问验证码并执行 python scripts/cli.py verify-code --code <验证码>。退出登录执行 python scripts/cli.py delete-cookies。
限制:认证操作只能通过本项目脚本完成,禁止调用 MCP 工具、Go 命令行等外部实现;流程结束后等待用户下一步指令,不主动触发其他功能。发送手机验证码前必须由用户明确确认手机号,不得从历史或上下文中自动填入,即使已有手机号也不得跳过。验证码发送受限时会自动切换为二维码登录。错误处理:验证码错误可重新运行 verify-code;二维码超时可用 get-qrcode 刷新后重新 wait-login;扩展未连接时 CLI 会自动打开 Chrome 等待,超时需检查 XHS Bridge 扩展是否安装并启用。其他细节暂未提供。