Metadata

name: baiying-daren-search
description: 通过商品信息和百应精选联盟账号，搜索匹配的达人列表并导出。Invoke when user needs to find matching influencers for product promotion on Baiying Alliance.

百应精选联盟达人搜索工具

功能概述

该工具用于帮助用户在百应精选联盟平台上，根据商品信息搜索并导出匹配的达人列表，助力商品推广和营销合作。

核心功能

商品信息录入 - 支持录入商品标题、类目、关键词等信息
账号登录 - 支持验证码登录和密码登录两种方式
达人广场搜索 - 根据商品信息智能匹配相关达人
结果导出 - 将匹配的达人列表导出为 Excel 文件

技术实现

自动化引擎: Puppeteer (Chrome 无头浏览器)
数据导出: xlsx (Excel 文件生成)
语言: Node.js

安装依赖

npm install puppeteer xlsx

登录方式

方式一：验证码登录（推荐）

不提供密码参数时，脚本会自动使用验证码登录：

node daren-search.js \
  --account "你的手机号" \
  --productTitle "2024新款夏季短袖T恤"

登录流程：

脚本自动输入账号并点击发送验证码
验证码会发送到您绑定的手机号
脚本会提示您在终端输入验证码
输入验证码后自动完成登录

方式二：密码登录（旧版）

提供密码参数时，使用传统的密码登录方式：

node daren-search.js \
  --account "你的账号" \
  --password "你的密码" \
  --productTitle "2024新款夏季短袖T恤"

使用方法

基本用法（验证码登录）

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"

编程调用

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
粉丝数	达人粉丝数量
平均播放量	视频平均播放量
带货评分	达人带货能力评分
合作方式	合作模式（如：佣金、坑位费等）
详情链接	达人主页链接

使用流程

第一步：准备输入信息

需要准备以下信息：

信息项	说明	必填
商品标题	商品的完整标题	是
商品类目	商品所属类目（如：服装、美妆、数码等）	是
关键词	用于搜索的核心关键词	否
账号	百应精选联盟账号（手机号）	是
验证码	登录时接收的短信验证码	是（验证码登录时）

第二步：执行登录

验证码登录流程：

脚本自动打开登录页面
输入账号并点击发送验证码
您在终端输入收到的短信验证码
脚本自动完成登录

密码登录流程：

脚本自动打开登录页面
输入账号和密码
自动完成登录

第三步：执行搜索

工具会自动完成以下操作：

进入达人广场页面
根据商品信息构建搜索条件
执行搜索并抓取达人列表
支持多页自动翻页抓取

第四步：导出结果

搜索完成后，工具会将达人列表导出为 Excel 文件。

注意事项

账号安全：请妥善保管您的百应联盟账号，不要在公共场合使用
验证码时效：验证码通常有5分钟时效，请在收到后尽快输入
频率限制：请遵守平台的访问频率限制，避免频繁请求导致账号被封
数据准确性：搜索结果基于平台数据，建议人工复核重要合作
网络环境：确保网络稳定，避免因网络问题导致抓取中断
页面变更：如果平台页面结构变更，可能需要更新选择器配置

适用场景

电商商家寻找商品推广达人
运营人员筛选合作达人
数据分析人员收集达人信息
批量获取潜在合作对象

文件结构

baiying-daren-search/
├── SKILL.md          # 技能说明文档
└── daren-search.js   # 核心执行脚本

故障排除

常见问题

验证码未收到：
- 检查手机号是否正确
- 确认手机网络正常
- 稍等片刻后重试
验证码输入超时：
- 验证码有时效性，请在提示后尽快输入
- 如果超时需要重新获取验证码
页面加载超时：
- 检查网络连接状态
- 增加等待时间或重启脚本
选择器找不到：
- 平台页面结构可能已变更，需要更新选择器
- 可以手动在浏览器中检查实际的选择器

日志信息

脚本会输出详细的执行日志，包括：

当前执行步骤
抓取进度
错误信息

版本: 2.0.0
更新内容: 支持验证码登录
适用平台: 百应精选联盟（抖音电商）

match-daren

安装技能