概览
Instagram 账号持续发布的 Reel,能反映内容主题、更新节奏和运营重点。这个 App 把指定账号当前可公开获取的 Reel 整理成清单,并完整保留每条记录的内容标识、采集关键词、关键词类型和发布时间。
相比手工逐条浏览账号主页,这份清单适合建立内容底表,也能核对每条结果来自哪个采集关键词及业务标识。
数据说明
数据取自指定 Instagram 账号在采集时可公开获取的 Reel 列表,并按 Reel 编号去重。业务标识、采集关键词和账号 ID 在当前结果中可能取值相同,但代表不同原始字段,因此分别保留。账号没有采集到符合条件的内容时,结果会保留一条「是否无数据」为「是」的标记记录;该记录只有账号 ID 和无数据标记,不返回其他业务字段。
结果长什么样
每条记录代表一个 Reel,或一条账号无数据标记:
| Reel 编号 | Reel 短码 | 账号 ID | 发布时间 | 业务标识 | 采集关键词 | 关键词类型 | 是否无数据 |
|---|---|---|---|---|---|---|---|
| 3349848448617322501 | C59DWpvOpgF | 11830955 | 2024-04-20T02:59:05 | 11830955 | 11830955 | accountReel | 否 |
| 99900001 | 是 |
应用场景
- 用 Reel 编号建立去重后的内容底表,并按发布时间分析账号的发布节奏。
- 用采集关键词、关键词类型和业务标识核对数据来源,避免把值相同的不同字段误作同一含义。
- 先看是否无数据,再用账号 ID 定位没有采集结果的账号。
适用边界
单次任务处理 1 个 Instagram 账号,采集数量为 1 至 1000 条;仅覆盖采集时公开可见的 Reel。
- 适合用于
- 需要按 Instagram 账号 ID 批量获取公开 Reel 列表时
- 需要整理 Reel 发布时间或建立账号内容清单时
- 不要用于
- 需要私密账号、已删除或登录后才可见的内容时——本 App 仅覆盖公开可见 Reel
- 需要 Reel 的播放量、点赞数、评论或媒体文件时——本 App 不提供这些明细
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1「是否无数据」为是表示该账号没有采集到符合条件的 Reel,可核对账号 ID 或放宽最早发布时间后重试
- 2限流、服务暂不可用或请求超时可稍后原样重试
- 3任务提交结果不明时不要连续重复提交,避免产生重复任务
- 4鉴权失败需先检查执行环境中的 API Key 配置
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| account_id | Instagram 账号 ID | string | 是 | — | — | 11830955 | 要采集的 Instagram 账号 ID,每次任务只处理一个账号;长度不得超过 512 个字符 |
| crawl_num | 采集数量 | integer | 是 | — | 1–1000 | 100 | 本次任务最多采集多少条公开 Reel,取值 1–1000;实际返回可能少于该值 |
| time_limit | 最早发布时间 | integer | 否 | — | 1000000000000–9999999999999 | — | 只保留不早于该时间发布的 Reel,填写 13 位 Unix 毫秒时间戳;留空表示不限制最早发布时间 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| reel_id | Reel 编号 | string | — | Reel 在 Instagram 中的内容标识;无数据标记记录不包含此字段 |
| reel_shortcode | Reel 短码 | string | — | Reel 对应的短链接标识;无数据标记记录不包含此字段 |
| biz_id | 业务标识 | string | — | 结果记录中的业务标识;无数据标记记录不包含此字段 |
| keyword | 采集关键词 | string | — | 生成该条 Reel 记录所对应的采集关键词;无数据标记记录不包含此字段 |
| keyword_type | 关键词类型 | string | — | 采集关键词的类型,例如 accountReel;无数据标记记录不包含此字段 |
| account_id | 账号 ID | string | — | 该条结果对应的 Instagram 账号 ID |
| published_at | 发布时间 | string | — | Reel 的发布时间;无数据标记记录不包含此字段 |
| no_data | 是否无数据 | boolean | — | 是否没有采集到符合条件的 Reel;为 true 时本条仅用于标记空结果 |
记录 Schema
输出按记录逐条返回。记录主键为 reel_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"reel_id": {
"type": "string",
"title": "Reel 编号",
"description": "Reel 在 Instagram 中的内容标识;无数据标记记录不包含此字段"
},
"reel_shortcode": {
"type": "string",
"title": "Reel 短码",
"description": "Reel 对应的短链接标识;无数据标记记录不包含此字段"
},
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "结果记录中的业务标识;无数据标记记录不包含此字段"
},
"keyword": {
"type": "string",
"title": "采集关键词",
"description": "生成该条 Reel 记录所对应的采集关键词;无数据标记记录不包含此字段"
},
"keyword_type": {
"type": "string",
"title": "关键词类型",
"description": "采集关键词的类型,例如 accountReel;无数据标记记录不包含此字段"
},
"account_id": {
"type": "string",
"title": "账号 ID",
"description": "该条结果对应的 Instagram 账号 ID"
},
"published_at": {
"type": "string",
"title": "发布时间",
"description": "Reel 的发布时间;无数据标记记录不包含此字段"
},
"no_data": {
"type": "boolean",
"title": "是否无数据",
"description": "是否没有采集到符合条件的 Reel;为 true 时本条仅用于标记空结果"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"rookieyao__instagram-reel-list": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-reel-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 12 条为一个计费单位,不足 12 条按 12 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。