Instagram 视频与图文发布 · 创作技能

这个技能解决什么问题

调用 sau CLI 在 Instagram 独立网页会话中登录、立即发布 Reels、单图或轮播，并用原作品链接与正文核验后移至最近删除。明确 published、processing、submission_unknown 三种结果语义，禁止把未知结果当成功或直接重发；不含定时发布与高级设置。

适用任务

通过 sau CLI 完成 Instagram 账号登录、立即发布视频/Reel、单图或轮播，发布后核验原作品，必要时删除至最近删除。

需要的输入

已安装并可运行的 sau CLI 与 Patchright Chrome 环境；Instagram 账号（密码与验证由用户在浏览器内输入）；本地视频（MP4/MOV）或图片（JPG/JPEG/PNG/AVIF/HEIC/HEIF）；标题、正文、标签合计不超过 2200 字符；可选 JPG/JPEG/PNG 封面；如需代理，显式传 --proxy 或设置 SAU_INSTAGRAM_PROXY。

交付内容

结果 JSON（默认 .local/instagram-results/，可用 --result 指定），含状态 published/processing/submission_unknown、作品编号、原作品链接、媒体数；核验结果文件；删除结果 deleted 或 deletion_unknown。

任务示例

sau instagram login --account creator sau instagram upload-video --account creator --file videos/demo.mp4 --thumbnail covers/demo.png --title "标题" --desc "正文" --tags 生活,分享 --result .local/instagram-video.json

输出示例

示意（非真实运行结果）：{"status":"published","post_url":"<原作品链接>","media_count":1}；若为 submission_unknown，则需先在账号主页按素材、配文与发布时间查找原作品，复制链接后运行 verify，不得重发。

来源与使用

作者 dreammis；许可 MIT。已核对来源与包结构，未据此宣称完成运行实测。

查看原始来源

机器可读详情 · 读取 SKILL.md · 下载完整技能包

让 Agent 使用这个技能 ↗

技能说明全文

---
name: instagram-upload
description: 使用 sau CLI 在 Instagram 独立网页登录、立即发布 Reels/单图/轮播、核验原作品并移至最近删除。
license: MIT-0
slug: social-auto-upload-instagram-upload
displayName: Instagram 视频与图文发布
version: 1.0.0
summary: 发布 Instagram Reels、单图或轮播，并核验作品。
---

# 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` 固定记录路径。

```powershell
sau instagram verify --account creator --post-url "原作品链接" --expected-text "原作品中的准确文字" --result .local/instagram-verify.json
sau instagram delete --account creator --post-url "原作品链接" --expected-text "原作品中的准确文字" --result .local/instagram-delete.json
```

结果未知但没有链接时，先在同一账号主页按素材、配文和发布时间找原作品，复制链接再运行 `verify`；未找到不证明失败，不重复上传。链接支持 `/p/编号/`、`/reel/编号/` 和带作者名的形式。核对登录用户、作者、作品编号和正文后才允许删除。删除返回 `deleted`，作品进入“最近删除”；批量删除和提前永久清空不在范围内。本地素材不会删除。`deletion_unknown` 须先查询原作品和“最近删除”，不重复提交删除。

完整参数和能力边界以 `sau instagram upload-video --help`、`upload-note --help`、`verify --help` 和 `delete --help` 为准。失败时根据结果文件中的错误及本地证据分析；不得把账号状态、截图或页面记录提交到 Git。

## 示例脚本

`scripts/examples/` 下的文件是复制用示例，不是运行时依赖。执行前先查看当前 CLI 的 `--help`，替换账号、素材和正文；这些命令可能创建真实作品。

- `instagram_commands.ps1`：PowerShell
- `instagram_commands.sh`：Bash
- `instagram_cli_template.py`：Python subprocess

技能是任务材料，不会自动授予账户权限、付费授权或其他系统权限。请让 Agent 按说明核对依赖，再在授权范围内使用。