← 返回 Skills 市场
jlacroix82

Clip

作者 jlacroix82 · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
50
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install clip-media
功能描述
Extract media (videos, photos, GIFs, audio) from social media URLs using yt-dlp. Supports 1,872+ platforms including YouTube, TikTok, Instagram, X/Twitter, F...
使用说明 (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
安全使用建议
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.
能力标签
requires-sensitive-credentials
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install clip-media
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /clip-media 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.0
Initial release
元数据
Slug clip-media
版本 0.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 50 次。

如何安装 Clip?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install clip-media」即可一键安装,无需额外配置。

Clip 是免费的吗?

是的,Clip 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Clip 支持哪些平台?

Clip 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Clip?

由 jlacroix82(@jlacroix82)开发并维护,当前版本 v0.1.0。

💬 留言讨论