An automated tool for scraping Pinterest search results to collect high-resolution images, descriptions, and direct links using infinite scroll technology.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install phy-pinterest-scraper
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 phy-pinterest-scraper 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 Pinterest Search Scraper?
The Pinterest Search Scraper is a robust tool designed to programmatically extract visual data from one of the world's largest discovery engines. Leveraging Crawlee's PlaywrightCrawler, this skill navigates the complex, infinite-scrolling architecture of Pinterest without requiring a user login. It is an essential component of the Openclaw Skills library for developers needing to build datasets, monitor visual trends, or automate mood board creation.
This scraper efficiently handles DOM extraction and resolves image source sets to ensure you always capture the highest resolution available. By automating the browsing behavior, it allows researchers and developers to bypass the manual effort of saving individual pins, providing a structured output ready for analysis or integration into larger AI workflows.
Pinterest Search Scraper Use Cases
- Visual trend research to identify emerging patterns in design and fashion.
- Large-scale image dataset creation for training computer vision or machine learning models.
- Automated content planning by analyzing high-performing visual themes within specific niches.
- Competitive analysis to understand the visual branding strategies dominating various categories.
- Rapid mood board generation for designers and creative directors.
How Pinterest Search Scraper Works
- The scraper initializes a headless browser session and navigates to the Pinterest search URL based on the user-provided query.
- It identifies pin elements within the page structure using specialized CSS selectors like data-test-id.
- An iterative scrolling loop is executed to trigger Pinterest's infinite load mechanism, allowing for deep data retrieval.
- JavaScript is injected into the browser context to extract pin IDs, URLs, and high-resolution image source sets from the DOM.
- The data is deduplicated by unique ID and collected until the specified pin limit or scroll maximum is reached.
- All captured data is saved to a local JSON file for easy processing.
Pinterest Search Scraper Setup
To use this skill, you must install the required Python packages and the Chromium browser binary:
pip install crawlee[playwright]
playwright install chromium
Once installed, you can execute the scraper directly from the CLI:
python pinterest_scraper.py "minimalist home decor" 30
Pinterest Search Scraper Data Schema & Taxonomy
The scraper generates structured JSON files located in ./storage/pinterest/<query>.json. Each pin is represented as an object with the following fields:
| Field | Type | Description |
|---|---|---|
id |
String | The unique Pinterest pin identifier. |
url |
String | The direct link to the Pinterest pin page. |
image_url |
String | The URL for the highest resolution version of the image. |
description |
String | The alt text or description associated with the image. |
Pinterest Search Scraper Advanced Features
- Headless and headed mode support for easy debugging and visual verification of the scraping process.
- Customizable scroll parameters including max_scroll_attempts and scroll_delay to optimize for different network conditions.
- Smart image resolution logic that automatically parses srcset to avoid low-quality thumbnails.
- Easy integration into Python pipelines using the PinterestScraper class for automated data collection.
- Robust error handling for common issues like Pinterest DOM updates or rate limiting within Openclaw Skills environments.
SKILL.md
Loading
Related Openclaw Skills
Instagram Public Profile Scraper
A lightweight Python tool for scraping public Instagram profile metrics and recent post data without requiring a login or browser automation.
Founder Content System
A complete content creation and multiplication system designed for solo founders and indie hackers to scale their presence across social platforms.
FAL Image Generation Skill
A high-performance image generation skill supporting fal.ai and BytePlus Seedream for reference-guided, batch, and high-resolution visual creation.
Daily Social Media Routine
A structured 15-20 minute engagement routine designed to help indie developers and founders build a consistent social presence across multiple platforms.
Reddit Karma Scanner
An automated Reddit opportunity scanner that identifies high-potential posts and generates professional, AI-powered comments for strategic karma building.
Social Posting Skill
A multi-platform social media distribution service with automatic provider failover and support for nine major social networks.
Featured*
