概览
想了解一个品牌、产品或话题在 Facebook 上被怎样讨论?输入一个关键词,即可得到与之相关的公开帖子清单,连同发帖账号、正文、发布时间和原帖链接一并整理出来。
这份数据可补足品牌日常观察中的一手声音:既能看到用户围绕某个词在说什么,也能看到哪些账号在持续发声。连续收集同一关键词的帖子,更容易发现讨论主题、内容角度和传播主体的变化。
数据说明
数据来自 Facebook 上公开可见的帖子内容,覆盖能够按关键词检索到的公开发帖账号与帖子。相同帖子按帖子编号去重;受隐私设置、登录限制、删除、地区限制或未被公开展示影响的内容不会出现在结果中。帖子正文、账号名称和链接均以收录时可见的信息为准;发布时间为帖子展示的时间,采集时间反映该记录被收录的时刻。
结果长什么样
每条记录是一篇命中关键词的公开帖子:
| 帖子编号 | 账号名称 | 命中关键词 | 发布时间 | 帖子正文 |
|---|---|---|---|---|
| 1650563837078747 | The Feed Barn LLC | Shokz | 2026-08-15T23:25:52 | Meet the Shokz OpenRun Pro 2 — perfect for workouts, work, or everyday listening! |
| 1131679039075537 | 馬拉松世界 | OPENRUN AIR | 2025-10-31T17:44:02 | Shokz OpenRun Air,開放式設計,佩戴舒適。 |
另有「帖子链接」「账号编号」和「采集时间」等信息,便于回看原帖和追踪记录变化。
应用场景
- 做品牌声量观察时,按「发布时间」汇总「命中关键词」出现频率,判断讨论热度的变化。
- 做内容洞察时,阅读「帖子正文」并结合「账号名称」归类发帖主体,找出高频卖点、使用场景和讨论角度。
- 做传播追踪时,定期对比「帖子编号」与「帖子链接」,识别新出现的内容并回看原始讨论。
适用边界
仅采集 Facebook 公开可见的关键词帖子;单次最多返回 10,000 条记录。
- 适合用于
- 需要按品牌词、产品词或话题词收集 Facebook 公开帖子时
- 需要获得帖子正文、账号和发布时间,用于舆情或内容分析时
- 不要用于
- 需要查询指定 Facebook 账号的完整历史内容时
- 需要获取非公开、仅好友可见或受访问限制的帖子时
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回空结果时,先检查关键词的拼写、语言和热度,再换用更具体或更常见的词重新提交
- 2任务失败或过期时,使用相同关键词重新提交一次;鉴权失败需先配置访问凭证
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| keyword | 采集关键词 | string | 是 | — | — | Shokz | 要查找的品牌、产品或话题词,例如 Shokz。请填写一个清晰的关键词,避免整句描述。 |
| crawlNum | crawlNum | string | 否 | — | — | 1 | 采集的结果条数 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| content_id | 帖子编号 | string | — | 帖子在 Facebook 中的唯一标识 |
| post_text | 帖子正文 | string | — | 帖子公开展示的文字内容 |
| post_url | 帖子链接 | string | — | 帖子公开访问链接 |
| account_id | 账号编号 | string | — | 发布帖子的 Facebook 账号标识 |
| account_name | 账号名称 | string | — | 发布帖子时展示的账号名称 |
| keyword | 命中关键词 | string | — | 该帖子命中的采集关键词 |
| published_at | 发布时间 | string | — | 帖子在 Facebook 上展示的发布时间 |
| collected_at | 采集时间 | string | — | 该帖子被收录的时间 |
| account_avatar_url | 账号头像 | string | — | 发布账号的头像图片地址,原始记录未提供时为空。 |
| account_home_url | 账号主页 | string | — | 发布账号的主页地址,原始记录未提供时为空。 |
| account_identity | 账号身份 | string | — | 发布账号的身份标识文本,原始记录未提供时为空。 |
| attached_content | 附加内容 | string | — | 帖子附加内容的原始文本,原始记录未提供时为空。 |
| biz_id | 业务标识 | string | — | 帖子关联的业务标识,原始记录未提供时为空。 |
| co_creator_info | 联合创作者 | string | — | 帖子联合创作者信息的原始文本,原始记录未提供时为空。 |
| comment_count | 评论数 | string | — | 帖子获得的评论数量,原始记录未提供时为空。 |
| content_type | 帖子类型 | string | — | 帖子的内容类型,原始记录未提供时为空。 |
| cover_image_url | 封面图链接 | string | — | 帖子封面图片地址,原始记录未提供时为空。 |
| external_url | 外部链接 | string | — | 帖子关联的外部页面地址,原始记录未提供时为空。 |
| feedback_id | 反馈编号 | string | — | 帖子在 Facebook 反馈体系中的标识,原始记录未提供时为空。 |
| forward_count | 转发数 | string | — | 帖子被转发的次数,原始记录未提供时为空。 |
| group_id | 群组编号 | string | — | 帖子所属 Facebook 群组的标识,原始记录未提供时为空。 |
| image_urls | 图片链接 | string | — | 帖子包含的图片链接原始文本,原始记录未提供时为空。 |
| is_video | 是否视频 | boolean | — | 帖子是否包含视频内容,原始记录未提供时为空。 |
| like_count | 点赞数 | string | — | 帖子获得的点赞数量,原始记录未提供时为空。 |
| live_viewer_count | 实时观看数 | string | — | 直播帖子的实时观看人数,原始记录未提供时为空。 |
| media_infos | 媒体信息 | string | — | 帖子图片或视频等媒体内容的原始明细文本,原始记录未提供时为空。 |
| paid_partnership | 付费合作 | boolean | — | 帖子是否标记为付费合作内容,原始记录未提供时为空。 |
| play_count | 播放数 | string | — | 帖子视频的播放次数,原始记录未提供时为空。 |
| reaction_like_count | 点赞反应数 | string | — | 帖子点赞类表情反应的数量,原始记录未提供时为空。 |
| retweeted_account_id | 转发来源账号 | string | — | 被转发内容所属账号的标识,原始记录未提供时为空。 |
| text_references | 文本引用 | string | — | 帖子正文中引用对象的原始明细文本,原始记录未提供时为空。 |
| timestamp | 记录时间戳 | string | — | 接口记录的帖子时间戳,原始记录未提供时为空。 |
| top_level_url | 顶层帖子链接 | string | — | 帖子所属顶层内容的页面地址,原始记录未提供时为空。 |
| top_reactions_count | 热门反应数 | string | — | 帖子热门表情反应的数量,原始记录未提供时为空。 |
| video_urls | 视频链接 | string | — | 帖子包含的视频链接原始文本,原始记录未提供时为空。 |
| view_count | 浏览数 | string | — | 帖子获得的浏览次数,原始记录未提供时为空。 |
| visibility_scope | 可见范围 | string | — | 帖子在 Facebook 中的可见范围,原始记录未提供时为空。 |
| submitted_keyword | 提交关键词 | string | — | 本次采集任务提交的搜索关键词。 |
| no_data | 无数据 | boolean | — | 该关键词在本次任务中是否没有可返回的帖子数据。 |
记录 Schema
输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "帖子编号",
"description": "帖子在 Facebook 中的唯一标识"
},
"post_text": {
"type": "string",
"title": "帖子正文",
"description": "帖子公开展示的文字内容"
},
"post_url": {
"type": "string",
"title": "帖子链接",
"description": "帖子公开访问链接"
},
"account_id": {
"type": "string",
"title": "账号编号",
"description": "发布帖子的 Facebook 账号标识"
},
"account_name": {
"type": "string",
"title": "账号名称",
"description": "发布帖子时展示的账号名称"
},
"keyword": {
"type": "string",
"title": "命中关键词",
"description": "该帖子命中的采集关键词"
},
"published_at": {
"type": "string",
"title": "发布时间",
"description": "帖子在 Facebook 上展示的发布时间"
},
"collected_at": {
"type": "string",
"title": "采集时间",
"description": "该帖子被收录的时间"
},
"account_avatar_url": {
"type": "string",
"title": "账号头像",
"description": "发布账号的头像图片地址,原始记录未提供时为空。"
},
"account_home_url": {
"type": "string",
"title": "账号主页",
"description": "发布账号的主页地址,原始记录未提供时为空。"
},
"account_identity": {
"type": "string",
"title": "账号身份",
"description": "发布账号的身份标识文本,原始记录未提供时为空。"
},
"attached_content": {
"type": "string",
"title": "附加内容",
"description": "帖子附加内容的原始文本,原始记录未提供时为空。"
},
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "帖子关联的业务标识,原始记录未提供时为空。"
},
"co_creator_info": {
"type": "string",
"title": "联合创作者",
"description": "帖子联合创作者信息的原始文本,原始记录未提供时为空。"
},
"comment_count": {
"type": "string",
"title": "评论数",
"description": "帖子获得的评论数量,原始记录未提供时为空。"
},
"content_type": {
"type": "string",
"title": "帖子类型",
"description": "帖子的内容类型,原始记录未提供时为空。"
},
"cover_image_url": {
"type": "string",
"title": "封面图链接",
"description": "帖子封面图片地址,原始记录未提供时为空。"
},
"external_url": {
"type": "string",
"title": "外部链接",
"description": "帖子关联的外部页面地址,原始记录未提供时为空。"
},
"feedback_id": {
"type": "string",
"title": "反馈编号",
"description": "帖子在 Facebook 反馈体系中的标识,原始记录未提供时为空。"
},
"forward_count": {
"type": "string",
"title": "转发数",
"description": "帖子被转发的次数,原始记录未提供时为空。"
},
"group_id": {
"type": "string",
"title": "群组编号",
"description": "帖子所属 Facebook 群组的标识,原始记录未提供时为空。"
},
"image_urls": {
"type": "string",
"title": "图片链接",
"description": "帖子包含的图片链接原始文本,原始记录未提供时为空。"
},
"is_video": {
"type": "boolean",
"title": "是否视频",
"description": "帖子是否包含视频内容,原始记录未提供时为空。"
},
"like_count": {
"type": "string",
"title": "点赞数",
"description": "帖子获得的点赞数量,原始记录未提供时为空。"
},
"live_viewer_count": {
"type": "string",
"title": "实时观看数",
"description": "直播帖子的实时观看人数,原始记录未提供时为空。"
},
"media_infos": {
"type": "string",
"title": "媒体信息",
"description": "帖子图片或视频等媒体内容的原始明细文本,原始记录未提供时为空。"
},
"paid_partnership": {
"type": "boolean",
"title": "付费合作",
"description": "帖子是否标记为付费合作内容,原始记录未提供时为空。"
},
"play_count": {
"type": "string",
"title": "播放数",
"description": "帖子视频的播放次数,原始记录未提供时为空。"
},
"reaction_like_count": {
"type": "string",
"title": "点赞反应数",
"description": "帖子点赞类表情反应的数量,原始记录未提供时为空。"
},
"retweeted_account_id": {
"type": "string",
"title": "转发来源账号",
"description": "被转发内容所属账号的标识,原始记录未提供时为空。"
},
"text_references": {
"type": "string",
"title": "文本引用",
"description": "帖子正文中引用对象的原始明细文本,原始记录未提供时为空。"
},
"timestamp": {
"type": "string",
"title": "记录时间戳",
"description": "接口记录的帖子时间戳,原始记录未提供时为空。"
},
"top_level_url": {
"type": "string",
"title": "顶层帖子链接",
"description": "帖子所属顶层内容的页面地址,原始记录未提供时为空。"
},
"top_reactions_count": {
"type": "string",
"title": "热门反应数",
"description": "帖子热门表情反应的数量,原始记录未提供时为空。"
},
"video_urls": {
"type": "string",
"title": "视频链接",
"description": "帖子包含的视频链接原始文本,原始记录未提供时为空。"
},
"view_count": {
"type": "string",
"title": "浏览数",
"description": "帖子获得的浏览次数,原始记录未提供时为空。"
},
"visibility_scope": {
"type": "string",
"title": "可见范围",
"description": "帖子在 Facebook 中的可见范围,原始记录未提供时为空。"
},
"submitted_keyword": {
"type": "string",
"title": "提交关键词",
"description": "本次采集任务提交的搜索关键词。"
},
"no_data": {
"type": "boolean",
"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": {
"mona_kk__facebook-keyword-posts": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/facebook-keyword-posts",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 3 条为一个计费单位,不足 3 条按 3 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。