A comprehensive browser-based tool for discovering and scraping TikTok profile data, engagement metrics, and thumbnails without API keys.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tiktok-scraper-2
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-scraper-2 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 Profile Scraper?
The TikTok Profile Scraper is a production-ready skill designed for the Openclaw Skills ecosystem, enabling developers and marketers to gather rich social media intelligence. It utilizes Python and Playwright to simulate human browsing behavior, bypassing the need for official API keys while ensuring high data accuracy. By combining advanced browser fingerprinting with stealth scripts, this skill provides a robust solution for extracting profile details, follower counts, and content thumbnails.
This tool is particularly valuable for those looking to scale their influencer research or market analysis within the Openclaw Skills framework. It offers a two-phase workflow that first discovers potential targets based on geographical location and category, then systematically scrapes detailed metrics, making it an essential asset for data-driven social media strategies.
TikTok Profile Scraper Use Cases
- Identifying trending influencers in specific niches and locations for marketing campaigns.
- Automating the collection of creator metrics like follower growth and engagement rates.
- Building a localized database of TikTok profiles for competitive research.
- Gathering content thumbnails and profile bios for sentiment analysis or creative auditing.
How TikTok Profile Scraper Works
- The skill initiates Profile Discovery by querying location and category data, often using Google Custom Search for high-relevance results.
- Discovered profiles are queued into a local data structure for systematic processing.
- The Browser Scraping phase launches a Playwright-controlled browser instance with human-like behavior patterns and anti-detection scripts.
- The scraper visits each profile, extracts metadata (bio, followers, likes), and downloads specified content thumbnails.
- All extracted data is validated against pre-configured filters like minimum follower counts or account privacy settings.
- Final results are exported into structured JSON or CSV formats for easy integration.
TikTok Profile Scraper Setup
Prerequisites
Ensure you have Python 3 and Chromium installed on your system.
Installation
# Navigate to your agent's skill directory
# Install dependencies
pip install -r requirements.txt
playwright install chromium
Basic Usage
# Discover profiles by location and category
discover --location "Miami" --category "dance" --output json
# Scrape a specific profile
scrape --username charlidamelio --output json
TikTok Profile Scraper Data Schema & Taxonomy
| Field | Type | Description |
|---|---|---|
| username | String | The unique TikTok handle |
| followers | Integer | Total count of followers |
| bio | String | The profile's biography text |
| influencer_tier | String | Categorization (nano, micro, mid, macro, mega) |
| profile_pic_local | String | Local path to the downloaded profile image |
| video_views | Array | View counts and display strings for recent content |
TikTok Profile Scraper Advanced Features
- Built-in residential proxy support with automatic IP rotation for providers like Bright Data and IProyal.
- Stealth browser fingerprinting and human behavior simulation to evade bot detection.
- Automated influencer tiering based on follower ranges from nano to mega.
- Session resumption capabilities to pick up scraping tasks after interruptions.
- Configurable filtering to skip private accounts, low-engagement profiles, or accounts without content.
SKILL.md
Loading
Related Openclaw Skills
Jina Reader & Search Skill
A powerful utility to fetch web pages as LLM-friendly markdown and perform structured web searches using Jina AI APIs.
Gemini Guide
A comprehensive developer assistant for integrating Google Gemini multimodal models with ultra-long context windows and native media understanding.
Academic Research Hub
A centralized power-tool for academic discovery that searches multiple databases, manages citations, and aggregates research materials for systematic reviews.
Supply Chain Optimization for TikTok Shop
A specialized diagnostic tool designed for TikTok Shop sellers to identify supply chain bottlenecks, optimize affiliate payouts, and manage viral product lifecycles.
Google Maps
A unified Google Maps integration for AI agents to handle geocoding, place details, and routing through the OneKey Gateway.
PolySports Trading Agent
A conversational AI agent skill for executing structured PolySports trades and managing autonomous betting workflows via Openclaw Skills.
Featured*
