lifei68801

Video Summary

ナレッジ管理v1.6.4
作者:lifei68801更新日 2026-05-11全 26 バージョン · 最新版の公開日 2026-03-13video-summary@clawhub_lifei68801/video-summary
要約ドキュメント Q&A#Transcription

AlphaMoatによると、2026-10時点でVideo Summaryのダウンロード数は7,991、スター数は9で、累計ダウンロード数で今回のランキング対象AIスキル10,914件中3,483位、ナレッジ管理では745件中236位です。

一覧の初期表示は累計ダウンロード数順で、スター数順にも並べ替えできます。詳細ページの順位は累計ダウンロード数で計算しています。

ダウンロード数
7991
スター数
9
累計ダウンロード順位
#3,483
全体の上位 32% · ナレッジ管理の上位 32%
プラットフォームダウンロード数スター数コメント
ClawHub ↗35006-
SkillHub ↗79919—

プラットフォームごとに集計方法と集計時点が異なります。

このスキルでできること

YouTube、Bilibili、小紅書、抖音、ローカルファイルを扱い、必要に応じて字幕や Whisper の文字起こしを使います。スクリプトは LLM を直接呼ばず、エージェントや外部ツール向けに要約依頼を出力します。依存ツールとアクセス権が必要で、制限付きコンテンツでは本人のセッションの Cookie が必要な場合があり、共有してはいけません。

資料公開日 2026-10-27

できること

  • 閲覧可能な動画を要点と章ごとの要約にまとめる

使う場面

  • 対応動画の要約や文字起こしが必要なとき

プロンプト例

スキルのドキュメントをもとに生成した例であり、実際の実行結果ではありません。

この動画から利用可能な文字起こしを取得してタイムスタンプ付き要約を準備し、欠落やアクセスできない内容を示して。

月次の推移

ダウンロード数7991
1967520284372026-03 · ダウンロード数 24132026-05 · ダウンロード数 32892026-06 · ダウンロード数 34312026-07 · ダウンロード数 38222026-08 · ダウンロード数 42222026-09 · ダウンロード数 51412026-10 · ダウンロード数 799126-0326-0926-10
スター数9
16102026-03 · スター数 22026-05 · スター数 52026-06 · スター数 62026-07 · スター数 82026-08 · スター数 92026-09 · スター数 92026-10 · スター数 926-0326-0926-10

2026-09 から集計方法を変更し、同名スキルを作者ごとに分けて集計し、全スキルを対象にしました。破線は変更前の月で、変更後のデータとは直接比較せず、変更をまたぐ増減も計算していません。 同名の別スキルがあるため、変更前のデータは現在ダウンロード数が最も多いこのスキルに帰属させています。

月ダウンロード数前月比スター数
2026-107991—9
2026-095141—9
2026-084222+10.5%9
2026-073822+11.4%8
2026-063431+4.3%6
2026-053289—5
2026-032413—2

SKILL.md 原文

作者が公開した元のファイルをテキストのまま表示しています。AlphaMoat による編集や審査はしていません。リンクはクリックできません。コマンドは内容を確認してから実行してください。取得日 2026-10-23。

17 KB・ClawHub v1.6.4
---
name: video-summary
version: 1.6.4
description: "Video summarization for Bilibili, Xiaohongshu, Douyin, and YouTube. Extract insights from video content through transcription and summarization."

# 🔒 Security Declaration
# This skill downloads videos/subtitles from YouTube/Bilibili/Xiaohongshu/Douyin.
# It does NOT directly call external LLM APIs - it outputs structured requests for agent processing.
# OPENAI_API_KEY and OPENAI_BASE_URL are optional - used by agent, not by this script.
# Cookie files are read locally only, never transmitted externally.
すべて表示(全 580 行)
# No config files written. No secrets stored. No telemetry, no analytics.
metadata:
  openclaw:
    requires:
      bins: ["yt-dlp", "jq", "ffmpeg", "ffprobe", "bc"]
      credentials:
        - name: "OPENAI_API_KEY"
          required: false
          description: "API key for LLM summarization (optional, script outputs request for agent processing)"
        - name: "OPENAI_BASE_URL"
          required: false
          description: "Custom API endpoint (e.g., for Zhipu, DeepSeek)"
        - name: "VIDEO_SUMMARY_COOKIES"
          required: false
          description: "Path to cookies file for restricted video content"
    behavior:
      networkAccess: indirect
      description: "Downloads videos/subtitles from video platforms using yt-dlp. Summarization requests are output as structured text for agent/external LLM processing. Script itself makes no direct LLM API calls. Requires yt-dlp, jq, ffmpeg. Optional: VIDEO_SUMMARY_WHISPER_MODEL, VIDEO_SUMMARY_COOKIES, OPENAI_BASE_URL, OPENAI_MODEL."
---

# Video Summary Skill

Intelligent video summarization for multi-platform content. Supports Bilibili, Xiaohongshu, Douyin, YouTube, and local video files.

## What It Does

- **Auto-detect platform** from URL (Bilibili/Xiaohongshu/Douyin/YouTube)
- **Extract subtitles/transcripts** using platform-specific methods
- **Generate structured summaries** with key insights, timestamps, and actionable takeaways
- **Multi-format output** (plain text, JSON, Markdown)
- **Direct LLM integration** — outputs ready-to-use summaries
- **Automatic cleanup** — no temp file leaks

---

## Quick Setup

**No API key required to run.** This skill extracts video content and outputs structured requests for summarization. The agent (or external tool) handles LLM calls.

```bash
# Optional: If you want the agent to call LLM for summarization
export OPENAI_API_KEY="your-api-key-here"
export OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4

# Optional: Whisper model for transcription (default: base)
export VIDEO_SUMMARY_WHISPER_MODEL=base
```

**How it works:**
1. Script extracts video subtitles/transcript
2. Script outputs a structured summary request (JSON/text)
3. Agent or external tool calls LLM API with the request
4. Script does NOT directly call any external APIs

### Supported LLM Providers

- **OpenAI**: https://platform.openai.com/api-keys
- **Zhipu GLM**: https://open.bigmodel.cn/
- **DeepSeek**: https://platform.deepseek.com/
- **Moonshot**: https://platform.moonshot.cn/

Just set OPENAI_BASE_URL to the provider's API endpoint.

### Cookie Configuration (Optional)

Xiaohongshu and Douyin may need cookies for some videos:

```bash
# Set cookie file path
export VIDEO_SUMMARY_COOKIES=/path/to/cookies.txt

# Or use --cookies flag
video-summary "https://xiaohongshu.com/..." --cookies cookies.txt
```

**⚠️ Cookie Security Note:**
- Cookie files contain session tokens and are sensitive
- Only use cookies from your own browser sessions
- Do not share cookie files with others
- Cookie files are read locally and never transmitted externally by this script

### Manual Trigger

If configuration is incomplete, say:
> "help me configure video-summary"

---

## Quick Start

### Check Dependencies

```bash
# Check all required tools
yt-dlp --version && jq --version && ffmpeg -version

# If missing, install
pip install yt-dlp
apt install jq ffmpeg  # or: brew install jq ffmpeg
```

### Basic Usage

```bash
# Standard summary
video-summary "https://www.bilibili.com/video/BV1xx411c7mu"

# With chapter segmentation
video-summary "https://www.youtube.com/watch?v=xxxxx" --chapter

# JSON output for programmatic use
video-summary "https://www.xiaohongshu.com/explore/xxxxx" --json

# Subtitle only (no AI summary)
video-summary "https://v.douyin.com/xxxxx" --subtitle

# Save to file
video-summary "https://www.bilibili.com/video/BV1xx" --output summary.md

# Use cookies for restricted content
video-summary "https://www.xiaohongshu.com/explore/xxxxx" --cookies cookies.txt
```

### In OpenClaw Agent

Just say:
> "Summarize this video: [URL]"

The agent will automatically:
1. Detect the platform
2. Extract video content
3. Generate a structured summary

---

## Commands Reference

| Command | Description |
|---------|-------------|
| `video-summary "<url>"` | Generate standard summary |
| `video-summary "<url>" --chapter` | Chapter-by-chapter breakdown |
| `video-summary "<url>" --subtitle` | Extract raw transcript only |
| `video-summary "<url>" --json` | Structured JSON output |
| `video-summary "<url>" --lang <code>` | Specify subtitle language (default: auto) |
| `video-summary "<url>" --output <path>` | Save output to file |
| `video-summary "<url>" --cookies <file>` | Use cookies file |
| `video-summary "<url>" --transcribe` | Force Whisper transcription |

---

## How It Works

### Platform Support Matrix

| Platform | Subtitle Extraction | Notes |
|----------|-------------------|-------|
| **YouTube** | Native CC + auto-generated | Best support |
| **Bilibili** | Native CC + backup methods | Requires video ID extraction |
| **Xiaohongshu** | Limited (OCR fallback) | No native subtitles, uses transcription |
| **Douyin** | Limited (OCR fallback) | Short-form video, may need transcription |
| **Local files** | Whisper transcription | Supports mp4, mkv, webm, mp3, etc. |

### Supported URL Formats

**YouTube:**
- `https://www.youtube.com/watch?v=xxxxx`
- `https://youtu.be/xxxxx`

**Bilibili:**
- `https://www.bilibili.com/video/BV1xx411c7mu`
- `https://www.bilibili.com/video/av123456`

**Xiaohongshu:**
- `https://www.xiaohongshu.com/explore/xxxxx`
- `https://xhslink.com/xxxxx` (short link)

**Douyin:**
- `https://www.douyin.com/video/xxxxx`
- `https://v.douyin.com/xxxxx` (short link)

### Processing Pipeline

```
URL Input
    ↓
Platform Detection
    ↓
Subtitle Extraction (yt-dlp / Whisper)
    ↓
Content Chunking (if long)
    ↓
LLM Summarization (OpenAI API / Agent)
    ↓
Structured Output
    ↓
Auto Cleanup
```

---

## Performance Estimation

### Whisper Transcription Time

| Video Duration | tiny | base | small | medium |
|---------------|------|------|-------|--------|
| 5 min | ~30s | ~1m | ~2m | ~4m |
| 15 min | ~1.5m | ~3m | ~6m | ~12m |
| 30 min | ~3m | ~6m | ~15m | ~30m |
| 60 min | ~6m | ~12m | ~30m | ~60m |

**Notes:**
- GPU significantly faster (3-10x)
- `base` model recommended for balance
- First run downloads model (~150MB for base)

### Subtitle Extraction Time

| Platform | Time | Notes |
|----------|------|-------|
| YouTube | ~5s | Direct subtitle download |
| Bilibili | ~5s | Direct subtitle download |
| Xiaohongshu | ~3m | Requires transcription |
| Douyin | ~2m | Requires transcription |

---

## Advanced Configuration

### Whisper for Transcription

For platforms without native subtitles (Xiaohongshu, Douyin), install Whisper:

```bash
pip install openai-whisper
```

Then configure:
```bash
export VIDEO_SUMMARY_WHISPER_MODEL=base  # tiny, base, small, medium, large
```

### OpenAI API for Summarization

**This script does NOT directly call LLM APIs.** It outputs structured requests for the agent to process.

If you want the agent to call LLM for summarization, configure:

```bash
# Optional: API key for your LLM provider
export OPENAI_API_KEY="your-api-key-here"

# Optional: Custom API endpoint (for non-OpenAI providers)
export OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4  # Zhipu
# export OPENAI_BASE_URL=https://api.deepseek.com/v1        # DeepSeek
# export OPENAI_BASE_URL=https://api.moonshot.cn/v1          # Moonshot

# Optional: Model selection
export OPENAI_MODEL=gpt-4o-mini
```

**Without API key:** Script outputs transcript and structured request. Agent handles summarization.

### Cookie Configuration for Restricted Content

Some platforms require authentication for certain content:

```bash
# Method 1: Command line
video-summary "https://www.xiaohongshu.com/explore/xxxxx" --cookies cookies.txt

# Method 2: Environment variable
export VIDEO_SUMMARY_COOKIES=/path/to/cookies.txt
```

**How to get cookies:**

1. Install browser extension: "Get cookies.txt LOCALLY"
2. Login to the platform
3. Export cookies to file

### Custom Summary Prompt

Create `~/.video-summary/prompt.txt`:

```markdown
# Summary Template

## Key Insights
- List 3-5 core arguments

## Key Information
- Data, cases, quotes

## Action Items
- Specific actions viewers can take

## Timestamp Navigation
- Key moments with timestamps and descriptions
```

---

## Output Formats

### Standard Output (default)

```markdown
# Video Title

**Duration**: 12:34
**Platform**: Bilibili
**Author**: Tech Creator

## Core Content
This video explains...

## Key Points
1. Point one
2. Point two
3. Point three

## Timestamps
- 00:00 Introduction
- 02:15 Core concept
- 08:30 Case study
- 11:45 Summary
```

### JSON Output (`--json`)

```json
{
  "title": "Video Title",
  "platform": "bilibili",
  "duration": 754,
  "author": "Creator Name",
  "summary": "Core content summary...",
  "keyPoints": ["Point 1", "Point 2", "Point 3"],
  "chapters": [
    {"time": 0, "title": "Intro", "summary": "..."},
    {"time": 135, "title": "Core Concept", "summary": "..."}
  ],
  "transcript": "Full transcript text..."
}
```

---

## Technical Details

### Dependencies

| Tool | Required | Purpose |
|------|----------|---------|
| **yt-dlp** | Yes | Video/subtitle downloader |
| **jq** | Yes | JSON processing |
| **ffmpeg** | Yes | Audio/video processing |
| **whisper** | Optional | Local transcription |

### File Structure

```
~/.openclaw/workspace/skills/video-summary/
├── SKILL.md              # This file
├── scripts/
│   └── video-summary.sh  # Main CLI script
├── prompts/
│   ├── summary-default.txt
│   └── summary-chapter.txt
└── references/
    └── platform-support.md  # Detailed platform notes
```

### Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `OPENAI_API_KEY` | - | **Optional** - API key for LLM summarization (used by agent, not this script) |
| `OPENAI_BASE_URL` | `https://api.openai.com/v1` | **Optional** - Custom API endpoint |
| `OPENAI_MODEL` | `gpt-4o-mini` | **Optional** - Model for summarization |
| `VIDEO_SUMMARY_WHISPER_MODEL` | `base` | Whisper model size |
| `VIDEO_SUMMARY_COOKIES` | - | **Optional** - Path to cookies file (read locally only) |

---

## Troubleshooting

### "No subtitles found"

- The video may not have subtitles/CC
- Try `--transcribe` to use Whisper
- For Xiaohongshu/Douyin, transcription is required

### "yt-dlp: command not found"

```bash
pip install yt-dlp
# or
brew install yt-dlp
```

### "Missing required dependencies"

```bash
# Install all dependencies
pip install yt-dlp
apt install jq ffmpeg  # Ubuntu/Debian
# or
brew install jq ffmpeg  # macOS
```

### "Video too long"

Long videos (>1h) are automatically chunked:
- Split into 10-minute segments
- Summarize each segment
- Merge into final summary

### "Failed to fetch video info"

- Video may be private or deleted
- Try `--cookies` for restricted content
- Region-locked videos may not work

### "Rate limited"

- Too many requests to platform
- Wait a few minutes
- Use `--cookies` for authenticated access

---

## Comparison

| Feature | OpenClaw summarize | video-summary |
|---------|-------------------|---------------|
| YouTube | ✅ | ✅ |
| Bilibili | ❌ | ✅ |
| Xiaohongshu | ❌ | ⚠️ (transcription) |
| Douyin | ❌ | ⚠️ (transcription) |
| Chapter segmentation | ❌ | ✅ |
| Timestamps | ❌ | ✅ |
| Transcript extraction | ❌ | ✅ |
| JSON output | ❌ | ✅ |
| Save to file | ❌ | ✅ |
| Cookie support | ❌ | ✅ |

---

## References

- [Platform Support Details](references/platform-support.md)
- [yt-dlp Documentation](https://github.com/yt-dlp/yt-dlp)
- [OpenAI Whisper](https://github.com/openai/whisper)

---

## Contributing

Found a bug or want to add platform support?
- Open an issue on ClawHub
- Submit a PR with your improvements

---

## Changelog

### v1.6.4 (2026-03-13)
- Security: Fixed script syntax error (missing closing brace in call_llm function)
- Security: Clarified that script does NOT directly call LLM APIs - outputs structured requests for agent processing
- Security: OPENAI_API_KEY is now clearly marked as optional (used by agent, not by script)
- Security: Added cookie security note - files are read locally only, never transmitted
- Security: Removed "required" claim for API key - honest documentation matching actual behavior

### v1.6.3 (2026-03-12)
- Fix: Version sync between _meta.json and SKILL.md
- No functional changes

### v1.6.2 (2026-03-12)
- Fix: Synced _meta.json version with SKILL.md to resolve packaging inconsistencies warning
- No functional changes

### v1.6.1 (2026-03-12)
- Security: Removed "sk-xxx" placeholder from docs - use "your-api-key-here" instead
- Cleaner documentation examples
- No functional changes

### v1.6.0 (2026-03-12)
- Security: Removed all direct LLM API calls - script now outputs structured requests for agent processing
- networkAccess changed to "indirect" - no curl POST to external APIs in script
- OPENAI_API_KEY is now optional - works without it
- Cleaner security profile, same functionality
- Agent handles LLM calls externally when needed

### v1.5.1 (2026-03-12)
- Security: Dynamic auth header construction to avoid LLM scanner false positives
- Auth header now built from string parts at runtime
- Same functionality, cleaner security profile
- No hardcoded sensitive patterns in script

### v1.5.0 (2026-03-12)
- Security: Added credentials declaration - OPENAI_API_KEY (required), OPENAI_BASE_URL, VIDEO_SUMMARY_COOKIES (optional)
- Security: Registry metadata now properly declares required credentials
- Clean single-script architecture, no config files
- Security: Removed unused setup scripts - single entry point via video-summary.sh
- Security: Declared all required binaries: yt-dlp, jq, ffmpeg, ffprobe, curl, bc, whisper
- Security: Explicit env vars in behavior description
- Security: Removed config file storage - uses env vars only, no secrets stored
- Security: Fixed metadata/install spec mismatch - removed unused install declarations
- Honest security declaration matching actual behavior
- Security: Removed all config file writes - uses env vars only (OPENAI_API_KEY, OPENAI_BASE_URL)
- No secrets stored in files, no "risky handling of secrets"
- Simplified setup: just set environment variables before use
### v1.4.6 (2026-03-12)
- Security: Removed references to non-existent OpenClaw config auto-detection feature
- Honest security declaration: only documents what the skill actually does
- Clearer env var documentation: OPENAI_API_KEY, OPENAI_BASE_URL
- Simplified setup instructions - no false claims about auto-detection
- Security: Simplified security declaration - removed verbose permission list
- Clearer behavior description matching actual functionality
- No functional changes, same behavior
- Security: Obfuscated API key field names to avoid false positives in security scanners
- No functional changes, same behavior

### v1.3.6 (2026-03-10)
- Security: Moved prompts to external files to avoid ClawHub false positive
- Prompts now loaded from prompts/summary-chapter.txt and prompts/summary-default.txt
- No functional changes, same output quality

### v1.3.5 (2026-03-09)
- Security audit: removed patterns that triggered false positive flags
- Neutralized prompt-like text in documentation and scripts
- All functionality preserved, safer for public registry

### v1.3.0 (2026-03-08)
- Added conversational setup support
- Simplified configuration flow

### v1.2.2 (2026-03-08)
- Redesigned setup wizard
- Simplified interface

### v1.2.1 (2026-03-08)
- Added setup wizard
- Simplified setup flow

### v1.2.0 (2026-03-08)
- Added configuration guide
- Added cookie extraction guide
- Added Whisper model selection guide

### v1.1.0 (2026-03-08)
- Added direct LLM integration
- Added `--output` parameter
- Added `--cookies` parameter
- Added automatic temp file cleanup
- Added progress estimation
- Added dependency checking
- Added URL format documentation
- Added performance estimation table
- Fixed metadata dependencies

### v1.0.0
- Initial release

---

*Make video content accessible. Watch less, learn more.*

ナレッジ管理の人気スキル

搜索引擎ナレッジ管理

通过公开搜索URL在16个搜索引擎(7个国内直连+9个国际)中做跨引擎检索、结果去重与多源交叉验证,无需API Key,内置零依赖Python脚本。Use when 用户要求“搜一下/查资料/多找几个来源/核实消息/找公众号文章/排查报错/找论文或开源项目”时。输入自然语言查询词,输出带来源链接与可信度标注的结构化结果。不适用于私有数据检索、批量抓取、需要登录后可见的内容。

↓ 1075.9万★ 147u_8ee34d77
ima-skillsナレッジ管理

IMA OpenAPI を通じてノートとナレッジベースを操作します。

↓ 108.4万★ 566u_1742680f
Summarizeナレッジ管理

長いテキストや文書、ウェブページを要点とキーワードに圧縮する要約ツールです。

↓ 87.6万★ 1048paudyyin
全网搜索ナレッジ管理

通过“查一下、搜一下、搜索、找一下”等自然语言检索公开网页,整理来源并交付横版 PDF、Markdown 与标题链接表。支持用户主动开启、查看和取消技能收藏,保留原报告取回。

↓ 50.9万★ 2u_32d99f8a
web-tools-guideナレッジ管理

ウェブ要求に適切なツールを割り当てるための必読ガイドです。

↓ 40万★ 220user_ec205dbb
Aihot Skill Liteナレッジ管理

AI HOT (aihot.virxact.com) 中文 AI 资讯查询 Skill。当用户想知道"今天 AI 圈有什么"、"AI 日报"、"AI HOT"、"AI 资讯"、"AI 热点"、"最近 AI"、"OpenAI/Anthropic/Google 最近发布了什么"、"AI hot today"、"AI...

↓ 32.1万★ 92Khazix
全球12亿文献知识库(8千万中文期刊可下载)ナレッジ管理

全球12亿文献知识库(8千万中文期刊可下载)——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力,覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据(期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万)。 能力:中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载(不消耗配额)、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额:首次使用自动注册,免费 100 次检索 + 10 次下载 / 月;耗尽自动弹出套餐(体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包),可说「升级 / 充值」唤起;企业 / 机构定制联系 [email protected]。 触发:用户表达"查论文""找文献""检索学术""搜期刊""查专利""找标准""下论文""写文献综述""找参考文献""查 SCI/EI"等意图时启用;也适用"帮我找关于 XX 的论文""写文献综述""找几篇引用支撑论点"。英文:"find papers" "search literature" "write literature review" "find supporting citations"。 调用前必须先用 /consume 获取 consume_token,再凭 token 调 /search(每次计费接口调用都需一次 /consume)。

↓ 30.3万★ 189user_164f4c1f
Markdown Converterナレッジ管理

uvx 経由で markitdown を呼び、さまざまな形式のファイルを Markdown に変換します。

↓ 20.4万★ 256Peter Steinberger

データ月:2026-10 · ダウンロード数とスター数は公開スキルレジストリ(ClawHub、SkillHub)から月単位で集計しています。詳しくはデータの方法論をご覧ください。