Instagram 程序化发图

要解决什么问题

把一张图发到 Instagram，官方并没有给你一条「本地文件 + 文案」的 CLI。实际走的是 Meta Graph API：先创建媒体容器，再轮询处理状态，最后 media_publish。中间任何一步缺权限、图片 URL 对 Meta 不可达，都会变成 Media download has failed 或 Unsupported post request。

本技能把可重复的部分收成一条发布流程：你在浏览器里完成一次性账号与应用配置，之后用脚本传入公网 image_url 和 caption 即可。

技能如何工作

Part 1（人工，只做一次） 在 Meta 控制台完成：Instagram 切到 Creator/Business、创建 Developer 账号与应用、在 Basic 里补齐隐私政策等字段、在 Use cases 里勾选 instagram_content_publish / instagram_basic，生成以 IGAA 开头的 ACCESS_TOKEN 并写入 .env。

Part 2（自动化） scripts/publish.py 串联 Graph API 的三次调用。常用参数包括 --image-url、--caption、--dry-run（只校验 token 与建容器，不真正发帖）。成功时会打印新帖的 post ID。

适用边界与注意点

• 仅单图 Feed 帖，不支持 Reels、Stories、轮播。
• 图片必须是 公网可访问的 URL；localhost、内网 IP、需登录才能看的链都会触发下载失败。
• 个人号不能直接走这套流程，需先升级为 Creator 或 Business。
• 长效 token 仍会过期（常见约 60 天），鉴权失败时在控制台重新生成并更新 .env。
• 切勿把 .env 提交到 git；token 即发帖凭证。