核心功能与用法
Instagram API Skill 是一套基于 Node.js 的命令行工具集，通过 Instagram Graph API 实现对商业/创作者账号的完整管理。核心能力覆盖四大板块：
账号与内容管理：get-profile.js 获取账号元数据（名称、账号类型、媒体数量），get-posts.js 分页列出历史帖子，get-post.js 查看单帖互动数据（点赞数、评论数）。
多媒体发布：post-image.js 支持单图/轮播图发布，自动识别 1 张（单帖）或 2-10 张（轮播），兼容 URL 与本地文件（需 cloudflared 隧道），支持 JPG/PNG/GIF/WebP/HEIC 等格式，HEIC 自动转码。post-video.js 处理 Reels 与视频轮播，单视频支持封面图、缩略图偏移、同步到主页 feed 等选项，视频处理最长等待 10 分钟。
互动管理：get-comments.js 拉取帖子评论与回复树，post-comment.js 与 reply-comment.js 实现评论发布与回复。
令牌管理：内置自动刷新机制，也可手动执行 refresh-token.js 查看有效期。
显著优点
- 格式兼容广泛：图片支持 HEIC 自动转 JPEG，视频支持 MOV/MP4，降低用户预处理成本
- 智能类型推断：根据文件数量自动切换单帖/轮播模式，无需显式指定
- 本地文件友好：通过 cloudflared 隧道解决 Instagram API 仅接受公开 URL 的限制，支持直接拖拽本地文件发布
- 完整互动闭环：从发布到评论管理的端到端能力
潜在局限与风险
- 账号类型限制：仅支持 Instagram 商业账号或创作者账号，个人账号无法使用
- 依赖外部服务：cloudflared 必需且需保持运行，增加本地部署复杂度
- 速率与审核风险：Instagram API 有严格的速率限制，频繁发布可能触发平台风控；视频内容需符合社区准则，否则会被拒审
- 令牌安全：长期有效的 Access Token 需妥善保管，
.env文件泄露可能导致账号被盗用 - 无实时数据：无法获取实时通知，评论/互动数据存在分钟级延迟
适用人群
社交媒体运营人员、内容创作者、品牌自动化营销团队，以及需要将 Instagram 发布流程集成到 CI/CD 或内部工作流的技术团队。
配置要求
- Node.js v22+、npm、cloudflared
- 环境变量：INSTAGRAM_APP_ID、INSTAGRAM_APP_SECRET、INSTAGRAM_ACCESS_TOKEN
- 互联网访问 graph.instagram.com