Pinterest Scraper

Pinterest Scraper

Full-featured Pinterest image scraper with automatic scrolling and multiple output options.

When This Skill Activates

This skill triggers when user wants to download images from Pinterest.

Reasoning Framework

| Step | Action | Why | |------|--------|-----| | 1 | EXTRACT | Parse Pinterest URL to determine board/user/search | | 2 | LAUNCH | Start Playwright browser with stealth options | | 3 | SCROLL | Incrementally load images (Pinterest uses infinite scroll) | | 4 | COLLECT | Extract image URLs with quality selection | | 5 | DEDUP | Hash-based duplicate detection | | 6 | DOWNLOAD | Save images to output folder | | 7 | NOTIFY | Optional: send to Telegram |

Setup

pip install playwright requests
playwright install chromium

Decision Tree

What are you trying to do?

├── Download images from a board/user
│   └── Use: -u "URL" -s [scrolls]
│
├── Get highest quality possible
│   └── Use: -q originals
│
├── Get smaller/faster downloads
│   └── Use: -q 736x or 236x
│
├── Send images to phone
│   └── Use: --telegram --token X --chat Y
│
├── Resume interrupted scrape
│   └── Use: --resume
│
└── Debug issues
    └── Use: -v (verbose logging)

Quality Selection Decision

| Quality | Use Case | File Size | |---------|----------|-----------| | originals | Best quality, archiving | Largest | | 736x | Good balance | Medium | | 474x | Thumbnail quality | Small | | 236x | Preview only | Smallest | | all | Save every version | Largest total |

Usage

Command Line

python scrape_pinterest.py -u "URL" [options]

| Option | Description | Default | |--------|-------------|---------| | -u, --url | Pinterest URL (required) | - | | -s, --scrolls | Number of scrolls | 50 | | -o, --output | Output folder | ./pinterest_output | | -q, --quality | Quality: originals/736x/474x/236x/all | originals | | -v, --verbose | Enable verbose logging | false | | --telegram | Send images to Telegram | false | | --token | Telegram bot token | - | | --chat | Telegram chat ID | - | | --resume | Resume from previous scrape | false | | --dedup | Skip duplicates | true | | --no-dedup | Disable deduplication | - | | --telegram-only | Only send existing files | false |

Common Examples

# Basic scrape (50 scrolls, originals, current dir)
python scrape_pinterest.py -u "URL"
Verbose mode (logs to console + scrape.log)
python scrape_pinterest.py -u "URL" -v
More scrolls, custom output, medium quality
python scrape_pinterest.py -u "URL" -s 100 -o ./output -q 736x -v
With Telegram delivery
python scrape_pinterest.py -u "URL" --telegram --token "TOKEN" --chat "CHAT_ID"
Resume interrupted scrape
python scrape_pinterest.py -u "URL" --resume -v
Show help
python scrape_pinterest.py --help

Python API

This tool is CLI-based. Run it from your Python code:

import subprocess
import os
Run the scraper
result = subprocess.run(
    ['python3', 'scrape_pinterest.py', '-u', 'URL', '-s', '50', '-q', 'originals'],
    cwd='./scripts',
    capture_output=True,
    text=True
)
print(result.returncode)  # 0 = success
print(result.stdout)

Features

| Feature | Description | |---------|-------------| | Infinite Scroll | Automatic scrolling loads more images | | Quality Options | originals/736x/474x/236x/all | | Telegram | Send directly to Telegram | | Deduplication | Hash-based duplicate detection | | Resume | Continue from previous scrape | | URL Types | Boards, user profiles, search results | | Verbose Logging | -v flag, logs to console + scrape.log |

Verbose Logging

Use -v or --verbose for detailed logging:

python scrape_pinterest.py -u "URL" -v

What gets logged:

Log files:

Troubleshooting

Problem: No images downloaded

Problem: "Browser not found"

Problem: SSL certificate errors (Mac)

Problem: Duplicate images

Problem: Resume not working

Problem: Telegram not sending

Problem: Verbose logs not writing

Self-Check

Notes

Quick Reference

| Task | Command | |------|---------| | Basic scrape | python scrape_pinterest.py -u "URL" | | Verbose debug | python scrape_pinterest.py -u "URL" -v | | High quality | python scrape_pinterest.py -u "URL" -q originals | | Fast/small | python scrape_pinterest.py -u "URL" -q 236x | | Send to Telegram | python scrape_pinterest.py -u "URL" --telegram --token X --chat Y | | Resume | python scrape_pinterest.py -u "URL" --resume | | Custom output | python scrape_pinterest.py -u "URL" -o ./myfolder |

Command Line

python scrape_pinterest.py -u "URL" [options]

| Option | Description | Default | |--------|-------------|---------| | -u, --url | Pinterest URL (required) | - | | -s, --scrolls | Number of scrolls | 50 | | -o, --output | Output folder | ./pinterest_output | | -q, --quality | Quality: originals/736x/474x/236x/all | originals | | -v, --verbose | Enable verbose logging | false | | --telegram | Send images to Telegram | false | | --token | Telegram bot token | - | | --chat | Telegram chat ID | - | | --resume | Resume from previous scrape | false | | --dedup | Skip duplicates | true | | --no-dedup | Disable deduplication | - | | --telegram-only | Only send existing files | false |

Common Examples

# Basic scrape (50 scrolls, originals, current dir)
python scrape_pinterest.py -u "URL"
Verbose mode (logs to console + scrape.log)
python scrape_pinterest.py -u "URL" -v
More scrolls, custom output, medium quality
python scrape_pinterest.py -u "URL" -s 100 -o ./output -q 736x -v
With Telegram delivery
python scrape_pinterest.py -u "URL" --telegram --token "TOKEN" --chat "CHAT_ID"
Resume interrupted scrape
python scrape_pinterest.py -u "URL" --resume -v
Show help
python scrape_pinterest.py --help

pip install playwright requests
playwright install chromium