Search & ResearchDocumentedScanned

pinterest

Search and browse Pinterest pins, get pin details, and send actual images to the user.

Share:

Installation

npx clawhub@latest install pinterest

View the full skill documentation and source below.

Documentation

Pinterest Skill

Search, browse, and share Pinterest pins — sends actual images to chat, not just links.

Quick Search & Send Images

Step 1: Search Pinterest

browser action=navigate url=""
browser action=snapshot

Step 2: Get High-Res Image URLs

From the snapshot, find image URLs. Pinterest images follow this pattern:
  • Thumbnail: - Medium:
  • **High-res: To get high-res: replace 236x or 564x with originals in the URL. ### Step 3: Send Images to User **Send actual image (not link!):** __CODE_BLOCK_1__ **Send multiple images:** __CODE_BLOCK_2__ ## Detailed Pin Workflow 1. **Navigate** to Pinterest search 2. **Snapshot** to see results 3. **Click** on a pin for details (gets larger image) 4. **Screenshot** the pin detail page OR extract originals URL 5. **Send image** via message tool with media= parameter ### Getting Original Images When on a pin detail page: - Look for with src containing i.pinimg.com - Convert to originals:

Example: "Find me minimalist desk setups"

# 1. Search
browser action=navigate url=""
browser action=snapshot

# 2. Extract image URLs from snapshot (look for i.pinimg.com)
# 3. Convert to high-res originals

# 4. Send images
message action=send media="" message="Clean white desk with plant 🌿"
message action=send media="" message="Wooden desk, natural light ☀️"

Alternative: Screenshot Method

If image URL extraction is tricky, screenshot the pin:

browser action=navigate url=""
browser action=screenshot
# Then send the screenshot file
message action=send filePath="/path/to/screenshot.jpg" message="Here's the pin!"

API Method (For User's Own Content)

Requires OAuth token setup — see references/oauth-setup.md

export PINTEREST_ACCESS_TOKEN="your_token"
python3 scripts/pinterest_api.py boards
python3 scripts/pinterest_api.py board-pins <board_id>
python3 scripts/pinterest_api.py pin <pin_id>

Key Points

  • Always send images directly using media= parameter
  • ✅ Use originals URLs for high-res
  • ❌ Don't just send links — send the actual image
  • 💡 If URL doesn't work, screenshot the pin and send that

References

  • OAuth setup: references/oauth-setup.md
  • API endpoints: references/api-reference.md