← 返回 Skills 市场

Grab Douyin - Video Downloader

Name: Grab Douyin - Video Downloader
Author: mfang0126

作者 mfang0126 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

148

总下载

当前安装

版本数

在 OpenClaw 中安装

/install grab-douyin

功能描述

Download Douyin (抖音) videos via the TikHub API — no login required. USE THIS SKILL whenever the user: - Shares a Douyin link (v.douyin.com, douyin.com, or an...

使用说明 (SKILL.md)

Douyin Downloader

Download Douyin videos using the TikHub API. Handles short links, full URLs, and bare video IDs.

Configuration

Requires a TikHub API token in ~/.openclaw/config.json:

{ "tikhub_api_token": "your-token-here" }

Free tokens: https://user.tikhub.io/register

Workflow

Detect input — identify a Douyin link or modal_id from the user's message
Run the script — call python3 {baseDir}/scripts/douyin_download.py
Show result — report the modal_id and either the video URL or the saved file path

Commands

Get video info (no download)

python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/"

Download to default location (~/Downloads/douyin/)

python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/" --download

Download to a custom directory

python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/" --download --output-dir /path/to/dir

Use a bare modal_id

python3 {baseDir}/scripts/douyin_download.py "7615599455526585067" --download

Accepted Input Formats

Format	Example
Short link	`https://v.douyin.com/iABCxyz/`
Full URL with modal_id	`https://www.douyin.com/video/7615599455526585067`
URL query param	`https://www.douyin.com/jingxuan?modal_id=7615599455526585067`
Bare modal_id	`7615599455526585067`

Output

Without --download: prints modal_id + direct video URL
With --download: downloads to ~/Downloads/douyin/douyin_\x3Cmodal_id>.mp4 (or custom dir)

安全使用建议

What to check before installing: (1) The SKILL.md and script expect a TikHub API token stored at ~/.openclaw/config.json — this was not declared in the skill metadata; verify you are comfortable storing a token there and that the file contains only that token. (2) The skill will make outbound HTTP requests to api.tikhub.io and to Douyin video URLs and will save files to your filesystem (default ~/Downloads/douyin). (3) SKILL.md instructs the agent to 'always' use this skill when it detects a Douyin URL, which can cause automatic network activity and file writes; if you prefer explicit consent, disable autonomous invocation or require confirmation. (4) Source is unknown — if you rely on trust, ask the publisher for provenance or audit the code yourself (the included Python script is short and readable). (5) Ensure your environment has Python3 and the requests library or sandbox the skill if you want to limit potential misuse.

功能分析

Type: OpenClaw Skill Name: grab-douyin Version: 1.0.0 The skill is a legitimate tool for downloading Douyin videos using the TikHub API. It reads a specific API token from a local configuration file (~/.openclaw/config.json) and interacts with the documented API endpoint (api.tikhub.io) to fetch and download video content to the user's Downloads folder. No evidence of data exfiltration, malicious execution, or obfuscation was found in scripts/douyin_download.py or the SKILL.md instructions.

能力评估

⚠ Purpose & Capability

The code and SKILL.md implement a Douyin downloader via the TikHub API (network calls, short-link resolution, and saving to ~/Downloads/douyin). That aligns with the name/description. However, the registry metadata lists no required env vars or config paths, while SKILL.md and the script require a TikHub API token stored at ~/.openclaw/config.json. This metadata/instruction mismatch is inconsistent and should have been declared.

⚠ Instruction Scope

SKILL.md instructs the agent to 'Always use this skill when you detect a Douyin URL' — giving the agent broad, automatic discretion to call the included script, perform network requests, and save files without explicit additional user consent. The runtime instructions also require reading ~/.openclaw/config.json for the token and performing HTTP requests to api.tikhub.io and the returned video URL; these actions are within purpose but the automatic-invoke directive is broad.

ℹ Install Mechanism

There is no install spec (instruction-only + included Python script), so nothing is downloaded at install time. The script depends on Python and the 'requests' package (not declared in metadata). This approach has low install risk but assumes the runtime has Python and requests available.

⚠ Credentials

The script legitimately needs a TikHub API token, but that credential is expected in a config file (~/.openclaw/config.json) rather than an env var; the skill registry metadata did not declare this required config path or credential. Reading a user-home config file is a sensitive action and the missing declaration is an incoherence the user should be aware of.

ℹ Persistence & Privilege

The skill does not request 'always: true' and does not modify other skills or system-wide settings. However, because SKILL.md tells the agent to always use this skill when a Douyin URL is seen, the autonomous-invocation default could lead to automatic downloads; consider requiring user confirmation before downloads if you want to limit that behavior.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install grab-douyin
安装完成后，直接呼叫该 Skill 的名称或使用 /grab-douyin 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

TikHub API based Douyin video downloader. Short link resolution, streaming download, custom output dir. No login, no watermark.

元数据

Slug grab-douyin

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题