SuperAPI AI 工具集

pinterest-download

通用与其它

查看项目

更新于 11-05 16:49

技能介绍

用途

pinterest-download 用于搜索 Pinterest 并保存图片或 MP4 视频,运行在用户当前的 Ego Lite 会话中。它同时支持获取相关 Pin、画板内容,以及生成供模型读取的小预览图。

主要能力

  • 搜索:按关键词搜索 Pin,可指定数量、媒体类型(图片/视频/任意)与分辨率下限。
  • 相关 Pin:根据指定 Pin 获取相关结果。
  • 画板:读取 Pinterest 用户画板中的内容。
  • Pin 详情:按数字 ID、pin 链接或 pin.it 短链接查询单个 Pin。
  • 预览图:获取指定图片 URL 的缩略图,或在搜索结果中附带最多 8 张 base64 缩略图供模型读取。
  • 直接下载:按 URL 下载图片、MP4、HLS、cmfv 等文件。

使用方式

脚本通过 ego-browser nodejs 执行,因为该环境不转发 shell 参数,配置会被写入临时模块后通过 -e 导入执行。常用命令示例:

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

主要参数

  • command:search / related / board / pin / preview / download,默认 search。
  • --query:搜索关键词,支持任意语言。
  • --pin:数字 ID、pinterest.com/pin/… 或 pin.it 链接;e1_ 前缀会被拒绝。
  • --board:画板地址,格式为 pinterest.com/<user>/<board>/ 或 /user/board/。
  • --url:可重复,用于 preview 和 download;MP4 / HLS / cmfv 按视频处理。
  • --count:数量 1–100,默认 10。
  • --out:保存目录,默认 ~/Downloads/pinterest-ego,需为绝对路径。
  • --size:originals(回退到 736x)、474x、236x。
  • --min-width / --min-height:像素下限,0 或省略表示不限制。
  • --media:image(跳过视频)、video(保存 MP4)、any(保留两者,但仍只存图片除非指定 video)。
  • --previews:附带的 base64 缩略图数量,最多 8。
  • --bookmark:继续翻页。
  • --allow-anonymous:允许匿名公开结果。
  • --keep:保留 Pinterest 标签页不关闭。

分辨率过滤规则

只设置一边时只检查该边;两边都设置时要求两边宽度与高度均已知且不低于阈值。视频优先使用 video_width / video_height,缺失时使用封面图尺寸。缺少被要求的一边时记入 skipped[] 且不保存。直接 download --url 目标与预览缩略图不受分辨率过滤。

输出与退出码

stdout 输出单个 JSON 对象,文件及 manifest.json 写入 --out 目录。退出码约定:0 表示至少保存了图片、视频或预览,或 Pin 查询返回了未被分辨率跳过的记录;2 表示 Pinterest 未登录或 pin/board 输入不可用;1 表示未保存任何内容(包括全部因分辨率被跳过)。

登录说明

每次运行都应向用户展示 JSON 中的 login_tip / login_tip_zh:在 Ego Lite 内登录 Pinterest 可提升结果质量;匿名模式虽仍返回公开图片,但 ID 常为 e1_… 形式,相关与画板查询较弱。若退出码为 2(login_required: true),应向用户展示 how_to_login / how_to_login_zh 后停止,不要输入密码。

适用场景

需要在个人 Pinterest 会话下搜索、批量保存素材,或获取相关 Pin、画板内容与模型可读预览图的场景。

限制

以个人使用为目的;登录状态决定结果质量。视频下载涉及 CDN 访问,脚本会对 fetch 失败进行 HTTP/1.1(IPv4)重试,再通过已登录页面保存。