# 抖音推流工具

**Repository Path**: hwzyq/tiktok-streaming-tool

## Basic Information

- **Project Name**: 抖音推流工具
- **Description**: 抖音推流工具抖音推流工具抖音推流工具抖音推流工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-30
- **Last Updated**: 2025-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 糯米爸（付费流分享）爆款视频提取

这是一个Chrome浏览器扩展，用于爬取抖音大人后台的视频列表数据。

## 功能特点

1. **密码保护** - 首次使用需要输入授权密码，保护插件安全
2. 必须登录抖音大人后台才能使用
3. 自动滚动页面爬取视频数据
4. 可设置爬取页数和滚动延迟
5. 支持导出数据为CSV格式
6. **智能去重功能** - 根据`video_basic.id`字段自动去除重复视频
7. 支持多种导出格式：JSON、文本文件、CSV（Excel）

## 安装方法

1. 下载或克隆此仓库到本地
2. 打开Chrome浏览器，进入扩展程序页面（chrome://extensions/）
3. 开启"开发者模式"
4. 点击"加载已解压的扩展程序"，选择本项目文件夹
5. 扩展程序将被安装到Chrome浏览器中

## 使用方法

1. 首次使用时，点击扩展图标会要求输入授权密码
   - 默认密码：`nmbff188`
   - 联系获取密码：微信 `nmbff188`
2. 打开抖音大人后台网站（https://buyin.jinritemai.com）并登录
3. 进入视频列表页面
4. 点击Chrome工具栏中的扩展图标
5. 设置滚动延迟时间
6. 点击"开始爬取"按钮
7. 等待爬取完成后，点击"导出数据(Excel)"按钮下载数据

## 密码保护功能

### 安全特性
本工具采用密码保护机制，确保插件的安全使用：

1. **首次验证**: 安装插件后首次使用需要输入授权密码
2. **本地存储**: 验证状态保存在本地，无需重复输入
3. **界面保护**: 未通过验证时无法访问插件功能
4. **现代UI**: 密码验证界面采用毛玻璃设计，体验优良

### 密码信息
- **默认密码**: `nmbff188`
- **获取方式**: 联系微信 `nmbff188`
- **修改方式**: 可在 `popup.js` 文件第550行修改 `correctPassword` 变量

### 验证流程
1. 点击扩展图标
2. 输入授权密码
3. 点击"验证密码"或按回车键
4. 验证成功后自动进入主界面
5. 验证状态永久保存，无需重复验证

### 重置验证
如需重新验证密码，可以：
1. 在扩展程序页面移除并重新添加插件
2. 或清除Chrome本地存储数据

## UI设计特点

### 简洁界面设计
- **精简按钮**: 只保留核心功能按钮（开始爬取、停止爬取、导出数据）
- **无滚动条**: 固定高度480px，确保界面紧凑不出现滚动条
- **清晰布局**: 卡片式设计，层次分明，操作直观

## 去重功能说明

### 去重机制
工具采用智能去重算法，确保导出的数据不包含重复视频：

1. **去重字段**: `video_basic.id`（视频唯一标识）
2. **去重时机**: 在所有导出格式生成前进行
3. **去重策略**: 
   - 保留首次出现的视频ID
   - 跳过重复的视频ID
   - 处理缺少ID字段的异常数据
4. **日志记录**: 详细记录去重过程，包括重复数量统计

### 完整字段列表
导出的Excel/CSV文件包含以下27个字段：

**基础信息**:
- 页码、视频ID、视频标题

**作者信息**:
- 作者昵称、作者头像、作者等级、作者粉丝数

**视频数据**:
- 点赞数、播放量、时段播放量、视频时长、是否优质视频

**商业数据**:
- GMV范围（原始值、最小值、最大值）
- 销量范围（原始值、最小值、最大值）

**媒体资源**:
- 发布时间、视频链接、视频封面、抖音视频地址

**产品信息**:
- 产品ID、推广ID、产品名称、产品封面（自动从_original或video_basic中获取）

**商业指标**:
- 客单价（GMV最大值/销量最大值）
- 万播转化（销量最大值/播放量×10000）
- GPM（GMV最大值/播放量×1000）

### 支持格式
- ✅ **Excel格式 (.xlsx)**: 自动去重，确保Excel文件无重复，包含完整字段，**自动首行冻结**
- ✅ **JSON格式**: 结构化数据，支持去重
- ✅ **文本格式**: 按页码分组，每个视频只出现一次

### Excel专业功能
导出的Excel文件具有专业级的格式和功能：

1. **自动首行冻结**: 无需手动设置，打开文件即可享受固定表头
2. **智能列宽**: 根据内容自动调整列宽，确保数据完整显示
3. **专业格式**: 标准的.xlsx格式，兼容所有Excel版本
4. **数据完整性**: 支持中文字符，无乱码问题
5. **工作表命名**: 自动命名工作表为"抖音视频数据"

**使用方法**:
1. 直接点击"导出数据 (Excel)"按钮
2. 自动下载.xlsx格式文件
3. 用Excel打开，首行已自动冻结
4. 享受专业的Excel浏览体验

## 注意事项

- 爬取过程中请勿关闭或刷新页面
- 爬取速度过快可能会被网站限制，建议适当增加滚动延迟
- 本工具仅供学习和研究使用，请勿用于商业目的
- 请遵守网站的使用条款和相关法律法规

## 联系方式

**投流学习联系微信：nmbff188**

如有问题或需要技术支持，请通过微信联系我们。

## UI设计特点

### 现代化设计风格
- **渐变背景**: 采用蓝紫色渐变背景，营造科技感
- **毛玻璃效果**: 使用backdrop-filter实现现代毛玻璃卡片效果
- **圆角设计**: 16px圆角，符合现代UI设计趋势
- **阴影系统**: 多层次阴影，增强视觉层次感

### 交互体验优化
- **悬停动画**: 按钮悬停时有上浮和阴影变化效果
- **光效动画**: 按钮点击时的光波扫过效果
- **渐入动画**: 页面加载时的渐入动画，提升用户体验
- **响应式设计**: 360px宽度，适配各种屏幕尺寸

### 色彩系统
- **主色调**: 蓝色系（#007AFF）用于主要操作
- **成功色**: 绿色系（#34C759）用于成功状态
- **危险色**: 红色系（#FF3B30）用于危险操作
- **中性色**: 灰色系（#6C757D）用于次要操作

## 技术实现

- 使用Chrome扩展API拦截网络请求
- 通过监听API响应获取视频数据
- 使用Content Script模拟页面滚动
- 数据存储在Chrome本地存储中
- 采用现代CSS3技术（渐变、动画、毛玻璃效果）

## 许可证

MIT