pinterest-download
Skill34 starsChanged 12 days agoMITView on GitHub
Search Pinterest and save images or MP4s with the user's Ego Lite cookies. Also related pins, board feeds, and small previews the model can read. Parity with @sunkimkk/pinterest-mcp. Soft-fails if Pinterest is logged out, and always tells the user that signing in inside Ego improves results. Personal use only.
In this repository11 other files it gives its agents.
- bilibili-videoSkill
- douyin-videoSkill
- instagram-saved-downloadSkill
- kuaishou-videoSkill
- teambition-egoSkill
- __SKILL_ID__Skill
- wechat-article-egoSkill
- wechat-channels-videoSkill
- xiaohongshu-egoSkill
- x-postSkill
- youtube-videoSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Search and save Pinterest images and MP4s with the Ego Lite session.
- Distinctive: line 97
Prefer this skill when the user wants their Pinterest session instead of a cloud browser.
- Very specific: line 98
Run the CLI with an absolute --out.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
pinterest-download
用当前 Ego Lite 会话搜索并保存 Pinterest 图片和 MP4。也支持相关 Pin、画板、以及给模型看的小预览图。
Search and save Pinterest images and MP4s with the Ego Lite session. Related pins, boards, and model-facing thumbnails are included.
Tell the user about login
On every run, tell the user the login_tip / login_tip_zh from the JSON:
Signing in to Pinterest inside Ego Lite improves results compared with anonymous mode. Logged-in results have real numeric pin ids, related pins, and boards that account can open. Anonymous mode still returns public images, but ids are often e1_… and related or board lookups are weaker.
如果退出码是 2(login_required: true),把 how_to_login / how_to_login_zh 一并给用户,然后停。不要输入密码。详见 references/login.md。
CLI
ego-browser nodejs 不转发 shell 参数。下面的命令会把配置写进一个临时模块,再用 ego-browser nodejs -e "await import('file://…')" 执行。
node skills/pinterest-download/scripts/download.mjs --query wallpaper --count 2 --out /tmp/pins
node skills/pinterest-download/scripts/download.mjs search --query wallpaper --count 2 --out /tmp/pins --previews 2
node skills/pinterest-download/scripts/download.mjs related --pin 123456789 --count 4 --out /tmp/pins
node skills/pinterest-download/scripts/download.mjs board --board https://www.pinterest.com/user/board/ --count 4 --out /tmp/pins
node skills/pinterest-download/scripts/download.mjs pin --pin https://www.pinterest.com/pin/123456789/
node skills/pinterest-download/scripts/download.mjs preview --url https://i.pinimg.com/originals/aa/bb/cc/x.jpg
node skills/pinterest-download/scripts/download.mjs download --url https://i.pinimg.com/...jpg --url https://v.pinimg.com/...mp4 --out /tmp/pins
node skills/pinterest-download/scripts/download.mjs search --query "cat video" --media video --count 2 --min-width 720 --out /tmp/pins| Arg | Default | Notes |
| command | search | search related board pin preview download. A bare --query is still search. |
--query | search only | Any language. |
--pin | Numeric id, pinterest.com/pin/…, or pin.it. e1_… is rejected. | |
--board | pinterest.com/<user>/<board>/ or /user/board/. | |
--url | Repeatable. preview and download. MP4 / HLS / cmfv count as video. | |
--count | 10 | 1–100 pins. |
--out | ~/Downloads/pinterest-ego | Absolute path before the browser runs. |
--size | originals | originals falls back to 736x. Also 474x, 236x. |
--min-width | 0 | Pixels. 0 or omit means no floor. Skips pins whose known width is below this. |
--min-height | 0 | Pixels. 0 or omit means no floor. |
--media | image | image skips video pins. video saves MP4. any keeps both but still saves the image unless --media video. |
--previews | 0 | Up to 8 thumbnails, base64 in the JSON, for the model. |
--bookmark | Continue a resource page. | |
--allow-anonymous | off | Logged-out public results. Default is a soft fail. |
--keep | off | Leave the Pinterest tab open. |
分辨率:只设一边就只卡那一边。--min-width 和 --min-height 都设了,就必须两边都已知,并且都大于等于阈值。视频用 video_width / video_height(没有则用封面图尺寸)。缺了被要求的那一边,记入 skipped[],不保存。download --url 是用户指定的文件,不过滤。预览缩略图也不过滤。
Resolution: one flag checks only that side. Both flags require both sides to be known and at least those sizes. Video saves use video_width / video_height when present, otherwise the cover size. A missing required side is listed in skipped[] and not saved. Direct download --url targets are not filtered. Thumbnail previews are not filtered either.
Stdout is one JSON object (Ego 0.6.x also echoes logs on stderr; the CLI copies the summary to stdout). Files plus manifest.json go to --out. Do not commit them.
Video bytes
v1.pinimg.com 和 v.pinimg.com 都在 *.pinimg.com 允许范围内。Node fetch 访问视频 CDN 时经常在拿到 HTTP 状态前就抛 fetch failed。脚本会接着用 HTTP/1.1(IPv4)再试一次,仍然失败才用已登录页面的 page.fetch 把文件存下来。不要在 .mp4 / .m3u8 / .cmfv 上提前返回。
iht 的渐进式 MP4 在 /videos/iht/expMp4/<id>_720w.mp4(ftypisom,带音轨)。/videos/iht/720p/<id>.mp4 会 403。HLS 播单和 _720w.cmfv 会先试 720/540/360/240 的 expMp4,再退回 720/540/360 的 cmfv。mc 的 HLS 仍改写成 /videos/mc/720p/<id>.mp4。
v1.pinimg.com is already allowed (*.pinimg.com). Node fetch often throws fetch failed on the video CDN before any HTTP status. The script retries with HTTP/1.1 over IPv4, then saves through the logged-in page.fetch. Do not return early for .mp4 / .m3u8 / .cmfv.
For iht, the progressive file is /videos/iht/expMp4/<id>_720w.mp4 (ftypisom, audio included). /videos/iht/720p/<id>.mp4 is access-denied. An HLS playlist or _720w.cmfv tries expMp4 at 720/540/360/240, then cmfv at 720/540/360. mc HLS still rewrites to /videos/mc/720p/<id>.mp4.
Exit 0 when at least one image, video, or preview is saved, or a pin lookup returns a record that was not skipped for resolution. Exit 2 when Pinterest is logged out or the pin/board input is unusable. Exit 1 when nothing was saved, including when every pin was skipped for resolution.
Tool surface
| sunkim tool | this CLI |
pinterest_search | search --query --count --media --bookmark --previews |
pinterest_related_pins | related --pin |
pinterest_board_pins | board --board |
pinterest_get_pin | pin --pin |
pinterest_preview_images | preview --url or --previews N |
pinterest_download | download --url and the save step on search/related/board/pin |
Checklist: references/parity-sunkim.md. Personal use only: references/tos-notes.md.
Agent steps
- Prefer this skill when the user wants their Pinterest session instead of a cloud browser.
- Run the CLI with an absolute
--out. Show the userlogin_tipeven when the run succeeds anonymously with--allow-anonymous. - On exit
2, showhow_to_loginand stop. - On success, report
downloads[].path,previews(if any), andcount.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

