Do you send actual images or links?

Actual images are sent using the media parameter, not just links.

What if high-resolution URLs can’t be found?

Use the screenshot method to share a pin view when extraction is tricky.

Is there an API option for Pinterest?

Yes. API usage requires OAuth token setup (see references/oauth-setup.md) and may involve scripts like pinterest_api.py.

@cyberfront-ai

npx machina-cli add skill @cyberfront-ai/pinterest --openclaw

Files (1)

SKILL.md

3.2 KB

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

Navigate to Pinterest search
Snapshot to see results
Click on a pin for details (gets larger image)
Screenshot the pin detail page OR extract originals URL
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

Source

git clone https://clawhub.ai/cyberfront-ai/pinterestView on GitHub

Overview

Pinterest skill lets you search and browse Pinterest pins, view pin details, and send actual high-resolution images directly to chat. Instead of links, you get the images in Telegram or messaging streams, helping users quickly find inspiration or product visuals. This makes collaboration and moodboarding faster and more visual.

How This Skill Works

Users search Pinterest via a browser action, then extract high-res image URLs (originals) from pin images. The skill sends images with the media parameter, or uses a screenshot method if needed; an optional API method uses OAuth tokens to access a user's content.

When to Use It

Searching for minimalist desk or home office ideas to share in chat
Building a visual mood board for a project or client presentation
Gathering high-res product or lifestyle images for social posts or marketing
Curating travel or lifestyle inspiration for planning
Sharing multiple images in a chat conversation without leaving the app

Quick Start

Step 1: Search Pinterest by navigating to a pins search URL and snapshot the results
Step 2: From the snapshot, locate i.pinimg.com originals URLs and convert them to high-res
Step 3: Send images with media= URLs and add descriptive messages

Best Practices

Always send actual images with the media= parameter, not just links
Prefer originals URLs (https://i.pinimg.com/originals/...) for best quality
Bundle multiple images by sending separate media messages with descriptive captions
If image URL extraction is tricky, use the Screenshot Method to share the pin view
For user-owned content, consider the API method with OAuth setup

Example Use Cases

Find minimalist desk setups and send two high-res images with captions
Curate a living room mood board by sharing three images with notes
Search travel imagery and forward landscape photos for a blog post
Pull product-style shots for an Instagram promo and include product details
If pins are hard to pull URLs for, send a clear pin screenshot with a description

Frequently Asked Questions

Add this skill to your agents