概览
输入关键词,返回 Facebook 上与该关键词相关的公开帖子:每条帖子带正文、作者、发布时间和完整互动计数。关键词情报、话题监测、竞品提及收集,起点都是"把这个话题下的帖子捞出来"——这份数据直接给出可分析的结构化结果。
提交后任务在后台运行,可指定每个关键词采集的帖子数量,完成后按搜索结果顺序返回帖子明细,正文、媒体附件、互动指标一并带全。
数据说明
- 数据来自 Facebook 关键词搜索结果页的公开帖子采集,仅覆盖无需登录即可查看的内容。
- 搜索结果随平台排序动态变化,不同时间提交同一关键词,采集到的帖子集合可能不同。
- 互动计数为采集时刻的快照值;不做去重与排序,按搜索结果顺序原样返回。
结果长什么样
每条记录是关键词搜索结果中的一条帖子。以关键词「人工智能」的结果为例:
| 帖子ID | 作者昵称 | 发布时间 | 点赞数 | 评论数 | 分享数 |
|---|---|---|---|---|---|
| 1015400999123 | 某科技主页 | 2024-06-10 | 2300 | 185 | 320 |
| pfbid03Kz9Ab | 某博主 | 2024-06-09 | 460 | 37 | 52 |
另有帖子正文、各表情计数、图片视频链接、群组信息等字段。
应用场景
- 监测品牌提及时,用品牌名做关键词,看「作者昵称」「点赞数」「分享数」,掌握谁在谈论品牌、声量多大。
- 做话题趋势分析时,定期跑同一关键词,对比「发布时间」「帖子ID」的增量,观察话题热度的变化节奏。
- 收集内容素材时,按「表情总数」「评论数」筛选高互动帖子,参考其「帖子正文」与「图片链接」的内容形态。
适用边界
按关键词采集Facebook搜索结果中的公开帖子,一次可提交多个关键词;仅覆盖公开可见的帖子,搜索结果随平台排序动态变化。
- 适合用于
- 需要按关键词批量获取Facebook相关公开帖子时
- 需要做话题监测、品牌提及收集或内容素材挖掘时
- 不要用于
- 需要立即返回结果的场景——任务是后台异步执行,提交后需等待采集完成
- 需要采集指定帖子的完整详情时——用帖子详情采集类应用
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务失败或结果为空时可原样重新提交,建议使用具体明确的关键词
- 2部分搜索结果帖子可能因隐私设置或被删除而无法采集
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| keywords | 搜索关键词 | array<string> | 是 | — | — | ["人工智能"] | 要在Facebook上搜索的关键词,每项填写一个关键词 |
| max_results | 每个关键词最多采集条数 | 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 | — | 帖子所在群组的链接 |
记录 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-keyword-search": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=marshall9/facebook-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 3 条为一个计费单位,不足 3 条按 3 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。