Instagram Upload

使用 sau CLI 在 Instagram 独立网页登录、立即发布 Reels/单图/轮播、核验原作品并移至最近删除。

15,963 stars 2,698 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add dreammis/social-auto-upload --skill instagram-upload
Manual install
git clone --depth 1 https://github.com/dreammis/social-auto-upload.git /tmp/social-auto-upload
mkdir -p ~/.claude/skills
cp -r /tmp/social-auto-upload/skills/instagram-upload ~/.claude/skills/instagram-upload

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Instagram 独立网页发布

调用现有 CLI,不自行实现浏览器上传。使用工程 Patchright Chrome 和独立 Instagram 会话,不使用 Business Suite 的绑定入口。默认可见浏览器,未配置代理时按系统网络直连;需要代理时显式使用 `--proxy` 或设置 `SAU_INSTAGRAM_PROXY`。传 `--proxy ""` 可忽略环境变量并直连。

```powershell
sau instagram login --account creator
sau instagram check --account creator
sau instagram upload-video --account creator --file videos/demo.mp4 --thumbnail covers/demo.png --title "标题" --desc "正文" --tags 生活,分享 --result .local/instagram-video.json
sau instagram upload-note --account creator --images images/1.jpg images/2.jpg --title "轮播标题" --note "正文" --result .local/instagram-images.json
```

视频/Reel 可用 `--thumbnail` 指定 JPG/JPEG/PNG 封面;省略时使用 Instagram 默认封面。指定图片后会检查主预览确实使用该图片,失败则停止提交。封面按当前视频画幅居中裁剪,图片边缘的重要文字应留出安全区域。图文发布不接受此参数。

账号文件保存为 `cookies/instagram_creator.json`。密码和验证由用户在工程浏览器输入。上传流程会自动跳过首次通知提示、确认 Reels 介绍,没有提示则继续。登录验证仍由用户完成;未知弹窗或提示关闭失败须报告,不能宣称上传成功。

视频支持 MP4/MOV,照片支持 JPG/JPEG/PNG/AVIF/HEIC/HEIF,实际处理取决于平台。多图按输入顺序发布轮播,单图和两图轮播已实测。标题、正文、标签合计最多 2200 字符。当前账号独立网页版的照片/Reels 表单及高级设置没有定时入口,当前 CLI 仅支持立即发布;不能把定时任务转换成立即发布。地点、协作者、AI 标签、替代文字、滤镜、裁剪、声音和评论/点赞设置未接入,沿用页面默认值。

最终结果 `published` 代表平台确认作品创建,返回作品编号、原作品链接和媒体数。`processing` 表示已受理且仍在处理,`submission_unknown` 表示提交后结果未确认;不能当成已发布,也不能直接重发。默认结果位于 `.local/instagram-results/`,使用 `--result` 固定记录路径。
Read the full skill on GitHub

Details

Skill name
instagram-upload
Path
skills/instagram-upload/SKILL.md
License
MIT
Repo updated
22 October 2026

FAQ

What does the Instagram Upload skill do?

使用 sau CLI 在 Instagram 独立网页登录、立即发布 Reels/单图/轮播、核验原作品并移至最近删除。

How do I install the Instagram Upload skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add dreammis/social-auto-upload --skill instagram-upload. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Instagram Upload popular?

It lives in dreammis/social-auto-upload, which has 15,963 GitHub stars and 2,698 forks, and is included in 1 curated skill list.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.