核心用法
instagram-api 是一套基于官方 Meta Graph API 的 CLI 自动化工具集，允许用户直接从命令行向 Instagram（Feed、Story、Reels、Carousel）和 Threads 发布内容。该技能采用纯 Bash 脚本实现，无需依赖第三方 SaaS 服务，完全通过官方 API 完成认证与内容投递。
配置流程
1. 在 Meta for Developers 创建 Business 类型应用
2. 申请 instagram_basic、instagram_content_publish、pages_read_engagement 权限
3. 通过 Graph API Explorer 获取 Access Token 并交换为 60 日有效期的长期令牌
4. 配置 Imgur Client ID 用于生成本地媒体文件的临时公开 URL（Instagram API 要求媒体必须通过公开 URL 上传）
5. 设置环境变量：INSTAGRAM_ACCESS_TOKEN、INSTAGRAM_BUSINESS_ACCOUNT_ID、IMGUR_CLIENT_ID 等
功能覆盖
| 功能 | 脚本 | 说明 |
|:---|:---|:---|
| Feed 发布 | `post-feed.sh` | 单图 + 文案 |
| Story 发布 | `post-story.sh` | 单图限时动态 |
| Reels 发布 | `post-reels.sh` | 短视频 + 文案（处理耗时数分钟） |
| Carousel 发布 | `post-carousel.sh` | 多图轮播帖 |
| Threads 发布 | `post-threads.sh` | 文本/图文帖（需独立 Token） |
---
显著优点
1. 官方直连：零第三方依赖，避免中间商 API 限制与额外费用
2. 成本低廉：仅需 Imgur 匿名上传（免费），无按量计费焦虑
3. 批量自动化：Bash 脚本易于集成 CI/CD、定时任务或内容工作流
4. 隐私可控：Token 本地管理，不上传至外部平台
5. 跨平台覆盖：同时支持 Instagram 全格式 + Threads 新兴平台
---
潜在缺点与局限性
| 限制项 | 说明 |
|:---|:---|
| **媒体托管依赖** | 必须通过 Imgur 等生成公开 URL，无法直传本地文件；Imgur 有速率限制与内容政策风险 |
| **Reels 异步处理** | 视频发布非即时完成，需轮询或等待处理状态，不适合实时性要求高的场景 |
| **权限申请门槛** | Meta 商业权限审核严格，个人开发者可能被拒或需补充业务验证 |
| **Token 有效期** | 长期令牌 60 天需手动刷新，自动化需额外维护逻辑 |
| **无元数据管理** | 不支持排期发布、草稿箱、数据分析等高级功能 |
| **Threads 独立认证** | Threads API 需额外 Token 与 User ID，配置复杂度翻倍 |
---
适合人群
- 技术型创作者：熟悉命令行与 API 配置，追求自动化工作流的开发者、运维人员
- 小型团队/工作室：需批量管理多账号内容，但预算有限不愿采购 Hootsuite、Buffer 等企业工具
- 隐私敏感用户：不愿将账号凭证托管至第三方平台的个人品牌运营者
- 自动化集成需求：希望将社交媒体发布嵌入现有 GitOps、CMS 或数据流水线的高级用户
---
常规风险
| 风险类别 | 描述 | 缓解建议 |
|:---|:---|:---|
| **账号封禁** | 自动化发布可能触发 Meta 反垃圾机制，尤其高频或重复内容 | 控制发布频率，模拟人类行为间隔；内容多样化 |
| **Token 泄露** | Access Token 存储于本地 `.env`，误提交 Git 或权限配置不当导致泄露 | 使用专用凭证管理工具（如 1Password CLI、Doppler）；.env 加入 `.gitignore`；定期轮换 Token |
| **Imgur 服务波动** | 免费匿名上传不稳定，图片被删或域名屏蔽导致帖子失效 | 自建 CDN 备用；重要内容使用付费图床 |
| **API 变更兼容性** | Meta Graph API 版本迭代快，v21.0 可能弃用 | 关注 [Meta Changelog](https://developers.facebook.com/docs/graph-api/changelog)，及时升级脚本 API 版本号 |
| **合规风险** | 自动发布未标注广告/合作内容可能违反平台社区准则与地区法规 | 确保内容合规，必要时添加 `#ad` 等披露标签 |
---
总体评估
instagram-api 是一款面向技术用户的轻量级、低成本社交媒体自动化方案。其价值在于消除第三方中间层，实现从本地环境到 Meta 平台的直连控制。然而，Imgur 中转、Token 维护、Reels 异步处理等机制决定了它更适合具备基础运维能力的用户，而非追求零配置开箱体验的普通创作者。建议生产环境使用时封装健康检查、重试逻辑与 Token 自动刷新机制，以提升稳定性与安全性。