leamsigc/shortsgenerator/facebook-research

skill facebook-research-setup       # Step 1: Setup (prerequisites + config + competitors)
skill facebook-research-scrape      # Step 2: Scrape page + competitors analytics
skill facebook-research-analyze     # Step 3: Deep deconstruct top 5 + competitor videos
skill facebook-research-report      # Step 4: REPORT.html with history trends + competitor analysis
skill facebook-research-engage      # Step 5: Generate engagement opportunities (10+ at a time)
skill facebook-research-grow        # Step 5b: Grow followers — goal-driven "audience stealer" campaigns (e.g. +200 in 24h)
skill facebook-research-template    # Step 6: Download reels + transcribe + analyze + generate template

facebook-research ideas:<topic> [window:week|month|year] [limit:10] [ideas:5] [length:standard] [lang:es]

skills/facebook-research/          # Skill (bundled, global-installable via ~/.claude/skills/)
├── SKILL.md
└── scripts/                       # Bundled — no external .fb-research/scripts needed
    ├── package.json               # Node deps (chrome-remote-interface)
    ├── scrape.js                  # Page + competitor scraper via Chrome DevTools
    ├── report-html.js             # HTML report generator
    ├── download-reels.js          # Top-5 reel downloader via Chrome DevTools
    └── transcribe.sh              # Whisper transcription of downloaded reels
 
.fb-research/                      # Tool data directory (project root, auto-resolved via CWD walk-up)
└── projects/<page-name>/
    ├── config.json                       # Project config (page + competitors with URLs)
    ├── page-analytics-history.json       # All historical snapshots (global, appended each run)
    ├── report-history.json               # Historical report snapshots (global)
    ├── replication-history.json          # History of all replication scripts (global)
    ├── latest.json                       # Pointer to latest sessionId
    ├── competitors/                      # Legacy mirror of last run (for back-compat)
    │   ├── <competitor-1>/raw-posts.json
    │   └── <competitor-2>/raw-posts.json
    └── <YYYY-MM-DD_HHMMSS>/             # One folder per run (dated)
        ├── page-analytics.json           # This run's page stats
        ├── raw-posts.json                # This run's raw posts
        ├── competitors/<name>/raw-posts.json
        ├── discovered-competitors.json
        ├── top5-analysis.md
        ├── REPORT.html                   # Self-contained report for this run
        ├── report.md
        ├── replication-scripts/
        ├── screenshots/                  # Hook screenshots
        ├── screenshots-competitors/
        ├── screenshots-engagement/       # Screenshots of target posts + top comments
        ├── screenshots-growth/           # Screenshots of target posts + our visitor comments
        ├── growth-campaign.json
        ├── growth-targets.json
        ├── growth-log.json
        ├── growth-progress.json
        ├── growth-strategy.md
        ├── video-template/
        │   ├── downloads/                # Downloaded reels for this run
        │   ├── transcripts/
        │   ├── transcript-analysis.json
        │   ├── VIDEO-TEMPLATE.md
        │   └── best-performer-breakdown.md
        └── engagement-opportunities.json

## Template: [PATTERN NAME]
**Source**: [original post title] — [views] views
 
### Hook (0:00-0:03)
Text overlay: "[FORMULA]"
Audio: "[EXACT WORDING PATTERN]"
 
### Context (0:03-0:10)
Structure: [pattern of how context is established]
Vocabulary: [power words used]
Pacing: [sentence rhythm]
 
### Drama/Body (0:10-0:40)
Narrative flow: [story structure]
Emotional arc: [how emotions shift]
Key phrases: [repeatable phrases]
 
### CTA (0:40-0:50)
Format: [question formula]
Hook type: [debate / opinion / prediction]
Length: [seconds]
 
### Production Specs
-Duration: [seconds]
-Text overlay style: [font/color/position]
-Audio style: [music type + commentary]
-Transition speed: [fast/medium/slow]
-Caption style: [styled / auto]

Your Topic: [fill in]
Hook:    ¡[STAR] [VERB] [TEAM]! [EMOJI]
Context: [match situation] + [stakes]
Drama:   [key moment 1] → [reaction] → [key moment 2] → [climax]
CTA:     [controversial question] + ¡Te leo en los comentarios!

[SPECIFIC REFERENCE to post] + [OPINIONATED TAKE] + [MEXICAN SLANG / INSIDER JOKE] + [JAB or RHETORICAL QUESTION]

{
  "id": 1,
  "batch": 1,
  "createdAt": "YYYY-MM-DD HH:MM:SS",
  "competitorName": "...",
  "competitorUrl": "https://www.facebook.com/...",
  "postUrl": "https://www.facebook.com/...",
  "postPreview": "...",
  "screenshot": "screenshots-engagement/...png",
  "commentsScreenshot": "screenshots-engagement/...comments.png",
  "topComments": [
    {"commenter": "...", "text": "...", "likes": "5K"}
  ],
  "commentPatterns": {
    "tone": "sarcastic",
    "slangUsed": ["wey", "no mames"],
    "commonThemes": ["bad reffing", "player x is overrated"]
  },
  "generatedComments": [
    {"variant": 1, "type": "hot_take", "text": "...", "whyItGetsLikes": "..."},
    {"variant": 2, "type": "sarcastic_zinger", "text": "...", "whyItGetsLikes": "..."},
    {"variant": 3, "type": "analysis_jab", "text": "...", "whyItGetsLikes": "..."}
  ],
  "value": "high",
  "used": false
}