logo

Facebook-关键词搜索采集

输入关键词,返回Facebook上与该关键词相关的公开帖子,含正文、作者、发布时间及点赞、评论、分享、各类表情等互动计数。

概览

输入关键词,返回 Facebook 上与该关键词相关的公开帖子:每条帖子带正文、作者、发布时间和完整互动计数。关键词情报、话题监测、竞品提及收集,起点都是"把这个话题下的帖子捞出来"——这份数据直接给出可分析的结构化结果。

提交后任务在后台运行,可指定每个关键词采集的帖子数量,完成后按搜索结果顺序返回帖子明细,正文、媒体附件、互动指标一并带全。

数据说明

  • 数据来自 Facebook 关键词搜索结果页的公开帖子采集,仅覆盖无需登录即可查看的内容。
  • 搜索结果随平台排序动态变化,不同时间提交同一关键词,采集到的帖子集合可能不同。
  • 互动计数为采集时刻的快照值;不做去重与排序,按搜索结果顺序原样返回。

结果长什么样

每条记录是关键词搜索结果中的一条帖子。以关键词「人工智能」的结果为例:

帖子ID作者昵称发布时间点赞数评论数分享数
1015400999123某科技主页2024-06-102300185320
pfbid03Kz9Ab某博主2024-06-094603752

另有帖子正文、各表情计数、图片视频链接、群组信息等字段。

应用场景

  • 监测品牌提及时,用品牌名做关键词,看「作者昵称」「点赞数」「分享数」,掌握谁在谈论品牌、声量多大。
  • 做话题趋势分析时,定期跑同一关键词,对比「发布时间」「帖子ID」的增量,观察话题热度的变化节奏。
  • 收集内容素材时,按「表情总数」「评论数」筛选高互动帖子,参考其「帖子正文」与「图片链接」的内容形态。

适用边界

按关键词采集Facebook搜索结果中的公开帖子,一次可提交多个关键词;仅覆盖公开可见的帖子,搜索结果随平台排序动态变化。

  • 适合用于
  • 需要按关键词批量获取Facebook相关公开帖子时
  • 需要做话题监测、品牌提及收集或内容素材挖掘时
  • 不要用于
  • 需要立即返回结果的场景——任务是后台异步执行,提交后需等待采集完成
  • 需要采集指定帖子的完整详情时——用帖子详情采集类应用

失败处理

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

  1. 1任务失败或结果为空时可原样重新提交,建议使用具体明确的关键词
  2. 2部分搜索结果帖子可能因隐私设置或被删除而无法采集

输入参数

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

字段名业务名称类型必填默认值枚举 / 约束示例说明
keywords搜索关键词array<string>["人工智能"]要在Facebook上搜索的关键词,每项填写一个关键词
max_results每个关键词最多采集条数integer1–单个关键词本次最多采集的帖子数量,省略时按任务默认量采集
max_collected_rows最多采集条数integer10001–本次任务最多采集的记录条数,省略时按任务默认量采集;实际返回可能略少于该值

输出数据

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

字段名业务名称类型示例说明
feedback_id帖子IDstring帖子的唯一标识
text帖子正文string帖子的文字内容
url帖子链接string帖子的访问链接
user_name作者昵称string发帖用户的昵称
user_id作者IDstring发帖用户的标识
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_countLike表情数string点Like表情的数量
reaction_love_countLove表情数string点Love表情的数量
reaction_haha_countHaha表情数string点Haha表情的数量
reaction_wow_countWow表情数string点Wow表情的数量
reaction_sad_countSad表情数string点Sad表情的数量
reaction_angry_countAngry表情数string点Angry表情的数量
reaction_care_countCare表情数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原始作者IDstring被转发内容的原作者标识
paid_partnership付费合作string帖子是否为付费合作内容
cooperation_infos合作信息string帖子的商业合作描述信息
source_from内容来源string帖子内容的来源渠道
user_action用户操作string发帖用户相关的操作标记
group_id群组IDstring帖子所在群组的标识
group_name群组名称string帖子所在群组的名称
group_url群组链接string帖子所在群组的链接

记录 Schema

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

output.schema
{
  "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 配置
{
  "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 条计。

¥0.045/ 3 条

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

立即体验

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

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