关于 facebook-research
用于收集 Facebook 公开证据的 PostPlus Skill,服务于营销、增长、创作者、社群、竞品和漏斗研究。它按任务调用帖子、评论、广告、活动、Marketplace 列表、主页和公开搜索等采集路线,并区分可见证据与不可获取的私人数据。
主要功能
- 01采集公开帖子与个人资料
- 02研究 Reels 和评论
- 03查看广告资料库创意
- 04查找活动和 Marketplace 列表
- 05发现主页与公开来源
- 06按证据需求选择研究路线
适用场景
- 01对标公开的竞品内容
- 02分析公开评论和受众疑问
- 03比较广告创意与行动号召
- 04寻找本地活动或 Marketplace 列表
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill facebook-research安装后在 Claude Code 中输入/facebook-research确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/ads-and-funnel.mdcommunity-voice.mdevents-and-local.mdorganic-benchmark.mdpage-and-group-audit.mdpartner-discovery.mdpublic-content.mdreels-and-video.mdshared-contract.mdshops-and-marketplace.md详细介绍
Facebook Research
当用户需要获取公开 Facebook 证据,以支持增长、营销、创作者、社群、竞品或转化漏斗决策时,使用此技能。证据包括主页/个人主页帖子、直接帖子、公开群组帖子、Reels、评论、广告资料库素材、活动、Marketplace 商品信息、主页资料或公开搜索结果。
只阅读与任务相符的一份参考资料。
收集路径
Facebook 提供了基于 URL 的公开主页/个人主页/群组/帖子内容收集路径,以及针对 Reels、评论、广告、活动、Marketplace、主页和搜索的专用路径。根据用户意图选择路径;PostPlus 负责处理执行细节。
所有帖子收集结果都会返回 output.items[];普通帖子、群组帖子和 Reels 的字段各不相同。请遵循所选参考资料。facebook-group-posts 和 facebook-groups 会采样相同的公开群组帖子;不要将两者作为独立的佐证分别运行。这两种群组路径都会返回按时间排序的帖子样本,且没有服务端关键词筛选。无法获取群组成员资格、创建日期或验证状态时,这些信息应标记为不可用,而不是 0 或 false。
仅使用 web-search 发现外部来源;其摘要不是 Facebook 帖子或评论证据。搜索结果页面字段的读取方式请遵循 references/public-content.md。
路径
| 用户意图 | 阅读 |
|---|---|
| 获取公开主页、个人主页、群组或帖子内容 | references/public-content.md |
| 主页健康状况、竞品主页、群组质量、公开形象审核 | references/page-and-group-audit.md |
| 自然流量吸引点、内容形式、竞品、帖子示例、内容模式 | references/organic-benchmark.md |
| Reels、短视频、视频吸引点、以媒体为主的基准分析 | references/reels-and-video.md |
| 评论、受众表达、异议、常见问题、群组讨论 | references/community-voice.md |
| 广告资料库素材、付费推广方案、行动号召、转化漏斗审核 | references/ads-and-funnel.md |
| 活动、本地推广、主办方、线下需求 | references/events-and-local.md |
| Marketplace 商品信息、本地商业、价格区间 | references/shops-and-marketplace.md |
| 合作伙伴/创作者/主办方发现、广泛 Facebook 搜索、主页验证 | references/partner-discovery.md |
| 私人个人主页、隐藏群组、成员列表、主页洞察、广告账户指标、定向、支出、ROAS | 停止并请用户提供公开来源或导出数据 |
首要问题
只有当答案会改变路径、来源、隐私边界、样本量或输出形式时,才提问。
| 缺少的信息 | 提问 |
|---|---|
| 非广告任务的种子信息 | 哪项 Facebook 来源应作为依据:主页、个人主页、群组、帖子 URL、关键词还是活动? |
| 决策目标 | 这项工作要支持什么决策:审核、基准分析、受众表达、广告、活动、Marketplace 还是发现? |
| 私人目标 | 你能提供公开 URL 或导出的数据集吗? |
| 非广告任务的范围过宽 | 首轮分析中,最重要的是哪 1-5 个来源? |
对于广告任务,产品 URL、不熟悉的品牌、品类或问题都足以作为种子信息。自行发现相关产品;请遵循 references/ads-and-funnel.md 中针对广告的数量和停止规则。
不要询问用户内部路径标识符、架构、实现选择、重试方式、凭据、隐藏筛选条件或内部路由。
执行规范
- 选择一个参考文档和一条路径。
- 对于广告,按照
references/ads-and-funnel.md中的说明收集最新证据;不要自动搜索已存储的广告库。浏览广告库属于单独的用户目标。其他情况下,执行能够回答决策所需的最小规模真实采集。 - 如果来源彼此独立且互不依赖,则并行处理。
- 如果执行成功,但证据为空、稀疏、嘈杂或偏离主题,则在接受证据或用尽证据前,应用以下质量规则。
- 将 JSON 作为事实来源;如果采集了条目级证据,则生成精简的 HTML 证据文档。
- 返回简短的聊天答复:范围、数量、最有力的发现、最大缺口、文档路径和下一步行动。
仅使用所选路径显示的公开筛选条件。
公开命令范围
-
选择最匹配且最精简的研究路径,并直接运行。
-
就绪状态诊断:
postplus doctor --skill facebook-research。 -
如果某条路径的语义标志尚不明确,请使用
postplus research run <route> --help检查该路径。 -
运行
postplus research run <route> --<semantic flags> --wait --output <result.json>。 -
仅传入公开 URL、搜索词、地点、范围和结果数量限制。
-
对非广告路径,首轮采集须限制规模;检查首轮结果后再扩大范围。 对于广告,根据广告参考文档采集足以满足所请求证据目标的内容。 遇到硬错误时停止。不要悄然切换来源,也不要编造缺失数据。
-
所请求的任务使用先前 PostPlus 积分;执行前先检查当前价格和余额。仅估算的请求不执行。若积分不足,则停止;不要充值、购买订阅,也不要重复执行结果不确定的付费操作。
命令选择
| 证据需求 | 路径 | 语义输入 | 首轮采集 |
|---|---|---|---|
| 公开主页/个人主页帖子 | facebook-profile-posts | --url、--limit | 1-5 个 URL,20 条帖子 |
| 直接帖子证据 | facebook-post-by-url | --url | 1-10 个 URL |
| 公开群组帖子 | facebook-group-posts | --url、--limit | 1-3 个群组,20 条帖子 |
| 广告资料库创意 | facebook-ads-library | --query、--country、--status、--limit | 参阅广告参考文档:按目标确定采集规模 |
| 帖子/短视频评论 | facebook-comments | --url、--limit | 1-5 个 URL,20 条评论 |
| 公开群组讨论 | facebook-groups | --url、--limit | 20 条帖子 |
| 活动/本地动态 | facebook-events | --query 或 --url、--limit | 10 个活动 |
| Marketplace 商品信息 | facebook-marketplace | --url、--limit | 10 条商品信息 |
| 主页身份信息 | facebook-pages | --url | 1-5 个主页 |
| 丰富的主页/个人主页帖子 | facebook-posts | --url、--limit | 20 条帖子 |
| Reels | facebook-reels | --url、--limit | 20 条 Reels |
| 广泛公开搜索 | facebook-search | --category、--location、--limit | 20 条结果 |
仅当平台范围或证据解读仍不明确时,才查阅平台约定;该文档不属于预检流程。
证据质量
- 检查页面/帖子/评论/广告记录是否符合请求的渠道;公开群组帖子并不自动算作评论证据。
- 如果证据不符合要求,请更改公开来源 URL 或使用受支持的查询;广告创意要与自然帖子分开。
- 对于非广告路线,在成功但结果不足后,最多进行两次更改后的后续尝试,且须在获批范围和预算内;不要重复完全相同的请求,也不要隐瞒失败或待处理的操作。
- 对于广告,请遵循广告参考资料中基于证据的停止条件。否则,在证据充足、达到上限或再次尝试无助于改善结果时停止。报告有用的证据和不确定性;保留原始结果和来源链接。
广告库的可见数据不代表支出或 ROAS;保留来源 URL 和观察日期,并区分评论与帖子文本。
完整的机器字段位于 postplus research schema --route <route> --json;
仅在处理需要时查阅,不要在每次请求前都查阅。
postplus research run facebook-ads-library \
--query "example topic" \
--wait \
--output ./result.json
遵循 CLI 的结构化结果和报告的下一步操作;不要根据自由文本消息推断恢复方式。 如果用户已明确批准的范围和最高费用涵盖当前请求,请重复使用该批准;否则,须在确认报价前取得批准。不得仅凭任务推断已获准支出。 通过返回的检查点或操作继续同一操作;切勿重新提交结果不确定的工作、重复已耗尽的恢复流程,或切换提供商以绕过故障。