通过商品信息和百应精选联盟账号,搜索匹配的达人列表并导出。Invoke when user needs to find matching influencers for product promotion on Baiying Alliance.
---
name: "baiying-daren-search"
description: "通过商品信息和百应精选联盟账号,搜索匹配的达人列表并导出。Invoke when user needs to find matching influencers for product promotion on Baiying Alliance."
---
# 百应精选联盟达人搜索工具
## 功能概述
该工具用于帮助用户在百应精选联盟平台上,根据商品信息搜索并导出匹配的达人列表,助力商品推广和营销合作。
## 核心功能
1. **商品信息录入** - 支持录入商品标题、类目、关键词等信息
2. **账号登录** - 支持验证码登录和密码登录两种方式
3. **达人广场搜索** - 根据商品信息智能匹配相关达人
4. **结果导出** - 将匹配的达人列表导出为 Excel 文件
## 技术实现
- **自动化引擎**: Puppeteer (Chrome 无头浏览器)
- **数据导出**: xlsx (Excel 文件生成)
- **语言**: Node.js
## 安装依赖
```bash
npm install puppeteer xlsx
```
## 登录方式
### 方式一:验证码登录(推荐)
不提供密码参数时,脚本会自动使用验证码登录:
```bash
node daren-search.js \
--account "你的手机号" \
--productTitle "2024新款夏季短袖T恤"
```
登录流程:
1. 脚本自动输入账号并点击发送验证码
2. 验证码会发送到您绑定的手机号
3. 脚本会提示您在终端输入验证码
4. 输入验证码后自动完成登录
### 方式二:密码登录(旧版)
提供密码参数时,使用传统的密码登录方式:
```bash
node daren-search.js \
--account "你的账号" \
--password "你的密码" \
--productTitle "2024新款夏季短袖T恤"
```
## 使用方法
### 基本用法(验证码登录)
```bash
cd d:\matchExpert\.trae\skills\baiying-daren-search
node daren-search.js \
--account "13500135000" \
--productTitle "2024新款夏季短袖T恤" \
--category "服装" \
--keywords "T恤,夏季,潮流" \
--pageCount 3 \
--outputPath "./output/daren_list.xlsx"
```
### 编程调用
```javascript
const BaiyingDarenSearch = require('./daren-search.js');
async function run() {
const searcher = new BaiyingDarenSearch();
// 验证码登录
const result = await searcher.run({
account: '13800138000', // 必填:手机号
productTitle: '2024新款夏季短袖T恤',
category: '服装',
keywords: ['T恤', '夏季', '潮流'],
pageCount: 3,
outputPath: './daren_list.xlsx'
});
console.log(`成功抓取 ${result.count} 位达人`);
console.log(`结果已导出到: ${result.outputPath}`);
}
run();
```
## 参数说明
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| account | string | 是 | 百应精选联盟账号(手机号) |
| password | string | 否 | 密码(不填则使用验证码登录) |
| productTitle | string | 是 | 商品标题 |
| category | string | 否 | 商品类目(如:服装、美妆、数码) |
| keywords | array/string | 否 | 搜索关键词,数组或逗号分隔字符串 |
| pageCount | number | 否 | 抓取页数,默认1页 |
| outputPath | string | 否 | 输出文件路径,默认 ./daren_list.xlsx |
## 输出字段
导出的 Excel 文件包含以下字段:
| 字段 | 说明 |
|------|------|
| 达人昵称 | 达人的昵称 |
| 头像链接 | 达人头像URL |
| 粉丝数 | 达人粉丝数量 |
| 平均播放量 | 视频平均播放量 |
| 带货评分 | 达人带货能力评分 |
| 合作方式 | 合作模式(如:佣金、坑位费等) |
| 详情链接 | 达人主页链接 |
## 使用流程
### 第一步:准备输入信息
需要准备以下信息:
| 信息项 | 说明 | 必填 |
|--------|------|------|
| 商品标题 | 商品的完整标题 | 是 |
| 商品类目 | 商品所属类目(如:服装、美妆、数码等) | 是 |
| 关键词 | 用于搜索的核心关键词 | 否 |
| 账号 | 百应精选联盟账号(手机号) | 是 |
| 验证码 | 登录时接收的短信验证码 | 是(验证码登录时) |
### 第二步:执行登录
**验证码登录流程**:
1. 脚本自动打开登录页面
2. 输入账号并点击发送验证码
3. 您在终端输入收到的短信验证码
4. 脚本自动完成登录
**密码登录流程**:
1. 脚本自动打开登录页面
2. 输入账号和密码
3. 自动完成登录
### 第三步:执行搜索
工具会自动完成以下操作:
1. 进入达人广场页面
2. 根据商品信息构建搜索条件
3. 执行搜索并抓取达人列表
4. 支持多页自动翻页抓取
### 第四步:导出结果
搜索完成后,工具会将达人列表导出为 Excel 文件。
## 注意事项
1. **账号安全**:请妥善保管您的百应联盟账号,不要在公共场合使用
2. **验证码时效**:验证码通常有5分钟时效,请在收到后尽快输入
3. **频率限制**:请遵守平台的访问频率限制,避免频繁请求导致账号被封
4. **数据准确性**:搜索结果基于平台数据,建议人工复核重要合作
5. **网络环境**:确保网络稳定,避免因网络问题导致抓取中断
6. **页面变更**:如果平台页面结构变更,可能需要更新选择器配置
## 适用场景
- 电商商家寻找商品推广达人
- 运营人员筛选合作达人
- 数据分析人员收集达人信息
- 批量获取潜在合作对象
## 文件结构
```
baiying-daren-search/
├── SKILL.md # 技能说明文档
└── daren-search.js # 核心执行脚本
```
## 故障排除
### 常见问题
1. **验证码未收到**:
- 检查手机号是否正确
- 确认手机网络正常
- 稍等片刻后重试
2. **验证码输入超时**:
- 验证码有时效性,请在提示后尽快输入
- 如果超时需要重新获取验证码
3. **页面加载超时**:
- 检查网络连接状态
- 增加等待时间或重启脚本
4. **选择器找不到**:
- 平台页面结构可能已变更,需要更新选择器
- 可以手动在浏览器中检查实际的选择器
### 日志信息
脚本会输出详细的执行日志,包括:
- 当前执行步骤
- 抓取进度
- 错误信息
---
**版本**: 2.0.0
**更新内容**: 支持验证码登录
**适用平台**: 百应精选联盟(抖音电商)don't have the plugin yet? install it then click "run inline in claude" again.