核心用法
instagram-api 是基于 Meta Graph API 的官方集成方案，通过 shell 脚本封装实现 Instagram 与 Threads 的多形态内容自动化发布。该技能采用 Imgur 作为媒体中转服务，解决 Instagram API 仅接受公开 URL 的限制。
功能覆盖：
- Feed 帖子：单图 + 文案发布
- Story：24小时限时动态
- Reels：短视频内容（需数分钟处理时间）
- Carousel：多图轮播帖子
- Threads：Meta 旗下类 Twitter 平台的文本/图文发布
技术架构：
用户本地媒体 → Imgur 匿名上传获取公开 URL → Meta Graph API 异步发布。全程依赖三个核心凭证：Meta 长期访问令牌（60天有效期）、Instagram 商业账号 ID、Imgur Client ID。
显著优点
1. 官方 API 背书：直接使用 Meta Graph API，规避第三方库的维护风险与封号隐患
2. 全格式覆盖：罕见地同时支持 Feed、Story、Reels、Carousel 四大 Instagram 内容形态
3. 跨平台整合：额外支持 Threads 发布，适应 Meta 生态扩张趋势
4. 轻量化设计：纯 shell 脚本实现，无复杂运行时依赖，易于 CI/CD 集成
5. 日志审计：失败调用自动归档至 ~/logs/sns/，便于运维追溯
潜在缺点与局限性
- 凭证管理负担重：需维护 3 组独立凭证（Meta 令牌、账号 ID、Imgur ID），令牌每 60 天需刷新
- 媒体中转依赖：强制依赖 Imgur 匿名上传，存在单点故障风险；Imgur 服务波动或政策变更将直接影响可用性
- 异步处理延迟：Reels 视频需后台转码，无法即时确认发布状态
- 商业账号门槛：仅支持 Instagram 商业/创作者账号，个人账号无法使用
- 隐私暴露风险：通过 Imgur 匿名上传的媒体文件变为公开可访问，敏感内容不适用
适合人群
- 社交媒体运营团队的自动化工作流搭建者
- 需要将内容发布集成至 CI/CD 或定时任务的开发者
- 多平台同步发布需求的内容创作者（尤其 Threads 早期用户）
常规风险
- 令牌泄露：长期访问令牌若泄露，攻击者可完全控制账号发布内容
- API 限流：Meta Graph API 存在调用频率限制，批量操作需配合退避策略
- 平台政策变动：Meta 与 Imgur 的 API 政策调整可能导致功能突然中断
- 公开 URL 残留：Imgur 上传的文件即使 Instagram 发布后仍可能保留公开访问，需评估数据留存策略