tiktok-scraper-mcp 1.0.0

package/README.md

@@ -0,0 +1,130 @@
+# TikTok Comment Scraper MCP Server
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 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
+
+1. Install the package:
+```bash
+npm install -g tiktok-scraper-mcp
+```
+
+2. Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):
+```json
+{
+  "mcpServers": {
+    "tiktok-scraper": {
+      "command": "tiktok-scraper-mcp"
+    }
+  }
+}
+```
+
+3. Restart Claude Desktop.
+
+### Claude Code
+
+```bash
+claude mcp add tiktok-scraper -- npx tiktok-scraper-mcp
+```
+
+### Manual
+
+```bash
+npx tiktok-scraper-mcp
+```
+
+## Usage
+
+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:
+1. Launch a headless Chrome browser
+2. Navigate to the video
+3. Scroll to load all comments
+4. Expand all reply threads
+5. Extract structured data
+6. Return JSON with all comments and replies
+
+### Example output
+
+```json
+{
+  "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: benettimedia@gmail.com
+- Issues: https://github.com/benetti-corporation/tiktok-scraper-mcp/issues
+
+Built by [Benetti Corporation](https://github.com/benetti-corporation).
+
+If this tool saves you time, consider buying us a beer: [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WXQKYYKPHWXHS)

package/build/index.d.ts

@@ -0,0 +1 @@
+export {};