Back to Details

facebook-research

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Facebook Research

Facebook研究

Follow shared release-shell rules in:
  • postplus-shared
    release-shell rules
Use this skill when the request is about Facebook account or content research.
This skill is for:
  • sampling public follower or following surfaces from a Facebook page or profile
  • collecting public page or profile follow-graph items when Facebook exposes them
  • collecting one or more public Facebook page, group, or direct post URLs
  • discovering a small Facebook post set from a broad query
  • normalizing Facebook post metrics into local artifacts
  • writing local raw payloads, normalized datasets, and short markdown summaries
This skill is not for:
  • LinkedIn collection
  • YouTube collection
  • TikTok, Instagram, or X workflows
  • publishing, deleting, or scheduling posts
  • guaranteeing a complete private follower list when Facebook does not expose it publicly
遵循以下共享发布外壳规则：
  • postplus-shared
    发布外壳规则
当请求涉及Facebook账号或内容研究时，使用此技能。
此技能适用于：
  • 从Facebook主页或个人主页抽样公开的关注者/被关注者界面
  • 当Facebook公开展示时，采集主页或个人主页的关注关系图项
  • 采集一个或多个Facebook公开主页、群组或直接帖子的URL
  • 通过宽泛查询发现少量Facebook帖子集合
  • 将Facebook帖子指标标准化为本地工件
  • 写入本地原始负载、标准化数据集和简短Markdown摘要
此技能不适用于：
  • LinkedIn采集
  • YouTube采集
  • TikTok、Instagram或X平台的工作流程
  • 发布、删除或排期帖子
  • 在Facebook未公开私人关注者列表时，保证获取完整的私人关注者列表

Hosted Capability Boundary

托管功能边界

This skill depends on host-managed collection capability for the corresponding collection paths.
In the product shell:
  • do not probe or print provider secrets
  • do not ask the user to export them inside chat
  • if a collection path returns a stable capability/network hard error, stop immediately instead of trying alternate shell commands
此技能依赖主机管理的采集功能来完成对应的采集路径。
在产品外壳中：
  • 不要探测或打印服务商密钥
  • 不要要求用户在聊天中导出密钥
  • 如果某条采集路径返回稳定的功能/网络硬错误，立即停止，不要尝试替代外壳命令

Default Collection Path

默认采集路径

Use the hosted follower collection path by default:
  • default collection mode: public follower or following items from a page or profile URL
    • use for public follower or following item collection from a page or profile URL
    • tested input shape: 
      • startUrls = [{ "url": "https://www.facebook.com/<page-or-profile>" }]
      • resultsLimit
      • followType = "follower"
        or 
        followType = "following"
    • current observed output fields include: 
      • facebookUrl
      • followType
      • title
      • url
      • subtitle_text
      • image
    • this is the default hosted path for Facebook audience-surface research on the released shell
默认使用托管关注者采集路径：
  • 默认采集模式：从主页或个人主页URL获取公开的关注者/被关注者项
    • 用于从主页或个人主页URL采集公开的关注者/被关注者项
    • 测试输入格式： 
      • startUrls = [{ "url": "https://www.facebook.com/<page-or-profile>" }]
      • resultsLimit
      • followType = "follower"
        或 
        followType = "following"
    • 当前观测到的输出字段包括： 
      • facebookUrl
      • followType
      • title
      • url
      • subtitle_text
      • image
    • 这是已发布外壳上用于Facebook受众界面研究的默认托管路径

Supported Facebook Targets

支持的Facebook目标

  • public page/profile URL -> follower or following items through hosted collection
  • public page/profile URL -> recent posts through hosted content collection
  • public group URL -> recent posts
  • direct public post URL -> one post
  • 公开主页/个人主页URL -> 通过托管采集获取关注者或被关注者项
  • 公开主页/个人主页URL -> 通过托管内容采集获取近期帖子
  • 公开群组URL -> 近期帖子
  • 直接公开帖子URL -> 单条帖子

Failure Posture

失败处理机制

  • fail if the request includes non-Facebook platforms
  • fail if no Facebook public URLs can be discovered
  • fail if hosted content collection returns malformed items without stable URL or id fields
  • fail if hosted follower collection returns no publicly visible follower or following items
  • keep raw responses for debugging
  • 若请求包含非Facebook平台，触发失败
  • 若无法发现任何Facebook公开URL，触发失败
  • 若托管内容采集返回无稳定URL或id字段的畸形项，触发失败
  • 若托管关注者采集未返回任何公开可见的关注者或被关注者项，触发失败
  • 保留原始响应用于调试

Recommended Workflow

推荐工作流程

  1. If the user wants account audience research, start with follower collection using the hosted collection capability.
  2. If the user wants content research, use the hosted content collection scripts below.
  3. If the user wants both, collect follower or following items first, then collect post evidence from the same page or profile.
Do not treat Facebook follower-surface results as a guaranteed full audience export.
  1. 如果用户需要账号受众研究，先使用托管采集功能进行关注者采集。
  2. 如果用户需要内容研究，使用以下托管内容采集脚本。
  3. 如果用户两者都需要，先采集关注者或被关注者项，再从同一主页或个人主页采集帖子证据。
请勿将Facebook关注者界面结果视为保证完整的受众导出数据。

Release-Shell Execution Contract

发布外壳执行约定

  • keep collection briefs, raw datasets, normalized outputs, and summary caches under 
    <work-folder>/.postplus/facebook-research/
  • keep only final user-facing summaries or shortlist exports outside 
    .postplus/
  • compile a small page, post, or discovery brief before the expensive collection step
  • start with a bounded first pass:
    • one page or profile
    • one public post plan
    • one summary pass
  • 将采集简报、原始数据集、标准化输出和摘要缓存保存在 
    <work-folder>/.postplus/facebook-research/
    目录下
  • 仅将最终面向用户的摘要或候选列表导出放在 
    .postplus/
    目录外
  • 在执行高成本采集步骤前，编写简短的主页、帖子或发现简报
  • 从受限的首次执行开始：
    • 一个主页或个人主页
    • 一个公开帖子采集计划
    • 一次摘要生成

Public Post Implementation

公开帖子实现

Read before implementation:
  • skills/20-research/facebook-research/references/normalized-schema.md
Use these entrypoints:
  • skills/20-research/facebook-research/scripts/run_facebook_post_collection.mjs
实现前请阅读：
  • skills/20-research/facebook-research/references/normalized-schema.md
使用以下入口点：
  • skills/20-research/facebook-research/scripts/run_facebook_post_collection.mjs

Hosted Collection Note

托管采集说明

Use the shared hosted collection runner for actor calls:
  • ${CLAUDE_SKILL_DIR}/_postplus_shared/00-core/shared-collection/scripts/collection_actor_run.mjs
使用共享托管采集运行器进行actor调用：
  • ${CLAUDE_SKILL_DIR}/_postplus_shared/00-core/shared-collection/scripts/collection_actor_run.mjs