salesman-recommender — 销售推荐员

达人推荐技能 功能概述 本技能用于自动访问精选联盟达人广场，根据用户提供的动态筛选条件查找符合条件的达人，并将结果保存为 Excel 文件到桌面。 新增功能（v1.1.0）： 支持自动登录：若检测到未登录状态，自动跳转到登录页面 支持招商团长身份选择 支持使用邮箱密码登录（需用户提供） 使用场景 当用户需要： 在精选联盟达人广场查找特定条件的达人 根据类目、带货数据、粉丝数据、达人属性等条件筛选达人 导出达人信息到 Excel 文件 自动登录精选联盟账号（首次使用或未登录时） 工作流程 打开 Chrome 浏览器（使用默认用户配置文件）访问达人广场页面 检测登录状态： 若已登录：直接进入步骤 3 若未登录： 跳转到登录页面 https://buyin.jinritemai.com/mpa/account/institution-role-select 选择"招商团长"身份 若用户提供了邮箱和密码：自动完成登录 若用户未提供：返回提示信息，请求用户提供登录凭据 根据用户提供的条件依次点击筛选条件 捕获最后一次接口请求返回的数据（接口：https://buyin.jinritemai.com/api/authorStatData/seekAuthor） 将满足条件的达人信息保存为 Excel 文件到桌面 筛选条件说明 支持的筛选条件包括： 主推类目：如服饰内衣、美妆护肤等 带货数据：如直播观看人数范围 粉丝数据：如粉丝量范围 达人属性：如达人等级（LV1-LV5） 达人性别：男/女 执行方式 调用 scripts/daren_search.py 脚本执行任务，传入用户要求的筛选条件参数和可选的登录凭据。 参数格式 { 'category': '服饰内衣', 'live_viewers': [100, 1000], 'followers': [100000, 1000000], 'level': 'LV2', 'gender': '女', 'email': 'user@example.com', # 可选：登录邮箱 'password': 'your_password' # 可选：登录密码 } 参数说明 参数 必填 类型 说明 category 否 string 主推类目 live_viewers 否 list 直播观看人数范围 [最小值，最大值] followers 否 list 粉丝量范围 [最小值，最大值] level 否 string 达人等级 (LV1-LV5) gender 否 string 达人性别 (男/女) email 否 string 登录邮箱（未登录时需要） password 否 string 登录密码（未登录时需要） 登录流程说明 自动登录触发条件 当脚本检测到以下情况时，会自动触发登录流程： 当前 URL 包含 login、sso 或 institution-role-select 页面中存在登录表单元素 无法访问达人广场页面（重定向到登录页） 登录步骤 访问角色选择页面：https://buyin.jinritemai.com/mpa/account/institution-role-select 选择招商团长身份：点击"招商团长"选项 输入登录凭据： 若提供了 email 和 password：自动填写并提交 若未提供：在控制台输出提示信息，等待用户手动登录或提供凭据 等待登录完成：检测页面跳转到达人广场或首页 继续执行筛选任务 未提供登录凭据时的提示 若检测到未登录且用户未提供邮箱密码，脚本将输出： ⚠ 检测到未登录状态，但用户未提供登录凭据 请选择以下方式之一：

• 在浏览器中手动完成登录，然后重新运行脚本
• 提供邮箱和密码参数后重新运行：

{ "email": "your_email@example.com", "password": "your_password" } 等待用户手动登录...（最长等待 180 秒） 注意事项 Chrome 配置文件：脚本使用默认 Chrome 用户配置文件，首次登录后会保持会话 登录凭据安全：建议首次使用后保持登录状态，避免每次提供密码 身份选择：默认选择"招商团长"身份，如需其他身份需修改脚本 接口调用：达人广场每次点击筛选条件都会调用接口，需等待所有条件设置完成后获取最终数据 数据限制：如果符合条件的达人总量小于要求数量，则返回所有可用达人 输出文件：保存在用户桌面，格式为 Excel (.xlsx) 错误处理 错误场景 处理方式 未提供登录凭据且未登录 输出提示信息，等待用户手动登录或终止任务 登录失败 重试最多 3 次，失败后终止并报告错误 网络超时 自动重试，最多 5 次 页面元素未找到 记录警告，继续尝试其他选择器 相关文件 scripts/daren_search.py - 主执行脚本（包含自动登录逻辑） references/api_details.md - 接口详细说明 references/login_flow.md - 登录流程详细说明（新增） 使用示例 示例 1：已登录状态，直接筛选 filters = { 'category': '服饰内衣', 'live_viewers': [100, 1000], 'followers': [100000, 1000000], 'level': 'LV2', 'gender': '女' } 示例 2：未登录状态，提供凭据自动登录 filters = { 'category': '美妆护肤', 'followers': [500000, 2000000], 'level': 'LV3', 'email': 'merchant@example.com', 'password': 'secure_password_123' } 示例 3：未登录状态，未提供凭据 filters = { 'category': '食品生鲜', 'level': 'LV1' } # 脚本将提示用户手动登录或提供凭据