SuperAPI AI 工具集

instagram-gallery-download

通用与其它

查看项目

更新于 10-16 06:17

技能介绍

用途:该技能用于下载 Instagram 帖子/轮播(carousel)媒体,通过 gallery-dl 处理 instagram.com/p/<code>/ 形式的文章链接。

主要能力:下载帖子与轮播媒体,并在输出中生成标签文本文件、JSON 元数据 sidecar,以及用于减少重复下载的归档跟踪文件(.gallery-dl-archive.sqlite3)。

使用方式:推荐使用辅助脚本以保持默认参数一致:scripts/download_instagram_gallery.sh 'https://www.instagram.com/p/<code>/'。若内容需要登录,传入浏览器 Cookie:scripts/download_instagram_gallery.sh '<instagram-url>' --cookies-browser chrome。也可透传 gallery-dl 参数:scripts/download_instagram_gallery.sh 'https://www.instagram.com/p/POST_ID/' -- -R 2 --sleep 1-3。每次调用须在提升权限模式下运行,即 sandbox_permissions: "require_escalated",并在 Codex 沙箱之外执行 gallery-dl 命令。默认输出到当前目录,可自行指定输出文件夹。

流程:先校验 URL 形态为 https://www.instagram.com/p/<code>/,再选择输出目录,然后用提升权限运行脚本,最后检查输出文件与 .json 元数据 sidecar。

限制与路由:不支持 .../reel/... 与 .../reels/... 链接,这类链接应改用 yt-dlp 技能。Instagram 常将直接下载重定向到登录页,因此建议始终使用浏览器 Cookie。若归档跟踪显示已下载,可能不会产生新文件;需要重新下载时换用新输出目录。遇到限流可通过透传参数添加延迟与重试(在 -- 之后)。脚本路径为 scripts/download_instagram_gallery.sh,更多示例与选项见 references/gallery-dl-instagram.md。