概览
面向一个指定的 Instagram 账号,这个 App 会现场整理当次能够取得的粉丝关系与公开资料。每条记录把目标账号与一名粉丝关联起来,并附上粉丝账号 ID、用户名、展示名称、头像、私密状态、认证状态和采集时间。
这份数据适合作为受众结构观察、达人账号研究和账号关系盘点的原始底表。相比人工逐个查看粉丝主页,结构化清单更便于筛选、分组和跨次对比,也能保留当次采集时看到的账号状态。
数据说明
数据来自对目标账号粉丝关系的当次采集,同一粉丝账号在一份结果中按粉丝账号 ID 去重。账号名称、头像、私密状态与认证状态反映采集时能够取得的公开资料,之后可能变化。结果只覆盖当次可访问的粉丝关系;已失效、被隐藏或访问受限的资料可能缺失,部分展示名称和头像也可能为空。
结果长什么样
每条记录代表目标账号与一名粉丝之间的一条关系:
| 目标账号 ID | 粉丝账号 ID | 粉丝用户名 | 粉丝展示名 | 是否私密 | 是否认证 |
|---|---|---|---|---|---|
| 20677013713 | 4233911646 | robertpmuller | Robert Muller | 否 | 否 |
| 20677013713 | 53502712 | clemeddl | dientedeleon | 否 | 否 |
结果中另有粉丝头像、关系类型和采集时间等信息。
应用场景
- 做受众构成观察时,结合「粉丝用户名」「粉丝展示名」整理账号线索,再用「是否私密」「是否认证」做基础分组。
- 做达人账号研究时,用「粉丝账号 ID」统计独立样本,并按「关系类型」核对账号关系。
- 做跨次变化分析时,以「目标账号 ID」锁定研究对象,再对比不同批次的「粉丝账号 ID」和「采集时间」,观察样本新增与消失情况。
适用边界
一次采集一个 Instagram 数字账号 ID,可指定 1–1000 条公开粉丝记录;仅覆盖当次能够获取的公开资料。
- 适合用于
- 历史库没有目标账号的粉丝列表,需要现场采集时
- 需要整理粉丝账号 ID、用户名、头像和认证状态时
- 需要为受众研究、达人分析或账号关系分析获取当次样本时
- 不要用于
- 历史库已有目标账号且希望快速返回时——请使用 Instagram 粉丝列表历史查询 App
- 只知道 Instagram 用户名或主页地址时——本 App 要求准确的账号 ID
- 需要私密资料或未配置字段时——本 App 只采集可公开获取的信息
- 必须马上拿到结果时——任务需要在后台处理
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1鉴权或授权失败不是重试问题,应先让管理员检查 Instagram 数据服务权限
- 2等待超时后先查看原任务状态,再决定是否重新运行,避免重复提交
- 3临时限流或服务不可用可稍后重试;任务失败或过期后可以重新运行
- 4任务部分成功时仍会返回已经完成的粉丝记录
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| account_id | Instagram 账号 ID | string | 是 | — | — | 20677013713 | 填写要采集粉丝列表的 Instagram 数字账号 ID,不要填写用户名、@ 符号或主页地址。 |
| crawl_num | 粉丝采集数量 | integer | 是 | — | 1–1000 | 1 | 希望采集的粉丝记录数量,可填 1–1000;数量越大,等待时间和费用可能越高。 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| 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
输出按记录逐条返回。记录主键为 fan_account_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"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": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-fans",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 10 条为一个计费单位,不足 10 条按 10 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。