/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.
- Author
- AceDataCloud ↗
- Repository
- Skills ↗
- Licence
- Apache-2.0
- Last repository change
- 25.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 4
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 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
- Create an image Pin
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…