match-daren

SKILL.md

---
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  
**更新内容**: 支持验证码登录  
**适用平台**: 百应精选联盟（抖音电商）