Skip to content

puntorigen/avatar-skills / facebook-videos

facebook-videos

Verified

Download public Facebook videos (a watch link, video permalink, reel, fb.watch short link, or a Page's videos tab) to a local folder, named by upload datetime (YYYY-MM-DD_HH-MM-SS.mp4). Single-engine yt-dlp + ffmpeg; uses --cookies-from-browser for login-walled public videos. Use when the user asks to download a Facebook video or reel, save an FB video locally, grab a video from a facebook.com/watch or fb.watch link, or batch-download a Page's videos.

FileKindSize
SKILL.mdskill md6.4 KB
examples.mdmarkdown2.8 KB
scripts/download_facebook_videos.pyscript13.0 KB

examples.md

View on GitHub
# Examples

## A single watch link (the common case)

```bash
python3 .cursor/skills/facebook-videos/scripts/download_facebook_videos.py \
  --url "https://www.facebook.com/watch/?v=10154325234224113" \
  --output-dir out/facebook \
  --timezone America/Santiago
```

## Real run (verified)

```
Listing videos for: https://www.facebook.com/watch/?v=10154325234224113
Found 1 video(s). max_height=1080. Downloading to /tmp/fb_smoke
  - 10154325234224113: ok (2907228 bytes)

Done. 1 downloaded, 0 skipped, 0 failed -> /tmp/fb_smoke
Manifest: /tmp/fb_smoke/videos_manifest.json
  2016-05-25_12-42-58.mp4
```

Resulting files (named by exact upload datetime — the long caption stays in the manifest, not the filename):

```
2016-05-25_12-42-58.mp4
download-archive.txt
videos_manifest.json
```

Manifest entry shape:

```json
{
  "id": "10154325234224113",
  "url": "https://www.facebook.com/watch/?v=10154325234224113",
  "title": "26 reactions · 10 comments | La periodista Mariela Aravena estuvo en la audiencia de formalización de uno de los alumnos que ingresó a La Moneda...",
  "timestamp": 1464194578,
  "uploadDate": "2016-05-25T12:42:58-04:00",
  "height": 1080,
  "local": "2016-05-25_12-42-58",
  "file": "2016-05-25_12-42-58.mp4"
}
```

Re-running the same command skips the already-downloaded video via `download-archive.txt`:

```
  - 10154325234224113: skipped (archive)
Done. 0 downloaded, 1 skipped, 0 failed
```

## A reel or a video permalink

Same command — just swap the URL:

```bash
python3 .cursor/skills/facebook-videos/scripts/download_facebook_videos.py \
  --url "https://www.facebook.com/reel/1234567890" \
  --output-dir out/facebook
```

```bash
python3 .cursor/skills/facebook-videos/scripts/download_facebook_videos.py \
  --url "https://www.facebook.com/somepage/videos/1234567890/" \
  --output-dir out/facebook
```

Short links work too: `https://fb.watch/xxxxxxxx/`.

## Just the first video of a Page

A Page's `/videos` tab lists many videos. Cap to the first with `--max 1`:

```bash
python3 .cursor/skills/facebook-videos/scripts/download_facebook_videos.py \
  --url "https://www.facebook.com/somepage/videos" \
  --output-dir out/facebook \
  --max 1
```

## Login-walled public video (use your own browser cookies)

If the run prints `No videos found` or yt-dlp errors with "log in" / "cookies":

```bash
python3 .cursor/skills/facebook-videos/scripts/download_facebook_videos.py \
  --url "https://www.facebook.com/watch/?v=ID" \
  --output-dir out/facebook \
  --cookies-from-browser chrome
```

## Two-step (review listing before downloading)

```bash
yt-dlp --flat-playlist -J "https://www.facebook.com/somepage/videos" > listing.json
# inspect listing.json, trim entries if desired, then:
python3 .cursor/skills/facebook-videos/scripts/download_facebook_videos.py \
  --listing-json listing.json \
  --output-dir out/facebook
```
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall