A comprehensive command-line framework for automated TikTok video downloading, profile crawling, and metadata extraction.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tiktok-crawling
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tiktok-crawling using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TikTok Scraping with yt-dlp?
This skill utilizes the powerful yt-dlp engine to facilitate advanced TikTok content harvesting and analysis. It is designed for developers and researchers who need a reliable way to archive videos, track creator profiles, and extract detailed engagement metrics without manual effort. By implementing this within the ecosystem of Openclaw Skills, users can transform raw social media data into structured datasets for market research, trend analysis, or personal archival.
The tool handles the complexities of TikTok's platform, including format selection, watermark management, and rate-limiting, while providing a flexible command-line interface. Whether you are targeting a single viral video or an entire library of creator content, this skill provides the necessary patterns and filters to streamline your workflow.
TikTok Scraping with yt-dlp Use Cases
- Archiving entire creator profiles for offline viewing and content backup.
- Monitoring specific hashtags or sounds to identify emerging viral trends.
- Extracting engagement data (likes, views, titles) into JSON or CSV for competitive analysis.
- Automated daily scraping of trending videos using scheduled scripts.
- High-speed downloading of specific video formats without watermarks.
How TikTok Scraping with yt-dlp Works
- Set up the local environment by installing the yt-dlp CLI and FFmpeg for video processing.
- Define the target source, which can be a single video URL, a user profile, a hashtag, or a search query.
- Apply metadata filters to include or exclude content based on upload date, view count, or duration.
- Configure the output template to automatically organize files into a logical directory structure.
- Use authentication tokens or browser cookies to ensure consistent access and bypass anonymous rate limits.
- Run the scraping process to generate video files and corresponding .info.json metadata files for further processing.
TikTok Scraping with yt-dlp Setup
To begin using this skill with Openclaw Skills, you must first install the required CLI tools:
# macOS installation
brew install yt-dlp ffmpeg
# Python-based installation
pip install yt-dlp
Ensure FFmpeg is available in your PATH to enable the tool to merge video and audio streams correctly.
TikTok Scraping with yt-dlp Data Schema & Taxonomy
The skill produces a structured data output designed for easy integration with analysis tools. The default organization follows this pattern:
| File Type | Path/Template | Purpose |
|---|---|---|
| Video | %(uploader)s/%(upload_date)s-%(id)s/video.mp4 |
The actual media content |
| Metadata | video.info.json |
Detailed video stats (views, likes, tags) |
| Export | handle_videos.jsonl |
Line-delimited JSON for bulk processing |
| Analysis | metadata.csv |
Flattened data for Excel or Pandas |
| Archive | downloaded.txt |
Tracking file to prevent duplicate downloads |
TikTok Scraping with yt-dlp Advanced Features
- Incremental updates: Use the download-archive feature to only fetch new content since the last run.
- Complex Filtering: Target specific content using boolean logic (e.g., videos > 100k views and < 60 seconds).
- Authentication Support: Seamlessly import cookies from browsers like Chrome or Firefox to access restricted content.
- Scripted Automation: Wrap commands in Bash or Python scripts to create persistent Openclaw Skills monitoring agents.
- Post-Processing Analysis: Integrate with jq for instant command-line data aggregation and metric calculation.
SKILL.md
Loading
Related Openclaw Skills
zh-knowledge-manager
A powerful AI-enhanced system for converting unstructured agent logs into structured, searchable Chinese knowledge bases.
Draw.io Diagram Generation
Automatically generate and export professional-grade architectural, database, and process diagrams directly from your AI agent.
Daily Tang Poem
A comprehensive AI agent skill for daily Tang poetry learning, featuring interactive recitation verification and Ebbinghaus-based review cycles.
Book of the Day
A daily book oracle skill that delivers uplifting book recommendations and poetic fortunes to inspire your day.
Poseidon OTC Skill
A trustless P2P trading protocol for Solana that enables AI agents and humans to execute atomic token swaps through secure on-chain escrow.
Agent Skills Security Tools
A specialized security auditing suite designed to scan, validate, and secure AI agent skill packages against vulnerabilities and credential leaks.
Featured*
