Instagram命令行工具

技能简介

gram 是一款基于 Node.js 的 Instagram命令行客户端，通过 REST/GraphQL API 与 Cookie 认证机制，实现无需官方 API 密钥即可浏览动态、查看帖子、搜索用户、分析互动数据等操作。

业务背景

gram 让业务人员无需开发背景即可在终端快速获取 Instagram 公开数据，适用于竞品账号监测、热点内容追踪及用户画像初筛。通过命令行直接调取动态、帖子详情与互动数据，省去人工逐页浏览的重复劳动，提升信息收集效率。

落地案例：市场部调研竞品账号时，输入目标品牌用户名即可批量导出其近期帖子、粉丝增长趋势及高互动内容；运营人员监控活动话题标签，定时抓取相关帖子的点赞与评论用户，为后续达人合作储备线索。全程仅需浏览器 Cookie 认证，无需申请官方 API 权限。

能做什么

• 浏览首页动态与探索页推荐内容
• 查看指定帖子详情、评论列表、点赞用户
• 检索用户资料、关注列表、粉丝列表
• 搜索用户、话题标签、地点信息
• 执行点赞、收藏、评论、关注等互动操作
• 输出 JSON 格式便于二次处理

使用说明

安装

# npm/pnpm/bun
npm install -g @cyberdrk/gram

# 免安装单次运行
bunx @cyberdrk/gram whoami

配置认证

gram 依赖浏览器 Cookie 进行身份验证。从已登录 Instagram 的浏览器中提取 sessionid、csrftoken、ds_user_id 三项 Cookie，通过命令行参数传入，或配置自动读取浏览器 Cookie。

常用命令示例

# 查看当前登录账号
gram whoami

# 查看指定帖子
gram post CxYz123

# 获取用户资料
gram user instagram

# 搜索话题标签
gram search "#photography" --type hashtags

# 导出 JSON 数据
gram user instagram --json

输入与输出

见下方输入与输出表格。

风险提示

• Cookie 泄露可能导致账号被盗用，勿将凭证提交至公共仓库
• 频繁请求可能触发 Instagram 风控，导致临时限制或封禁
• 该工具非 Meta 官方产品，功能变更或接口调整可能导致失效
• 部分互动操作（点赞、关注）有每日上限，超额将受限

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/arein/gram/SKILL.md
来源类型：GitHub 开源项目