mcpField
F
facebook-research

facebook-research

github.com/postplusai营销与增长271.1k 次安装1 天前更新
代码仓库

关于 facebook-research

用于收集 Facebook 公开证据的 PostPlus Skill,服务于营销、增长、创作者、社群、竞品和漏斗研究。它按任务调用帖子、评论、广告、活动、Marketplace 列表、主页和公开搜索等采集路线,并区分可见证据与不可获取的私人数据。

主要功能

  1. 01采集公开帖子与个人资料
  2. 02研究 Reels 和评论
  3. 03查看广告资料库创意
  4. 04查找活动和 Marketplace 列表
  5. 05发现主页与公开来源
  6. 06按证据需求选择研究路线

适用场景

  1. 01对标公开的竞品内容
  2. 02分析公开评论和受众疑问
  3. 03比较广告创意与行动号召
  4. 04寻找本地活动或 Marketplace 列表

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/postplusai/postplus-skills --skill facebook-research

安装后在 Claude Code 中输入/facebook-research确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
ads-and-funnel.md
community-voice.md
events-and-local.md
organic-benchmark.md
page-and-group-audit.md
partner-discovery.md
public-content.md
reels-and-video.md
shared-contract.md
shops-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 中针对广告的数量和停止规则。

不要询问用户内部路径标识符、架构、实现选择、重试方式、凭据、隐藏筛选条件或内部路由。

执行规范

  1. 选择一个参考文档和一条路径。
  2. 对于广告,按照 references/ads-and-funnel.md 中的说明收集最新证据;不要自动搜索已存储的广告库。浏览广告库属于单独的用户目标。其他情况下,执行能够回答决策所需的最小规模真实采集。
  3. 如果来源彼此独立且互不依赖,则并行处理。
  4. 如果执行成功,但证据为空、稀疏、嘈杂或偏离主题,则在接受证据或用尽证据前,应用以下质量规则。
  5. 将 JSON 作为事实来源;如果采集了条目级证据,则生成精简的 HTML 证据文档。
  6. 返回简短的聊天答复:范围、数量、最有力的发现、最大缺口、文档路径和下一步行动。

仅使用所选路径显示的公开筛选条件。

公开命令范围

  • 选择最匹配且最精简的研究路径,并直接运行。

  • 就绪状态诊断: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、--limit1-5 个 URL,20 条帖子
直接帖子证据facebook-post-by-url--url1-10 个 URL
公开群组帖子facebook-group-posts--url、--limit1-3 个群组,20 条帖子
广告资料库创意facebook-ads-library--query、--country、--status、--limit参阅广告参考文档:按目标确定采集规模
帖子/短视频评论facebook-comments--url、--limit1-5 个 URL,20 条评论
公开群组讨论facebook-groups--url、--limit20 条帖子
活动/本地动态facebook-events--query 或 --url、--limit10 个活动
Marketplace 商品信息facebook-marketplace--url、--limit10 条商品信息
主页身份信息facebook-pages--url1-5 个主页
丰富的主页/个人主页帖子facebook-posts--url、--limit20 条帖子
Reelsfacebook-reels--url、--limit20 条 Reels
广泛公开搜索facebook-search--category、--location、--limit20 条结果

仅当平台范围或证据解读仍不明确时,才查阅平台约定;该文档不属于预检流程。

证据质量

  1. 检查页面/帖子/评论/广告记录是否符合请求的渠道;公开群组帖子并不自动算作评论证据。
  2. 如果证据不符合要求,请更改公开来源 URL 或使用受支持的查询;广告创意要与自然帖子分开。
  3. 对于非广告路线,在成功但结果不足后,最多进行两次更改后的后续尝试,且须在获批范围和预算内;不要重复完全相同的请求,也不要隐瞒失败或待处理的操作。
  4. 对于广告,请遵循广告参考资料中基于证据的停止条件。否则,在证据充足、达到上限或再次尝试无助于改善结果时停止。报告有用的证据和不确定性;保留原始结果和来源链接。

广告库的可见数据不代表支出或 ROAS;保留来源 URL 和观察日期,并区分评论与帖子文本。 完整的机器字段位于 postplus research schema --route <route> --json; 仅在处理需要时查阅,不要在每次请求前都查阅。

postplus research run facebook-ads-library \
  --query "example topic" \
  --wait \
  --output ./result.json

遵循 CLI 的结构化结果和报告的下一步操作;不要根据自由文本消息推断恢复方式。 如果用户已明确批准的范围和最高费用涵盖当前请求,请重复使用该批准;否则,须在确认报价前取得批准。不得仅凭任务推断已获准支出。 通过返回的检查点或操作继续同一操作;切勿重新提交结果不确定的工作、重复已耗尽的恢复流程,或切换提供商以绕过故障。

评论

支持 Markdown