← 返回 Skills 市场
140
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install douyin-data-exporter
功能描述
抖音数据导出技能 - 获取用户主页视频数据
使用说明 (SKILL.md)
抖音数据导出技能(含投流数据)
功能
本技能通过 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(用于视频数据)
- 访问 TikHub 官网 注册并登录。
- 在个人中心获取您的 API Token。
- 设置环境变量
TIKHUB_TOKEN,或直接在脚本中修改TIKHUB_TOKEN变量(不推荐硬编码)。
⚠️ 官网链接可能需登录,若无法访问请确认网络或账号状态。
2. 获取投流 API Token 和 Customer ID(用于投流数据)
- Token:联系平台管理员或从 BOSS 系统后台获取有效的 Bearer Token。
- Customer ID:通常为数字标识(如
336),需向平台方确认。
安全使用建议
This skill's functionality (fetching Douyin videos via TikHub and optional douplus exports) appears legitimate, but there are inconsistencies you should weigh before installing:
- The package fails to declare that it needs a TikHub API token (TIKHUB_TOKEN) and that it will read OPENCLAW_ROOT/config.json. Treat these as sensitive: config.json may contain other secrets on your agent host.
- The script will make outbound HTTPS requests to api.tikhub.io and to boss-ip.da-mai.com (the latter for douplus exports). Only provide the douplus Bearer token if you trust that external endpoint and you obtained the token securely.
- The tool asks you to extract sec_user_id and tokens from a browser — avoid sharing full browser session cookies or other secrets when doing so.
Recommendations:
1) Inspect your OPENCLAW_ROOT/config.json before running; consider creating a minimal config file that only contains the tikhub_api_token you intend to use.
2) Run the script in an isolated environment (not on a machine holding other sensitive agent credentials) until you are comfortable with its behavior.
3) Prefer supplying tokens via environment variables or a dedicated config with least privilege, and avoid hardcoding tokens into the script.
4) If you need stronger assurance, request the skill author to update metadata to declare required env vars (TIKHUB_TOKEN) and the config file path, and to document exactly what external endpoints it calls.
能力评估
Purpose & Capability
The code and SKILL.md implement video export via TikHub and optional 'douplus' export via a BOSS endpoint, which matches the skill name/description. However the registry metadata claims no required env vars while both SKILL.md and export.py expect a TikHub token (TIKHUB_TOKEN or config.json key). That omission is an inconsistency that should have been declared.
Instruction Scope
Runtime instructions are straightforward: run export.py with sec_user_id and account name; optionally provide a douplus token/customer id. The script makes outbound HTTPS requests to api.tikhub.io and boss-ip.da-mai.com and saves results to the workspace. It prints request URLs and a REPORT_PATH for other tools to consume. No arbitrary shell execution or obfuscated behavior was found.
Install Mechanism
There is no installer that downloads remote executables; the skill includes a plain Python script and declares Python as a required binary. This is low-install risk. (SKILL.md contains a small 'install' snippet, but there is no external download or archive extraction in the package.)
Credentials
The package metadata lists no required env vars or config paths, yet export.py reads a config file at OPENCLAW_ROOT/config.json and/or the TIKHUB_TOKEN environment variable. Reading OPENCLAW_ROOT/config.json is a meaningful access to the agent's environment and could expose other config contents during execution; the skill also expects a potentially sensitive douplus Bearer token (provided via CLI or browser). These accesses should be declared up front.
Persistence & Privilege
The skill does not request 'always: true', does not modify other skills, and only writes output under the workspace directory. It does not create persistent system services or alter agent configuration beyond reading a config.json.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install douyin-data-exporter - 安装完成后,直接呼叫该 Skill 的名称或使用
/douyin-data-exporter触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Refactored for portability and security. Now reads TIKHUB_TOKEN from config.json and uses dynamic paths.
v1.0.0
Initial release – export Douyin user video and promotion data via command line.
- Fetches Douyin user homepage videos using the TikHub API, supports paging and automatic pagination.
- Optionally exports promotion (投流) order data via BOSS API if a token is provided.
- Supports output in JSON, CSV, and Excel formats; files saved to the workspace.
- Provides detailed parameter explanations and setup instructions for required API tokens.
- Command-line usage and output naming conventions documented in both Chinese and code samples.
元数据
常见问题
Douyin Data Exporter 是什么?
抖音数据导出技能 - 获取用户主页视频数据. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 140 次。
如何安装 Douyin Data Exporter?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install douyin-data-exporter」即可一键安装,无需额外配置。
Douyin Data Exporter 是免费的吗?
是的,Douyin Data Exporter 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Douyin Data Exporter 支持哪些平台?
Douyin Data Exporter 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Douyin Data Exporter?
由 an(@ahsbnb)开发并维护,当前版本 v1.0.1。
推荐 Skills