概览
盘点一个 Instagram 账号发布过哪些内容,通常从帖子 ID 与 shortcode 开始。这份数据会把指定账号下可公开采集的帖子整理成清单,并附上发布时间、采集时间和账号内容数。
相较于手工翻看账号主页,这份清单更适合历史盘点、内容归档和周期比对。帖子 ID 可识别同一条内容,shortcode 便于关联公开帖子,时间信息则能支撑发布节奏判断。
数据说明
清单来自指定 Instagram 账号可公开采集的帖子列表,同一个帖子 ID 只保留一条。发布时间表示对外发布时间,采集时间表示索引获取时间;账号内容数是采集时返回的公开内容总数文本。无数据标记用于区分“账号没有可返回内容”和普通记录。私有账号、已删除帖子以及当时不可公开访问的内容可能不在结果中。
结果长什么样
每条普通记录代表一个 Instagram 帖子索引:
| 帖子 ID | 帖子短码 | 发布时间 | 账号 ID | 无数据标记 |
|---|---|---|---|---|
| 1894814149847137149 | BpLu24dBbt9 | 2018-10-21T13:24:30 | 31489157 | 否 |
| 2111943669967708192 | B1PIZQKD2Ag | 2019-08-17T03:22:06 | 31489157 | 否 |
另有采集时间、目标类型、账号内容数和任务目标等信息。
应用场景
- 建立内容索引时,用「帖子 ID」作为主键,以「帖子短码」关联公开内容,减少重复归档。
- 分析发布节奏时,按「发布时间」聚合发帖数量,观察账号活跃周期。
- 检查覆盖时,对照「账号内容数」与返回量,并结合「无数据标记」识别没有可采集内容的目标。
- 做周期盘点时,比对两次结果的「帖子 ID」,再用「采集时间」确认获取时点。
适用边界
一次处理一个 Instagram 数字账号 ID,采集数量最多 100000 条;仅覆盖可公开采集的帖子。
- 适合用于
- 需要获取一个 Instagram 账号的帖子 ID、shortcode 和发布时间清单时
- 需要建立账号内容索引或分析历史发帖节奏时
- 不要用于
- 需要帖子正文、图片、视频或互动数据时,应使用帖子详情类数据能力
- 需要一次处理多个账号时,应为每个账号分别运行
- 需要私有账号或已删除内容时,本 App 只覆盖可公开采集的帖子
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回空列表时先核对账号 ID、公开可见性和最早发布时间限制,再决定是否重试
- 2鉴权或授权失败不可通过重复提交解决,应先检查执行环境中的凭证和权限
- 3临时限流或服务不可用可稍后重试;任务失败或过期后可重新运行
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| account_id | Instagram 账号 ID | string | 是 | — | — | 31489157 | 要采集帖子列表的 Instagram 数字账号 ID,不能填写账号昵称。 |
| crawl_num | 采集数量 | integer | 是 | — | 1–100000 | 1 | 希望采集的帖子数量,范围为 1 至 100000;数量越大,耗时和费用可能越高。 |
| time_limit | 最早发布时间 | string | 否 | — | — | — | 只采集发布时间不早于该时刻的帖子,填写 13 位 Unix 毫秒时间戳;不填则不限制最早发布时间。 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| content_id | 帖子 ID | string | — | Instagram 帖子的唯一内容标识;无可采集内容时可能为空。 |
| content_shortcode | 帖子短码 | string | — | Instagram 帖子的公开 shortcode;无可采集内容时可能为空。 |
| crawl_time | 采集时间 | string | — | 本条帖子索引被采集的时间;无可采集内容时可能为空。 |
| keyword | 账号 ID | string | — | 触发本条采集的 Instagram 账号 ID;无可采集内容时可能为空。 |
| keyword_type | 目标类型 | string | — | 采集目标的类型,本 App 通常返回 account;无可采集内容时可能为空。 |
| publish_content_count | 账号内容数 | string | — | 账号公开内容总数的文本值;无可采集内容时可能为空。 |
| publish_time | 发布时间 | string | — | 帖子公开发布的时间;无可采集内容时可能为空。 |
| task_item | 任务目标 | string | — | 本条记录所属任务的 Instagram 账号 ID。 |
| no_data | 无数据标记 | boolean | — | 该任务目标是否没有可返回的帖子记录。 |
记录 Schema
输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "帖子 ID",
"description": "Instagram 帖子的唯一内容标识;无可采集内容时可能为空。"
},
"content_shortcode": {
"type": "string",
"title": "帖子短码",
"description": "Instagram 帖子的公开 shortcode;无可采集内容时可能为空。"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "本条帖子索引被采集的时间;无可采集内容时可能为空。"
},
"keyword": {
"type": "string",
"title": "账号 ID",
"description": "触发本条采集的 Instagram 账号 ID;无可采集内容时可能为空。"
},
"keyword_type": {
"type": "string",
"title": "目标类型",
"description": "采集目标的类型,本 App 通常返回 account;无可采集内容时可能为空。"
},
"publish_content_count": {
"type": "string",
"title": "账号内容数",
"description": "账号公开内容总数的文本值;无可采集内容时可能为空。"
},
"publish_time": {
"type": "string",
"title": "发布时间",
"description": "帖子公开发布的时间;无可采集内容时可能为空。"
},
"task_item": {
"type": "string",
"title": "任务目标",
"description": "本条记录所属任务的 Instagram 账号 ID。"
},
"no_data": {
"type": "boolean",
"title": "无数据标记",
"description": "该任务目标是否没有可返回的帖子记录。"
}
},
"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-post-ids": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-post-ids",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 12 条为一个计费单位,不足 12 条按 12 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。