logo

Facebook-用户采集

输入Facebook用户名，返回该账号主页的公开档案数据，含粉丝数、获赞数、简介、分类、联系方式、认证信息等。

数据获取Facebook账号主页互动数据

概览

输入 Facebook 用户名，返回该账号主页的公开档案数据：粉丝数、获赞数、简介、分类、联系方式、认证信息等。做海外达人筛选、竞品主页监测、账号资料核验时，这些字段拼出一份账号画像，省去逐页人工翻看。

提交后任务在后台运行，返回的每条记录是一个用户主页的完整档案快照，适合批量处理一串目标账号。

数据说明

  • 数据来自 Facebook 用户公开主页的采集结果，仅覆盖无需登录即可查看的主页。
  • 「粉丝数」「获赞数」「讨论数」为采集时刻的快照值，不同时间提交会得到不同数值。
  • 联系方式类字段（邮箱、网站、地址）只有主页主动公开时才有值，为空表示未公开而非遗漏。
  • 不做去重，同一账号多次提交会产生多条记录，可用于对比档案随时间的变化。

结果长什么样

每条记录是一个用户主页的档案快照。以两个公开主页为例：

用户ID主页名称粉丝数获赞数主营分类认证信息
20531316728Facebook190000000180000000Internet Company已认证
1000643599123某品牌主页8600075000Retail Company无

另有简介、网站、地址、头像封面链接、创建日期等字段。

应用场景

  • 筛选合作达人时，用「粉丝数」「获赞数」「讨论数」评估账号体量与真实互动水平，过滤低活跃账号。
  • 核验账号身份时，查「认证信息」「主营分类」「创建日期」，判断账号是否官方与可信。
  • 监测竞品主页时，定期提交同一账号，对比「粉丝数」「到访数」的变化，跟踪其增长趋势。

适用边界

按用户名采集Facebook公开主页的档案数据，一次可提交多个用户名；仅覆盖公开可见的主页，不含私密个人资料。

  • 适合用于
  • 需要批量获取Facebook公开主页的档案与粉丝数据时
  • 需要做达人筛选、账号核验或竞品主页监测时
  • 不要用于
  • 需要立即返回结果的场景——任务是后台异步执行，提交后需等待采集完成
  • 需要采集用户发布的帖子内容时——用帖子采集类应用

失败处理

作者声明的失败与重试处理方式，接入时建议一并写进系统提示词。

  1. 1任务失败或结果为空时可原样重新提交，建议确认用户名拼写正确且主页为公开状态
  2. 2部分主页可能因隐私设置或已停用而无法采集

输入参数

调用本 App 需要传入的参数，与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
usernames用户名array<string>是——["facebook"]要采集的Facebook公开主页的用户名，每项填写一个用户名
max_collected_rows最多采集条数integer否10001–—本次任务最多采集的记录条数，省略时按任务默认量采集；实际返回可能略少于该值

输出数据

单条记录的字段结构，与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
facebook_id用户IDstring—Facebook用户的唯一标识
page_name主页名称string—用户主页的名称
page_url主页链接string—用户主页的链接
user_name用户名string—用户的账号名
author_id作者标识string—用户作为作者的标识
facebook_url个人主页链接string—用户个人主页的链接
fans_count粉丝数string—主页的粉丝数量
follow_count关注数string—主页关注他人的数量
likes_count获赞数string—主页累计获得的点赞数
talking_about_count讨论数string—正在谈论该主页的人数
were_here_count到访数string—曾到访该主页的人数
profile_photo头像string—用户头像的标识
profile_picture_url头像链接string—用户头像图片的链接
cover_photo_url封面链接string—主页封面图片的链接
intro简介string—用户主页的简介文字
info详细信息string—用户主页的详细介绍
category主营分类string—用户主页的经营分类
categories分类列表string—用户主页的全部经营分类，多个以逗号分隔
address地址string—用户主页登记的地址
address_url地址链接string—地址对应的地图链接
location位置string—用户主页的所在地
website网站string—用户主页登记的网站
websites网站列表string—用户主页登记的全部网站，多个以逗号分隔
email邮箱string—用户主页公开的电子邮箱
messenger通讯账号string—用户的Messenger联系账号
creation_date创建日期string—用户主页的创建日期
create_time入库时间string—记录采集入库的时间
ad_status广告状态string—用户主页的广告投放状态
page_ad_library广告库链接string—用户主页的广告资料库链接
user_certification认证信息string—用户的认证信息
url采集链接string—本次采集的用户主页地址

记录 Schema

输出按记录逐条返回。记录主键为 facebook_id，去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "facebook_id": {
      "type": "string",
      "title": "用户ID",
      "description": "Facebook用户的唯一标识"
    },
    "page_name": {
      "type": "string",
      "title": "主页名称",
      "description": "用户主页的名称"
    },
    "page_url": {
      "type": "string",
      "title": "主页链接",
      "description": "用户主页的链接"
    },
    "user_name": {
      "type": "string",
      "title": "用户名",
      "description": "用户的账号名"
    },
    "author_id": {
      "type": "string",
      "title": "作者标识",
      "description": "用户作为作者的标识"
    },
    "facebook_url": {
      "type": "string",
      "title": "个人主页链接",
      "description": "用户个人主页的链接"
    },
    "fans_count": {
      "type": "string",
      "title": "粉丝数",
      "description": "主页的粉丝数量"
    },
    "follow_count": {
      "type": "string",
      "title": "关注数",
      "description": "主页关注他人的数量"
    },
    "likes_count": {
      "type": "string",
      "title": "获赞数",
      "description": "主页累计获得的点赞数"
    },
    "talking_about_count": {
      "type": "string",
      "title": "讨论数",
      "description": "正在谈论该主页的人数"
    },
    "were_here_count": {
      "type": "string",
      "title": "到访数",
      "description": "曾到访该主页的人数"
    },
    "profile_photo": {
      "type": "string",
      "title": "头像",
      "description": "用户头像的标识"
    },
    "profile_picture_url": {
      "type": "string",
      "title": "头像链接",
      "description": "用户头像图片的链接"
    },
    "cover_photo_url": {
      "type": "string",
      "title": "封面链接",
      "description": "主页封面图片的链接"
    },
    "intro": {
      "type": "string",
      "title": "简介",
      "description": "用户主页的简介文字"
    },
    "info": {
      "type": "string",
      "title": "详细信息",
      "description": "用户主页的详细介绍"
    },
    "category": {
      "type": "string",
      "title": "主营分类",
      "description": "用户主页的经营分类"
    },
    "categories": {
      "type": "string",
      "title": "分类列表",
      "description": "用户主页的全部经营分类，多个以逗号分隔"
    },
    "address": {
      "type": "string",
      "title": "地址",
      "description": "用户主页登记的地址"
    },
    "address_url": {
      "type": "string",
      "title": "地址链接",
      "description": "地址对应的地图链接"
    },
    "location": {
      "type": "string",
      "title": "位置",
      "description": "用户主页的所在地"
    },
    "website": {
      "type": "string",
      "title": "网站",
      "description": "用户主页登记的网站"
    },
    "websites": {
      "type": "string",
      "title": "网站列表",
      "description": "用户主页登记的全部网站，多个以逗号分隔"
    },
    "email": {
      "type": "string",
      "title": "邮箱",
      "description": "用户主页公开的电子邮箱"
    },
    "messenger": {
      "type": "string",
      "title": "通讯账号",
      "description": "用户的Messenger联系账号"
    },
    "creation_date": {
      "type": "string",
      "title": "创建日期",
      "description": "用户主页的创建日期"
    },
    "create_time": {
      "type": "string",
      "title": "入库时间",
      "description": "记录采集入库的时间"
    },
    "ad_status": {
      "type": "string",
      "title": "广告状态",
      "description": "用户主页的广告投放状态"
    },
    "page_ad_library": {
      "type": "string",
      "title": "广告库链接",
      "description": "用户主页的广告资料库链接"
    },
    "user_certification": {
      "type": "string",
      "title": "认证信息",
      "description": "用户的认证信息"
    },
    "url": {
      "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 配置
{
  "mcpServers": {
    "marshall9__facebook-user-profile": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=marshall9/facebook-user-profile",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
查看我的 API Keys →

让 AI 自己完成配置

不想手动改配置？复制安装提示词，粘贴到任意 AI 客户端对话框，由它按自身方式完成接入（提示词会让 AI 向你索要 API Key，避免凭证留在对话记录或共享配置里）。

如需在同一个 MCP 连接里指定多个 App，前往 MCP 连接页（已为你指定本 App）。

价格

提交一次采集

每提交一次任务计费一次，与返回条数无关。

免费
返回一条记录

按实际成功返回的数据条数计费，任务失败不计费。

¥0.015/ 条

多个计费事件按各自口径独立累计，具体以每一项说明为准；任务失败不计费。

查看余额

立即体验

填写参数直接运行，结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.015 / 条