douyin-data-exporter
## 抖音数据导出技能(含投流数据)
### 功能
本技能通过 TikHub API 获取指定抖音用户的主页视频列表,支持分页和自动翻页;同时可选通过 BOSS 平台接口获取该账号的投流订单导出数据(需提供独立 Token)。所有数据将保存为 JSON 和/或 CSV/Excel 格式到工作区。
### 使用方法
基于真实的 Python 路径,以下为参考命令:
powershell
```
& "F:\\python 3.10\\python.exe" C:\\Users\\EDY\\.openclaw\\skills\\douyin-data-exporter\\export.py `
--sec-user-id "用户的 sec_user_id" `
--account-name "账号名称" `
[--max-videos 100] `
[--export-format both] `
[--douplus-token "投流API Token"] `
[--douplus-customer-id "336"]
```
### 参数说明
| 参数 | 必填 | 说明 |
| :---------------------- | :--- | :------------------------------------------------- |
| `--sec-user-id` | 是 | 抖音用户的 sec_user_id(从浏览器或开发者工具获取) |
| `--account-name` | 是 | 账号名称,用于命名输出文件 |
| `--max-videos` | 否 | 最大获取视频数量,默认 100 |
| `--export-format` | 否 | 视频导出格式:`json`、`csv` 或 `both`,默认 `both` |
| `--douplus-token` | 否 | 投流 API 的 Bearer Token(从浏览器获取) |
| `--douplus-customer-id` | 否 | 投流 API 的 customerId(如 `336`,可从浏览器获取) |
> 注:若同时提供命令行参数和环境变量,命令行参数优先。
### 输出
所有输出文件保存在 `C:\Users\EDY\.openclaw\workspace\data` 目录。
| 数据类型 | 文件格式 | 文件名示例 |
| :----------- | :------------------ | :----------------------------------------------------------- |
| 视频列表 | JSON / CSV | `{account_name}_videos_{timestamp}.json` / `.csv` |
| 投流订单数据 | Excel (xlsx) / JSON | `{account_name}_投流数据_{timestamp}.xlsx`(若 API 返回 Excel) `{account_name}_投流数据_{timestamp}.json`(若返回 JSON) |
| 汇总报告 | JSON | `{account_name}_导出汇总报告_{timestamp}.json` |
### 配置要求
#### 1. 获取 TikHub Token(用于视频数据)
1. 访问 [TikHub 官网](https://user.tikhub.io/register) 注册并登录。
2. 在个人中心获取您的 API Token。
3. 设置环境变量 `TIKHUB_TOKEN`,或直接在脚本中修改 `TIKHUB_TOKEN` 变量(不推荐硬编码)。
> ⚠️ 官网链接可能需登录,若无法访问请确认网络或账号状态。
#### 2. 获取投流 API Token 和 Customer ID(用于投流数据)
- **Token**:联系平台管理员或从 BOSS 系统后台获取有效的 Bearer Token。
- **Customer ID**:通常为数字标识(如 `336`),需向平台方确认。
标签
skill
ai