tiktok-scraper-mcp
v1.0.2
Published
MCP server that scrapes all TikTok comments and replies from any video. Runs locally via Puppeteer — no data leaves your machine.
Maintainers
Readme
TikTok Comment Scraper MCP Server
An MCP (Model Context Protocol) server that scrapes all comments and replies from any TikTok video. Works with Claude Desktop, Claude Code, and any MCP-compatible AI assistant.
Runs entirely on your local machine via Puppeteer. No data is sent to external servers (except for subscription verification).
Features
- Full comment extraction — scrapes every comment including nested replies
- Structured JSON output — usernames, text, likes, timestamps, reply threads
- Automatic scrolling — loads all comments by scrolling the comment container
- Reply expansion — clicks "View replies" and "View more" buttons automatically
- Local execution — Puppeteer runs on your machine, using your own IP and session
- Privacy-first — scraped data never leaves your device
Tools
| Tool | Description |
|------|-------------|
| scrape_tiktok_comments | Scrape all comments and replies from a TikTok video URL |
| set_email | Set your subscription email (3 free scrapes, then PRO required) |
| subscription_status | Check your subscription status and remaining free scrapes |
Installation
Claude Desktop
- Install the package:
npm install -g tiktok-scraper-mcp- Add to your Claude Desktop config (
~/Library/Application Support/Claude/claude_desktop_config.jsonon Mac):
{
"mcpServers": {
"tiktok-scraper": {
"command": "tiktok-scraper-mcp"
}
}
}- Restart Claude Desktop.
Claude Code
claude mcp add tiktok-scraper -- npx tiktok-scraper-mcpManual
npx tiktok-scraper-mcpUsage
Once installed, you can ask your AI assistant:
"Scrape all comments from this TikTok video: https://www.tiktok.com/@username/video/1234567890"
The server will:
- Launch a headless Chrome browser
- Navigate to the video
- Scroll to load all comments
- Expand all reply threads
- Extract structured data
- Return JSON with all comments and replies
Example output
{
"videoId": "1234567890",
"url": "https://www.tiktok.com/@username/video/1234567890",
"commentCount": 47,
"replyCount": 123,
"comments": [
{
"index": 1,
"username": "user123",
"text": "This is amazing!",
"likes": "1.2K",
"time": "3d ago",
"replies": [
{
"index": 1,
"username": "creator",
"text": "Thank you!",
"likes": "89",
"time": "2d ago"
}
]
}
]
}Pricing
- 3 free scrapes included — no credit card required
- PRO: $9.67/mo — unlimited scraping, cancel anytime
- Subscribe at: https://buy.stripe.com/4gM00l1OC52Tc7V7YN6EU00
Configuration
Config is stored at ~/.tiktok-scraper-mcp/config.json. Set your email with the set_email tool or by editing the file directly.
Requirements
- Node.js 22+
- Chrome/Chromium (installed automatically by Puppeteer)
Privacy
- Scraping runs locally via Puppeteer — your data never touches our servers
- The only network call is a subscription check (
email→subscribed: true/false) - No analytics, no tracking, no data collection
- Full privacy policy: https://us-central1-benetti-417611.cloudfunctions.net/privacy-policy?product=tiktok-scraper
Support
- Email: [email protected]
- Issues: https://github.com/benetti-corporation/tiktok-scraper-mcp/issues
Built by Benetti Corporation.
If this tool saves you time, consider buying us a beer: PayPal
