tiktok-product-scraper

Scrape TikTok Shop product data into structured JSON and Markdown reports.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/tinnlo/lukas_9688 --skill tiktok-product-scraper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tiktok-product-scraper
Source: https://github.com/tinnlo/lukas_9688/tree/main/.claude/skills/tiktok_product_scraper
Command: npx skills add https://github.com/tinnlo/lukas_9688 --skill tiktok-product-scraper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates collecting TikTok Shop product data from multiple sources, producing structured JSON and a human-friendly MD report, and optionally downloading reference videos for deeper analysis.

Core Features & Use Cases

  • Multi-source scraping with auto-fallback: Primary source tabcut.com and a fallback to fastmoss.com when data is incomplete.
  • Output formats: Generates tabcut_data.json (or fastmoss_data.json) and a corresponding tabcut_data.md for review, plus optional video assets in ref_video/.
  • n8n integration: Designed to run as an n8n workflow node with Bash commands to orchestrate steps.
  • Batch and automation: Supports batch processing via CSV and automates JSON-to-MD conversion for review.

Quick Start

  1. Install Python and create a virtual environment, then install dependencies from requirements.txt.
  2. Configure credentials in scripts/config/.env (Tabcut and FastMoss).
  3. Run the scraper for a single product (with optional video downloads):
    • python run_scraper.py --product-id <PRODUCT_ID> --download-videos --output-dir "../product_list/YYYYMMDD"
    • or without --download-videos if only metadata is needed.
  4. Convert the JSON to Markdown for review using the provided helper script:
    • python convert_json_to_md.py <PRODUCT_ID> --date YYYYMMDD

Frequently Asked Questions about tiktok-product-scraper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape TikTok Shop product data in JSON format?

You can scrape TikTok Shop product data into structured JSON by running a Python scraper that pulls from tabcut.com and falls back to fastmoss.com, automatically generating tabcut_data.json.

Can I download TikTok product reference videos during the scraping process?

Yes, you can download TikTok product reference videos during scraping by passing the --download-videos flag, which saves video assets directly into a dedicated ref_video directory.

Does this TikTok scraper support batch processing and n8n workflow integration?

Yes, this TikTok scraper supports batch product extraction via CSV inputs and seamless n8n workflow integration through deterministic Bash command execution.

What do I need to set up before scraping TikTok Shop product data?

Before scraping TikTok Shop product data, you need to install Python, create a virtual environment, install requirements.txt dependencies, and configure credentials in scripts/config/.env.

How do I convert scraped TikTok product JSON data into a readable report?

You can convert scraped TikTok product JSON data into a human-readable report by running the convert_json_to_md.py helper script, which generates a corresponding Markdown file.

What happens if the primary TikTok data source fails to return complete product details?

If the primary TikTok data source fails to return complete product details, the scraper automatically triggers a fallback from tabcut.com to fastmoss.com to ensure continuous data extraction.