Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Downloads TikTok videos, audio, and metadata using yt-dlp. Supports single videos, full profiles, hashtag pages, keyword searches, and sound pages. Metadata exports to JSON, JSONL, or CSV for further analysis.
Handles bulk downloads, incremental archiving, metadata export, and content filtering in one CLI tool without requiring a TikTok API key or developer account.
When to use it
- Archive all videos from a creator's profile locally
- Track new posts from multiple accounts on a daily cron schedule
- Export engagement metrics to CSV for cross-creator comparison
- Filter a hashtag page by view count or date range
- Dry-run metadata collection without downloading video files
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: scrape @examplecreator videos from the last 7 days with over 50k views and export metadata
- 1Run yt-dlp with --simulate and --dump-json on the profile URL
- 2Apply --dateafter with a 7-day relative date filter
- 3Apply --match-filters 'view_count >= 50000'
- 4Redirect output to handle_videos.jsonl
- 5Parse results with jq to extract title, view count, and URL
JSONL file with filtered video metadata ready for analysis in pandas or jq
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.