概览
这个 App 整理指定 Instagram 账号已收录的粉丝关系,返回粉丝账号 ID、用户名、展示名称、头像、账号状态和采集时间。它不会重新采集。
历史明细保留采集时间和记录 ID,适合追溯来源、核对批次并构建长期观察底表,也便于筛选、分组和跨时间比较。
数据说明
数据来自已保存的 Instagram 粉丝关系明细,并按采集时间从早到晚返回。记录以记录 ID 区分,不按粉丝账号跨批次合并,因此同一粉丝可能保留多条记录。展示名、头像、私密状态与认证状态是采集时保存的值,不代表当前状态。结果只覆盖已收录的数据,尚未采集、已被清理或当时未能取得的资料不会出现,部分账号资料可能为空。
结果长什么样
每条记录代表某次采集保存的一条粉丝关系:
| 记录 ID | 目标账号 ID | 粉丝账号 ID | 粉丝用户名 | 是否私密 | 采集时间 |
|---|---|---|---|---|---|
| 6a6868b1dd3d02672d5fa594 | 20677013713 | 7916608506 | eolioenne | 否 | 2026-07-28T12:23:17 |
| 6a740679ab02c6134f5d9d3b | 20677013713 | 48326859245 | nestuitive | 是 | 2026-08-06T11:58:47 |
结果中另有展示名、头像、认证状态和关系类型等信息。
应用场景
- 核对历史批次时,按「采集时间」分组并用「记录 ID」定位明细,判断各批次保存了哪些粉丝关系。
- 做受众样本整理时,以「粉丝账号 ID」统计独立账号,再结合「粉丝用户名」「是否私密」观察样本构成。
- 做关系变化分析时,锁定「目标账号 ID」,比较不同「采集时间」的「粉丝账号 ID」,识别新增或持续出现的样本。
适用边界
一次查询一个 Instagram 数字账号 ID,只读取历史库已有的粉丝明细;最多汇总 10 万条记录。
- 适合用于
- 需要快速查询历史库中已有的 Instagram 粉丝列表时
- 需要整理粉丝账号 ID、用户名、头像和认证状态时
- 需要根据采集时间复核历史粉丝关系时
- 不要用于
- 需要现场重新采集最新粉丝列表时——请使用 Instagram 粉丝列表实时采集 App
- 只知道 Instagram 用户名或主页地址时——本 App 要求准确的账号 ID
- 需要历史库未收录的资料时——本 App 只返回已有历史记录
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1鉴权或授权失败时联系管理员检查 Instagram 数据服务权限
- 2返回空结果通常表示账号 ID 错误或历史库尚未收录,可改用实时采集 App
- 3临时限流、服务不可用或超时时可稍后原样重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| account_id | Instagram 账号 ID | string | 是 | — | — | 20677013713 | 填写要查询粉丝列表的 Instagram 数字账号 ID,不要填写用户名、@ 符号或主页地址。 |
| pageIndex | pageIndex | integer | 是 | — | 1–100 | 1 | 历史数据分页获取的页码值,最多获取100页数据, |
| pageSize | pageSize | integer | 是 | — | 1–100 | 1 | 历史数据分页获取每页的数据条数,每页最多获取100条数据, |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| cur_id | 记录 ID | string | — | 本条历史粉丝关系记录的唯一标识,可能为空。 |
| account_id | 目标账号 ID | string | — | 被查询的 Instagram 账号 ID,可能为空。 |
| biz_id | 业务标识 | string | — | 本条数据关联的业务标识,可能为空。 |
| keyword | 采集关键词 | string | — | 触发本条记录的 Instagram 账号 ID,可能为空。 |
| fan_account_id | 粉丝账号 ID | string | — | 粉丝账号的 Instagram 唯一标识,可能为空。 |
| fan_account_name | 粉丝展示名 | string | — | 粉丝账号公开展示的名称,可能为空。 |
| fan_username | 粉丝用户名 | string | — | 粉丝账号的 Instagram 用户名,可能为空。 |
| fan_avatar_url | 粉丝头像 | string | — | 粉丝账号的公开头像地址,可能为空。 |
| is_private | 是否私密 | boolean | — | 粉丝账号是否为私密账号,未判断时可能为空。 |
| is_verified | 是否认证 | boolean | — | 粉丝账号是否为认证账号,未判断时可能为空。 |
| relation_type | 关系类型 | string | — | 账号关系类型,例如粉丝关系,可能为空。 |
| crawl_time | 采集时间 | string | — | 本条粉丝关系的采集时间,可能为空。 |
记录 Schema
输出按记录逐条返回。记录主键为 cur_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"cur_id": {
"type": "string",
"title": "记录 ID",
"description": "本条历史粉丝关系记录的唯一标识,可能为空。"
},
"account_id": {
"type": "string",
"title": "目标账号 ID",
"description": "被查询的 Instagram 账号 ID,可能为空。"
},
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "本条数据关联的业务标识,可能为空。"
},
"keyword": {
"type": "string",
"title": "采集关键词",
"description": "触发本条记录的 Instagram 账号 ID,可能为空。"
},
"fan_account_id": {
"type": "string",
"title": "粉丝账号 ID",
"description": "粉丝账号的 Instagram 唯一标识,可能为空。"
},
"fan_account_name": {
"type": "string",
"title": "粉丝展示名",
"description": "粉丝账号公开展示的名称,可能为空。"
},
"fan_username": {
"type": "string",
"title": "粉丝用户名",
"description": "粉丝账号的 Instagram 用户名,可能为空。"
},
"fan_avatar_url": {
"type": "string",
"title": "粉丝头像",
"description": "粉丝账号的公开头像地址,可能为空。"
},
"is_private": {
"type": "boolean",
"title": "是否私密",
"description": "粉丝账号是否为私密账号,未判断时可能为空。"
},
"is_verified": {
"type": "boolean",
"title": "是否认证",
"description": "粉丝账号是否为认证账号,未判断时可能为空。"
},
"relation_type": {
"type": "string",
"title": "关系类型",
"description": "账号关系类型,例如粉丝关系,可能为空。"
},
"crawl_time": {
"type": "string",
"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-fans-history": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-fans-history",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。