用途
Instagram SuperPower 是一套用于 Instagram 的完整工具集,主要用于两类任务:一是通过 HikerAPI SaaS 获取账号分析数据;二是通过 Cobalt API 下载 Instagram 上的 Reels、视频或图片。资料说明的适用场景包括:下载 Reels/视频/图片,以及对 Instagram 内容进行分析。
主要能力
工具集由三部分组成:
- HikerAPI:用于分析,覆盖资料(profiles)、Reels、评论(comments)、粉丝(followers)、话题标签(hashtags)与搜索(search)。
- Cobalt:用于从 Instagram CDN 下载视频或图片。
- Groq Whisper:用于对已下载视频进行转写。
费用方面,资料给出的信息为:HikerAPI 标准方案 0.001 美元/请求;Cobalt 免费(自托管);Groq Whisper 免费。
使用方式
认证与访问
资料特别提示:应使用 api.instagrapi.com(无 Cloudflare),而不是 api.hikerapi.com,因为后者会拦截脚本中的 urllib/requests。密钥读取自 ~/.secrets/hikerapi/api-key,可作为请求头 x-access-key 或 GET 参数 access_key 传入。余额可通过 GET /sys/balance 查询。
主要接口
- 用户类:按用户名或 ID 获取资料、用户 Reels、全部帖子(分页)、Stories、Followers、Following、Highlights。
- 媒体类:按 code 或 URL 获取信息、评论、点赞者,以及下载视频或图片。
- 搜索类:全局搜索、Reel 搜索、账号搜索、地点搜索。
- 话题标签类:标签信息、按标签获取热门帖子与最新帖子。
媒体对象包含 play_count/view_count(播放/观看数)、like_count(点赞数)、comment_count(评论数)、taken_at(发布时间戳)、code(短代码,用于拼出 instagram.com/reel/{code}/)、caption.text(文案)、user.username(作者)。
脚本路径
资料列出了智能体机器上的脚本路径,包括下载脚本(Cobalt)、分析脚本(HikerAPI)、监控列表脚本、Cookie 部署脚本与 Cookie 检查脚本,均位于 ~/.claude/skills/instagram-superpower/scripts/ 下;另有 HikerAPI 密钥、Cobalt 凭据与 Cookie、Cobalt API 密钥、监控列表、下载文件等路径,以及自建 Cobalt 服务器上的 Docker Compose、Cookie、API keys、容器与本地端点 http://127.0.0.1:9000/。
典型调用
资料给出快速开始示例:按用户名查资料、取账号 Reels 并按播放量排序取前 5、通过 Cobalt 下载 Reel、下载并转写、查看 HikerAPI 余额。典型场景示例包括:查看竞品热门 Reels(analyze.sh 参数为用户名、数量、天数)、下载 Reel 并总结、加入监控(watchlist.sh add / scan)、完整竞品拆解、查看某话题标签的爆款内容。
分页方面,许多接口返回 next_page_id,可用于取下一页;Reels 约每页 12 条。
限制
速率限制
- HikerAPI:标准方案限制为每秒 8 个请求;资料称不存在 Instagram 封号风险(因其使用自有账号池与代理)。
- Cobalt(下载):Instagram 限制为每 1 个账号每小时 20 次下载;请求之间至少间隔 3 秒;批量下载(超过 5 个)需间隔 10–15 秒;必须严格串行,不可并行。
推荐策略
分析(HikerAPI)无此限制,可达每秒 8 个请求;下载(Cobalt)为每小时 20 次且需串行。HikerAPI 也可下载(/v1/media/download/*),但会消耗付费请求,因此建议改用 Cobalt。
维护与安全
HikerAPI 可通过 /sys/balance 检查余额,密钥在 dashboard 的 Tokens 中。Cobalt 可通过 SSH 查看容器状态、日志与重启服务;更新 Instagram Cookie 时使用浏览器自动化登录流程(含 2FA 处理),并通过 deploy-cookies.sh 部署。安全方面:HikerAPI 密钥位于 ~/.secrets/hikerapi/api-key(chmod 600);Cobalt 仅在服务器上监听 127.0.0.1:9000;Cookie 与凭据仅存放在 ~/.secrets/cobalt/(chmod 600);禁止记录密钥/Cookie、禁止在聊天中打印、禁止提交到 git。
暂未提供
资料未提供官方文档之外的产品背景、版本号、支持平台范围、具体界面说明以及除上述脚本外的更多使用示例。