← Back to Skills Marketplace
jlacroix82

Clip

by jlacroix82 · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
50
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clip-media
Description
Extract media (videos, photos, GIFs, audio) from social media URLs using yt-dlp. Supports 1,872+ platforms including YouTube, TikTok, Instagram, X/Twitter, F...
README (SKILL.md)

Clip

Drop a URL → get the media back. Fast.

How It Works

  1. User shares a URL from any supported platform
  2. Run the extraction script
  3. Script downloads the media (or just analyzes it)
  4. Returns the file path (under 50 MB) or a cloud link (over 50 MB)
  5. Agent sends the media to the user

Command

node /home/jarvis/.openclaw/workspace/skills/clip/extract.js \x3Curl> [options]

Options

Flag Description
--output-dir \x3Cdir> Save location (default: /tmp/media-share)
--title Return title/description only, no download
--info Return full metadata as JSON
--test Validate URL without downloading
--upload Force cloud upload even for small files
--cloud=\x3Cprovider> Cloud provider: tmpfiles or transfer
--no-direct-send Always return path, never auto-send
--list-sites Show supported platforms
--list-types Show what media a URL contains

Examples

# Download media (fastest path)
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Get title only (no download, instant)
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js "https://www.instagram.com/p/abc123/" --title

# Check what's in a URL before downloading
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js "https://www.tiktok.com/@user/video/123" --list-types

# Show supported sites
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js --list-sites

Supported Platforms

yt-dlp: 1,872 extractors — covers essentially every major media platform on the internet.

Quick reference (most common):

YouTube, TikTok, Instagram, X/Twitter, Facebook, Reddit, Twitch, Vimeo, Dailymotion, Rumble, Peertube, Bilibili, Niconico, SoundCloud, Bandcamp, Pinterest, Imgur, Tumblr, Flickr, Bluesky, Telegram, Kick, Odysee, CNN, BBC, Al Jazeera, TED, Khan Academy, Udemy, Crunchyroll, HiDive, and 1,800+ more.

File Size Handling

  • Under 50 MB → Returns local file path (agent sends via chat)
  • Over 50 MB → Auto-uploads to temp cloud storage, returns download link
  • Over 50 MB + --upload → Forces cloud upload even for smaller files

Cloud Providers

Provider Max Size Notes
tmpfiles 50 MB Simple, no signup, auto-delete
transfer Unlimited transfer.sh, 30-day retention

Authentication

Some platforms require cookies for full access:

Platform Needs cookies?
Instagram Sometimes (private content, full resolution)
X / Twitter Sometimes (rate limits, some content)
Patreon Yes (paid content)
OnlyFans Yes
Fanvue / Fansly Yes
Netflix / HBO / Disney+ Via browser cookies
YouTube Rarely (age-restricted content)

Add --cookies-from-browser chrome to the command when needed.

How It Works (Under the Hood)

  1. Analyze: yt-dlp --dump-json detects the platform and media type
  2. Download: yt-dlp -o \x3Cpath> grabs the highest quality version
  3. Route: Under 50 MB → return path. Over 50 MB → upload to cloud → return link
  4. Fallback: If download fails, returns title/description so the agent can inform the user

Dependencies

  • yt-dlp (installed) — 1,872 extractors
  • ffmpeg (installed) — format conversion
  • curl (installed) — cloud uploads

Error Handling

When a URL returns no media, the script returns the title/description. The agent should:

  • Inform the user what was found
  • Suggest trying --cookies-from-browser chrome if the platform may require auth
  • Note that geo-blocked content cannot be bypassed

Notes

  • Rate limits may apply on some platforms — add delays between calls
  • Some platforms (Instagram, X) work better with cookies
  • If a URL returns no media, return the title/description to the user instead
  • The generic extractor handles many embedded video players not explicitly listed
Usage Guidance
Install only if you are comfortable with media URLs being downloaded locally and large outputs being uploaded to temporary third-party file hosts. Avoid using it for private, paid, copyrighted, or authenticated content unless you explicitly intend that access and understand the browser-cookie and upload implications.
Capability Tags
requires-sensitive-credentials
Capability Assessment
ℹ Purpose & Capability
The core capability is coherent with the stated purpose: a Node wrapper uses yt-dlp to inspect and download media from user-provided URLs, then returns a local file path or link.
⚠ Instruction Scope
The invocation scope is broad across many platforms, including private or paid/authenticated services, and the instructions suggest browser-cookie use without foregrounding the privacy impact or requiring explicit user approval.
ℹ Install Mechanism
The artifact is a markdown skill plus an executable JavaScript script with no declared package dependencies; it assumes yt-dlp, ffmpeg, and curl are already installed and uses a hard-coded example install path.
⚠ Credentials
Downloading URL-sourced media is expected, but automatic cloud upload for files over 50 MB sends user-provided content to tmpfiles.org or transfer.sh without a per-upload consent gate. The script also builds shell commands with user-controlled URL/path values, making the static exec finding more concerning than a simple wrapper would be.
⚠ Persistence & Privilege
There is no background persistence or privilege escalation, but the documented browser-cookie workflow would use local authenticated browser sessions, and downloaded media remains in /tmp/media-share unless separately cleaned up.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clip-media
  3. After installation, invoke the skill by name or use /clip-media
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release
Metadata
Slug clip-media
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Clip?

Extract media (videos, photos, GIFs, audio) from social media URLs using yt-dlp. Supports 1,872+ platforms including YouTube, TikTok, Instagram, X/Twitter, F... It is an AI Agent Skill for Claude Code / OpenClaw, with 50 downloads so far.

How do I install Clip?

Run "/install clip-media" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Clip free?

Yes, Clip is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Clip support?

Clip is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Clip?

It is built and maintained by jlacroix82 (@jlacroix82); the current version is v0.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments