概览
每条数据对应一条 Facebook 公开帖子的完整快照:正文、作者信息、发布时间,以及点赞、评论、分享和各类表情反应的计数。做海外社媒运营或舆情跟踪时,手头往往只有一批帖子链接——这些帖子各自表现如何、谁在发、引发了什么互动,需要一份结构化的明细数据来回答。
提交帖子链接后任务在后台运行,完成后返回每个帖子的全部互动指标,可直接进入报表或分析流程。除核心互动计数外,还附带媒体附件、外部链接、直播观看数等扩展字段,适合需要细颗粒度数据的使用场景。
数据说明
- 数据来自 Facebook 公开帖子页面的采集结果,仅覆盖无需登录即可查看的内容。
- 各类表情计数(Like、Love、Haha、Wow、Sad、Angry、Care)均为采集时刻的页面快照值,不同时间提交任务可能得到不同数值。
- 私密帖子、已删除或被限流的内容无法返回;不做去重与排序,按采集顺序原样返回,同一帖子多次提交会产生多条记录。
结果长什么样
每条记录是一条帖子的完整快照。以两个公开帖子为例:
| 帖子ID | 作者昵称 | 发布时间 | 点赞数 | 评论数 | 分享数 |
|---|---|---|---|---|---|
| 10154009990506729 | 2015-08-27 | 1250 | 96 | 210 | |
| pfbid02Wq8x3 | 某品牌主页 | 2024-03-12 | 8430 | 517 | 1203 |
另有帖子正文、作者主页、各表情计数、图片视频链接、群组信息等字段。
应用场景
- 评估单帖传播效果时,比对「点赞数」「评论数」「分享数」「表情总数」,判断内容引发的互动强度与形态。
- 分析内容形态与互动的关系时,结合「是否视频」「视频播放数」「图片链接」,看视频帖与图文帖的互动差异。
- 追踪作者影响力时,用「作者昵称」「作者ID」「作者主页」聚合同一作者的多条帖子,汇总其内容表现。
- 监测帖子的情绪倾向时,对比「Like表情数」与「Angry表情数」「Sad表情数」的构成,粗判帖子情绪基调。
适用边界
按帖子详情页链接采集Facebook公开帖子的内容与互动数据,一次可提交多个链接;仅覆盖公开可见的帖子,不含私密或需登录查看的内容。
- 适合用于
- 需要按帖子链接批量获取Facebook公开帖子的正文、作者和互动数据时
- 需要针对特定帖子做传播效果评估、内容分析或舆情追踪时
- 不要用于
- 需要立即返回结果的场景——任务是后台异步执行,提交后需等待采集完成
- 需要按关键词搜索帖子时——用关键词搜索采集类应用
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务失败或结果为空时可原样重新提交,建议使用真实有效的公开帖子链接
- 2部分帖子可能因隐私设置或内容被删除而无法采集
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| post_urls | 帖子链接 | array<string> | 是 | — | — | ["https://www.facebook.com/20531316728/posts/10154009990506729/"] | 要采集的Facebook公开帖子详情页链接,每项填写一个链接 |
| max_collected_rows | 最多采集条数 | integer | 否 | 1000 | 1– | — | 本次任务最多采集的记录条数,省略时按任务默认量采集;实际返回可能略少于该值 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| feedback_id | 帖子ID | string | — | 帖子的唯一标识 |
| text | 帖子正文 | string | — | 帖子的文字内容 |
| url | 帖子链接 | string | — | 帖子的访问链接 |
| user_name | 作者昵称 | string | — | 发帖用户的昵称 |
| user_id | 作者ID | string | — | 发帖用户的标识 |
| user_title | 作者头衔 | string | — | 发帖用户的头衔 |
| user_home_page | 作者主页 | string | — | 发帖用户的主页链接 |
| user_thumbnail_url | 作者头像 | string | — | 发帖用户的头像链接 |
| user_certification | 作者认证 | string | — | 发帖用户的认证信息 |
| user_pfbid | 作者档案标识 | string | — | 发帖用户的档案基础标识 |
| publish_time | 发布时间 | string | — | 帖子发布的时间 |
| create_time | 入库时间 | string | — | 记录采集入库的时间 |
| comment_count | 评论数 | string | — | 帖子的评论数量 |
| share_count | 分享数 | string | — | 帖子被分享的次数 |
| digg_count | 点赞数 | string | — | 帖子被点赞的次数 |
| view_count | 观看数 | string | — | 帖子被浏览的次数 |
| reaction_like_count | Like表情数 | string | — | 点Like表情的数量 |
| reaction_love_count | Love表情数 | string | — | 点Love表情的数量 |
| reaction_haha_count | Haha表情数 | string | — | 点Haha表情的数量 |
| reaction_wow_count | Wow表情数 | string | — | 点Wow表情的数量 |
| reaction_sad_count | Sad表情数 | string | — | 点Sad表情的数量 |
| reaction_angry_count | Angry表情数 | string | — | 点Angry表情的数量 |
| reaction_care_count | Care表情数 | string | — | 点Care表情的数量 |
| top_reactions_count | 表情总数 | string | — | 各类表情反应的合计数量 |
| image | 首图链接 | string | — | 帖子第一张图片的链接 |
| images | 图片链接 | string | — | 帖子全部图片的链接,多个以逗号分隔 |
| video | 视频链接 | string | — | 帖子视频的链接 |
| video_play_count | 视频播放数 | string | — | 帖子视频被播放的次数 |
| is_video | 是否视频 | string | — | 帖子是否为视频内容 |
| live_viewer_count | 直播观看数 | string | — | 帖子直播的实时观看人数 |
| media_infos | 媒体信息 | string | — | 帖子附带媒体的描述信息 |
| attached_content | 附加内容 | string | — | 帖子附带的转引内容 |
| external_url | 外部链接 | string | — | 帖子指向的外部链接 |
| top_level_url | 原始链接 | string | — | 帖子所在顶层页面的链接 |
| text_references | 文本引用 | string | — | 帖子正文引用的内容 |
| note_id | 笔记标识 | string | — | 关联笔记的标识 |
| origin_user_id | 原始作者ID | string | — | 被转发内容的原作者标识 |
| paid_partnership | 付费合作 | string | — | 帖子是否为付费合作内容 |
| cooperation_infos | 合作信息 | string | — | 帖子的商业合作描述信息 |
| source_from | 内容来源 | string | — | 帖子内容的来源渠道 |
| user_action | 用户操作 | string | — | 发帖用户相关的操作标记 |
| group_id | 群组ID | string | — | 帖子所在群组的标识 |
| group_name | 群组名称 | string | — | 帖子所在群组的名称 |
| group_url | 群组链接 | string | — | 帖子所在群组的链接 |
记录 Schema
输出按记录逐条返回。记录主键为 feedback_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"feedback_id": {
"type": "string",
"title": "帖子ID",
"description": "帖子的唯一标识"
},
"text": {
"type": "string",
"title": "帖子正文",
"description": "帖子的文字内容"
},
"url": {
"type": "string",
"title": "帖子链接",
"description": "帖子的访问链接"
},
"user_name": {
"type": "string",
"title": "作者昵称",
"description": "发帖用户的昵称"
},
"user_id": {
"type": "string",
"title": "作者ID",
"description": "发帖用户的标识"
},
"user_title": {
"type": "string",
"title": "作者头衔",
"description": "发帖用户的头衔"
},
"user_home_page": {
"type": "string",
"title": "作者主页",
"description": "发帖用户的主页链接"
},
"user_thumbnail_url": {
"type": "string",
"title": "作者头像",
"description": "发帖用户的头像链接"
},
"user_certification": {
"type": "string",
"title": "作者认证",
"description": "发帖用户的认证信息"
},
"user_pfbid": {
"type": "string",
"title": "作者档案标识",
"description": "发帖用户的档案基础标识"
},
"publish_time": {
"type": "string",
"title": "发布时间",
"description": "帖子发布的时间"
},
"create_time": {
"type": "string",
"title": "入库时间",
"description": "记录采集入库的时间"
},
"comment_count": {
"type": "string",
"title": "评论数",
"description": "帖子的评论数量"
},
"share_count": {
"type": "string",
"title": "分享数",
"description": "帖子被分享的次数"
},
"digg_count": {
"type": "string",
"title": "点赞数",
"description": "帖子被点赞的次数"
},
"view_count": {
"type": "string",
"title": "观看数",
"description": "帖子被浏览的次数"
},
"reaction_like_count": {
"type": "string",
"title": "Like表情数",
"description": "点Like表情的数量"
},
"reaction_love_count": {
"type": "string",
"title": "Love表情数",
"description": "点Love表情的数量"
},
"reaction_haha_count": {
"type": "string",
"title": "Haha表情数",
"description": "点Haha表情的数量"
},
"reaction_wow_count": {
"type": "string",
"title": "Wow表情数",
"description": "点Wow表情的数量"
},
"reaction_sad_count": {
"type": "string",
"title": "Sad表情数",
"description": "点Sad表情的数量"
},
"reaction_angry_count": {
"type": "string",
"title": "Angry表情数",
"description": "点Angry表情的数量"
},
"reaction_care_count": {
"type": "string",
"title": "Care表情数",
"description": "点Care表情的数量"
},
"top_reactions_count": {
"type": "string",
"title": "表情总数",
"description": "各类表情反应的合计数量"
},
"image": {
"type": "string",
"title": "首图链接",
"description": "帖子第一张图片的链接"
},
"images": {
"type": "string",
"title": "图片链接",
"description": "帖子全部图片的链接,多个以逗号分隔"
},
"video": {
"type": "string",
"title": "视频链接",
"description": "帖子视频的链接"
},
"video_play_count": {
"type": "string",
"title": "视频播放数",
"description": "帖子视频被播放的次数"
},
"is_video": {
"type": "string",
"title": "是否视频",
"description": "帖子是否为视频内容"
},
"live_viewer_count": {
"type": "string",
"title": "直播观看数",
"description": "帖子直播的实时观看人数"
},
"media_infos": {
"type": "string",
"title": "媒体信息",
"description": "帖子附带媒体的描述信息"
},
"attached_content": {
"type": "string",
"title": "附加内容",
"description": "帖子附带的转引内容"
},
"external_url": {
"type": "string",
"title": "外部链接",
"description": "帖子指向的外部链接"
},
"top_level_url": {
"type": "string",
"title": "原始链接",
"description": "帖子所在顶层页面的链接"
},
"text_references": {
"type": "string",
"title": "文本引用",
"description": "帖子正文引用的内容"
},
"note_id": {
"type": "string",
"title": "笔记标识",
"description": "关联笔记的标识"
},
"origin_user_id": {
"type": "string",
"title": "原始作者ID",
"description": "被转发内容的原作者标识"
},
"paid_partnership": {
"type": "string",
"title": "付费合作",
"description": "帖子是否为付费合作内容"
},
"cooperation_infos": {
"type": "string",
"title": "合作信息",
"description": "帖子的商业合作描述信息"
},
"source_from": {
"type": "string",
"title": "内容来源",
"description": "帖子内容的来源渠道"
},
"user_action": {
"type": "string",
"title": "用户操作",
"description": "发帖用户相关的操作标记"
},
"group_id": {
"type": "string",
"title": "群组ID",
"description": "帖子所在群组的标识"
},
"group_name": {
"type": "string",
"title": "群组名称",
"description": "帖子所在群组的名称"
},
"group_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": {
"marshall9__facebook-post-details": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=marshall9/facebook-post-details",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。