概览
输入 Facebook 群组 ID,返回该群组内公开帖子的列表数据:每条帖子带正文、作者、发布时间和完整的互动计数。社群运营、竞品社群监测、垂直话题情报收集,都绕不开"一个群里大家在聊什么、哪些帖子热度高"这个问题——这份数据把答案变成结构化表格。
提交后任务在后台运行,可指定每个群组采集的帖子数量上限,完成后按群组内顺序返回帖子明细,正文、媒体附件、互动指标一次带全。
数据说明
- 数据来自 Facebook 公开群组的帖子采集,仅覆盖无需登录即可查看的群组与帖子。
- 互动计数为采集时刻的快照值;私密群组、需审核加入的群组无法采集。
- 帖子按群组内出现顺序原样返回,不做去重与排序;不同时间提交可能采集到新增帖子。
结果长什么样
每条记录是群组内的一条帖子。以某公开群组的帖子为例:
| 帖子ID | 作者昵称 | 发布时间 | 点赞数 | 评论数 | 群组名称 |
|---|---|---|---|---|---|
| 1234567890123 | 群友甲 | 2024-05-02 | 34 | 8 | 某兴趣交流群 |
| 9876543210987 | 群友乙 | 2024-05-01 | 156 | 42 | 某兴趣交流群 |
另有帖子正文、图片视频链接、各表情计数、数据更新时间等字段。
应用场景
- 摸底社群活跃度时,统计一段时间内帖子的「点赞数」「评论数」分布,判断群组是少数人活跃还是普遍活跃。
- 挖掘社群热门内容时,按「表情总数」「分享数」比较帖子,提取高互动内容的共性。
- 监测垂直话题时,定期采集同一群组,对比「发布时间」「作者昵称」的构成变化,发现新活跃成员与新话题。
适用边界
按群组ID采集Facebook公开群组内的帖子列表;仅覆盖无需登录即可查看的公开群组,不含私密或需审核加入的群组。
- 适合用于
- 需要获取某个Facebook公开群组内的帖子列表与互动数据时
- 需要做社群活跃度分析、热门内容挖掘或垂直话题监测时
- 不要用于
- 需要立即返回结果的场景——任务是后台异步执行,提交后需等待采集完成
- 需要采集单个帖子的完整详情时——用帖子详情采集类应用
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务失败或结果为空时可原样重新提交,建议确认群组为公开群组且ID正确
- 2部分群组帖子可能因隐私设置或被删除而无法采集
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| group_ids | 群组ID | array<string> | 是 | — | — | ["1238025676403575"] | 要采集的Facebook公开群组的ID,每项填写一个群组ID |
| max_posts | 每个群组最多采集帖子数 | integer | 否 | — | 1– | — | 单个群组本次最多采集的帖子数量,省略时按任务默认量采集 |
| 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 | — | 帖子所在群组的链接 |
| clean_update_time | 数据更新时间 | 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": "帖子所在群组的链接"
},
"clean_update_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": {
"marshall9__facebook-group-posts": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=marshall9/facebook-group-posts",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 3 条为一个计费单位,不足 3 条按 3 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。