Skip to content
Skills Library
Marketing & content · Tool integration

pinterest

/pinterest

Read Pinterest boards and Pins and create new image Pins through the official Pinterest API v5. Use when the user mentions Pinterest, boards, Pins, visual distribution, or publishing a generated image to Pinterest.

Repository
Skills ↗
Licence
Apache-2.0
Last repository change
25.10.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
2
HTML comments
0
URLs in SKILL.md
4
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 2 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/pinterest.py, tests/test_pinterest.py

What it does and when to use it

Read Pinterest boards and Pins and create new image Pins through the official Pinterest API v5. Use when the user mentions Pinterest, boards, Pins, visual distribution, or publishing a generated image to Pinterest.

Original author description

Read Pinterest boards and Pins and create new image Pins through the official Pinterest API v5. Use when the user mentions Pinterest, boards, Pins, visual distribution, or publishing a generated image to Pinterest.

How it works

  1. Create an image Pin
Original SKILL.md headings · 51 lines, 282 words
SKILL.md preview
---
name: pinterest
description: Read Pinterest boards and Pins and create new image Pins through the official Pinterest API v5. Use when the user mentions Pinterest, boards, Pins, visual distribution, or publishing a generated image to Pinterest.
when_to_use: |
  Trigger when the user wants to inspect their Pinterest account or boards,
  list Pins, or publish user-created visual content to a board. Creating a Pin
  requires explicit confirmation.
connections: [pinterest]
allowed_tools: [Bash, publish_artifact]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

# Pinterest API v5

Use the official API through the bundled standard-library client. The user's
OAuth token is injected as `$PINTEREST_TOKEN`; never print it.

```bash
P="$SKILL_DIR/scripts/pinterest.py"
[ -f "$P" ] || P=$(find /tmp -maxdepth 8 -path '*/skills/*/pinterest/scripts/pinterest.py' 2>/dev/null | head -1)
[ -f "$P" ] || { echo "pinterest script not found" >&2; exit 1; }

python3 "$P" whoami
python3 "$P" boards --limit 25
python3 "$P" pins --board-id BOARD_ID --limit 25
```

## Create an image Pin

Pinterest's content API is for new content created by the user. Do not copy or
republish third-party images without authorization.

```bash
python3 "$P" create --board-id BOARD_ID --title "Title" \
  --description "Description" --link "https://example.com/article" \
  --image-url "https://cdn.example.com/pin.jpg"

python3 "$P" create --board-id BOARD_ID --title "Title" \
  --description "Description" --link "https://example.com/article" \
  --image-url "https://cdn.example.com/pin.jpg" --confirm
```

The first call is a dry run. Show the final image, title, description, board,
and link to the user before the confirmed call. The image URL must be public
HTTPS and point to content the user is entitled to publish.

Common failures:

| HTTP | Meaning | Action |
|---|---|---|
| 401 | Token expired or revoked | Reconnect Pinterest |
| 403 | Missing scope or app access | Ensure `pins:write`/`boards:read` were approved |
| 404 | Board not found | Re-list boards under the connected account |
| 429 | Pinterest rate limit | Stop and retry later; do not loop |

If a confirmed create ends with a network error, the result is unknown. Do not
repeat it. List the target board's Pins and compare title/link before deciding
whether a second create is safe.

After a confirmed create returns a real URL, record it once with
`publish_artifact(kind="image", channel="pinterest", ...)`.
Files in this package (3)
  • SKILL.md 2 KB
  • scripts/pinterest.py 5 KB
  • tests/test_pinterest.py 4 KB

Versions

The database has no other skills named pinterest.

Database snapshot: 13.11.2026 · package version 40d9f8d02544 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100pinterest-research
    Researches Pinterest profiles, boards, pins, ideas categories, and search results via the Crawlora API, returning clean JSON. Use when the user wants a Pinterest user's profile/boards/pins, a pin's or board's detail, a category feed, or a keyword search on Pinterest — instead of…
  • 85pinterest-posts
    When the user wants to create Pinterest Pins, optimize Pin descriptions, or grow Pinterest presence. Also use when the user mentions "Pinterest," "Pin," "Pinterest SEO," "Pinterest description," "Pinterest board," or "Pinterest marketing." For asset specs, use visual-content.
  • 100pinterest-organic-manager
    Audits an organic Pinterest account, ranks pins and boards by saves and outbound clicks, finds Pinterest Trends keywords, plans seasonal pins and writes pin copy. Use when asked for a Pinterest audit, Pinterest keywords or a pin from a blog post. Not for Pinterest Ads (use pinterest-ads-manager)
  • 95scrapall-pinterest
    Use when the user asks for public Pinterest data (Board, Pin, Search, User Boards). Calls the Scrapall REST API with the X-Scapi-Key header.
  • 85pinterest-posts
    When the user wants to create Pinterest Pins, optimize Pin descriptions, or grow Pinterest presence. Also use when the user mentions "Pinterest," "Pin," "Pinterest SEO," "Pinterest description," "Pinterest board," or "Pinterest marketing." For asset specs, use visual-content.
  • 100pinterest-seo
    The Pinterest SEO / search-ranking skill -- the keyword layer that pairs with pinterest-pin-design's visual. Use when someone wants pins to rank in Pinterest search, needs keyword research, or wants keyword-optimized pin titles/descriptions/boards. Pinterest is a visual search…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.