pinterest

name	pinterest
description	Search and browse Pinterest pins, get pin details, and send actual images to the user via Telegram/messaging. Use when the user wants to find inspiration, search for images/ideas, or browse Pinterest content. Sends images directly, not just links.

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="https://www.pinterest.com/search/pins/?q=YOUR+SEARCH+TERMS"
browser action=snapshot

Step 2: Get High-Res Image URLs

From the snapshot, find image URLs. Pinterest images follow this pattern:

• Thumbnail: https://i.pinimg.com/236x/...
• Medium: https://i.pinimg.com/564x/...
• High-res: https://i.pinimg.com/originals/...

To get high-res: replace 236x or 564x with originals in the URL.

Step 3: Send Images to User

Send actual image (not link!):

message action=send media="https://i.pinimg.com/originals/xx/xx/image.jpg" message="Pin description here"

Send multiple images:

message action=send media="https://i.pinimg.com/originals/..." message="Option 1: Modern minimal"
message action=send media="https://i.pinimg.com/originals/..." message="Option 2: Cozy rustic"

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 <img> with src containing i.pinimg.com
• Convert to originals: https://i.pinimg.com/originals/{hash}.jpg

Example: "Find me minimalist desk setups"

# 1. Search
browser action=navigate url="https://www.pinterest.com/search/pins/?q=minimalist+desk+setup"
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="https://i.pinimg.com/originals/ab/cd/ef123.jpg" message="Clean white desk with plant 🌿"
message action=send media="https://i.pinimg.com/originals/gh/ij/kl456.jpg" message="Wooden desk, natural light ☀️"

Alternative: Screenshot Method

If image URL extraction is tricky, screenshot the pin:

browser action=navigate url="https://www.pinterest.com/pin/123456/"
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