← Back to Skills Marketplace
140
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install douyin-data-exporter
Description
抖音数据导出技能 - 获取用户主页视频数据
README (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），需向平台方确认。
Usage Guidance
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install douyin-data-exporter - After installation, invoke the skill by name or use
/douyin-data-exporter - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is Douyin Data Exporter?
抖音数据导出技能 - 获取用户主页视频数据. It is an AI Agent Skill for Claude Code / OpenClaw, with 140 downloads so far.
How do I install Douyin Data Exporter?
Run "/install douyin-data-exporter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Douyin Data Exporter free?
Yes, Douyin Data Exporter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Douyin Data Exporter support?
Douyin Data Exporter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Douyin Data Exporter?
It is built and maintained by an (@ahsbnb); the current version is v1.0.1.
More Skills