| name | facebook-research |
| description | Research Facebook pages, public follower or following surfaces, and public posts using PostPlus Cloud collection service. Use this when the user wants Facebook account research, follower-surface sampling, or public post metrics. |
| metadata | {"postplus":{"familyId":"platform-research","familyName":"LinkedIn, Facebook, and YouTube"}} |
Facebook Research
Follow shared public skill rules in:
postplus-shared public skill 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
Before Collection Boundary
Before running collection, tell the user that Facebook results are public
samples from exposed surfaces, not a complete follower export. If the user's
goal requires private or exhaustive audience data, stop and ask for a different
source of truth before collecting.
PostPlus Cloud Boundary
This skill depends on host-managed collection capability for the corresponding collection paths.
In the PostPlus runtime:
- 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 public skill surface
Supported Facebook Targets
- 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
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
Recommended Workflow
- If the user wants account audience research, start with follower collection using the PostPlus Cloud collection service.
- If the user wants content research, use the hosted content collection scripts below.
- 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.
Public Skill 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
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
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