MCPcopy
hub / github.com/whotto/Video_note_generator

github.com/whotto/Video_note_generator @main sqlite

repository ↗ · DeepWiki ↗
260 symbols 805 edges 28 files 206 documented · 79%
README

视频笔记生成器 (Video Note Generator)

🎉 V2.0 重大更新已发布! 新版本采用 FastAPI Web 界面,功能更强大,体验更友好!

📂 V2.0 版本目录video_note_generator_v2/ 📖 V2.0 使用文档查看 V2.0 README


🆕 V2.0 主要新特性

  • 🌐 现代化 Web 界面 - FastAPI + Glassmorphism UI 设计
  • 🍪 自动 Cookie 管理 - 无需手动配置,启动即用
  • 📝 博客文章生成 - 除小红书笔记外,新增深度博客文章
  • 🔄 智能错误处理 - B站限流自动重试,友好的错误提示
  • ⏱️ 支持长视频 - 30分钟超时,适合处理长视频内容
  • 📊 批量处理 - 同时处理多个视频,提高效率
  • 📁 文件管理 - 预览、复制、下载一键完成
  • 📜 历史记录 - 自动保存处理历史

强烈建议使用 V2.0 版本!


📦 版本对比

特性 V1.0 (当前目录) V2.0 (video_note_generator_v2/)
界面 命令行 Web 可视化界面
Cookie 管理 手动配置 自动导出
输出格式 小红书笔记 小红书笔记 + 博客文章
批量处理 支持 支持 + 进度显示
文件管理 手动查找 预览/复制/下载
错误处理 基础 智能重试 + 友好提示
长视频支持 有限 30分钟超时

V1.0 文档(旧版本)

⚠️ 以下是 V1.0 的文档,建议使用 V2.0 版本

🎥 一键将视频转换为优质小红书笔记,自动优化内容和配图

Version Python

👤 作者信息

🎯 应用场景

  • 内容创作者:快速将视频/直播内容转换为文章
  • 知识管理者:自动整理视频笔记和学习要点
  • 社交媒体运营:批量生成优质小红书笔记

✨ 小红书笔记特点

  • 标题创作
  • 使用二极管标题法,抓住用户痛点
  • 融入高转化词和情感词
  • 添加2-4个相关表情
  • 控制在20字以内

  • 内容优化

  • 正文控制在600-800字
  • 每段使用emoji引导
  • 设置2-3处互动引导
  • 加入个人经验和共情描述
  • 自动获取相关配图

  • 标签系统

  • 核心关键词
  • 关联长尾词
  • 高转化标签
  • 热门话题标签

🔄 创作流程

graph TD
    A[视频URL] --> B[下载视频]
    B --> C[提取音频]
    C --> D[Whisper转录]
    D --> E[AI长文整理]
    E --> F[小红书风格优化]
    F --> G[生成标题]
    F --> H[生成标签]
    F --> I[获取配图]
    G & H & I --> J[生成最终笔记]

🚀 使用方式

支持三种使用方式:

  1. 处理单个视频
python video_note_generator.py https://example.com/video
  1. 批量处理 URL 文件
# urls.txt 文件,每行一个视频链接
python video_note_generator.py urls.txt
  1. 处理 Markdown 文件
# 支持 Markdown 链接和直接 URL
python video_note_generator.py notes.md

🛠️ 使用工具

📦 快速开始

1. 安装依赖

# 安装 FFmpeg
# Mac: brew install ffmpeg
# Windows: 从 ffmpeg.org 下载并添加到环境变量
# Linux: apt install ffmpeg

# 安装 Python 依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env

2. 配置 API 密钥

编辑 .env 文件,填入必要的 API 密钥:

# OpenRouter API(必需)
OPENROUTER_API_KEY=your-api-key-here

# Unsplash API(必需)
UNSPLASH_ACCESS_KEY=your-unsplash-access-key-here
UNSPLASH_SECRET_KEY=your-unsplash-secret-key-here

3. 开始使用

  1. 创建 urls.txt 文件,每行一个视频链接
  2. 运行环境检查:
python check_environment.py
  1. 运行生成器:
python video_note_generator.py test.md

📄 输出文件

每个视频会生成三个文件:

  1. 原始笔记 (YYYYMMDD_HHMMSS.md):
  2. 完整的视频转录文本
  3. 保留所有细节内容

  4. 整理版笔记 (YYYYMMDD_HHMMSS_organized.md):

  5. AI优化后的结构化内容
  6. 重点内容突出
  7. 段落优化

  8. 小红书版本 (YYYYMMDD_HHMMSS_xiaohongshu.md):

  9. 优化的爆款标题
  10. 600-800字精华内容
  11. 2-3张相关配图
  12. 优化的标签系统
  13. 互动引导设计

⚙️ 配置说明

.env 文件中可以调整以下参数:

# 内容生成配置
MAX_TOKENS=2000          # 生成小红书内容的最大长度
CONTENT_CHUNK_SIZE=2000  # 长文本分块大小(字符数)
TEMPERATURE=0.7          # AI 创造性程度 (0.0-1.0)

# 代理设置(可选)
# HTTP_PROXY=http://127.0.0.1:7890
# HTTPS_PROXY=http://127.0.0.1:7890

📄 许可证

MIT License

🙏 鸣谢

感谢以下开源项目: - Whisper - FFmpeg

Core symbols most depended-on inside this repo

get
called by 83
video_note_generator_v2/src/video_note_generator/transcriber.py
showToast
called by 19
video_note_generator_v2/static/js/app.js
generate_completion
called by 6
video_note_generator_v2/src/video_note_generator/ai_processor.py
get_settings
called by 5
video_note_generator_v2/web_app.py
addToHistory
called by 4
video_note_generator_v2/static/js/app.js
updateHistoryDisplay
called by 4
video_note_generator_v2/static/js/app.js
add_strategy
called by 4
video_note_generator_v2/src/video_note_generator/downloader/multi_strategy_downloader.py
process_video
called by 3
video_note_generator.py

Shape

Method 154
Function 62
Class 35
Route 9

Languages

Python91%
TypeScript9%

Modules by API surface

video_note_generator_v2/src/video_note_generator/downloader/multi_strategy_downloader.py29 symbols
video_note_generator_v2/static/js/app.js24 symbols
video_note_generator_v2/web_app.py23 symbols
video_note_generator.py21 symbols
video_note_generator_v2/src/video_note_generator/downloader/res_downloader.py18 symbols
video_note_generator_v2/src/video_note_generator/generators/xiaohongshu.py14 symbols
video_note_generator_v2/src/video_note_generator/downloader/base.py14 symbols
video_note_generator_v2/src/video_note_generator/transcriber.py13 symbols
video_note_generator_v2/src/video_note_generator/downloader/http_file_downloader.py11 symbols
video_note_generator_v2/src/video_note_generator/utils/logger.py9 symbols
video_note_generator_v2/src/video_note_generator/processor.py9 symbols
video_note_generator_v2/src/video_note_generator/downloader/bilibili_downloader.py9 symbols

Dependencies from manifests, versioned

GitPython3.1.45 · 1×
Jinja23.1.6 · 1×
MarkupSafe3.0.3 · 1×
Pillow10.1.0 · 1×
PyYAML6.0.3 · 1×
Pygments2.19.2 · 1×
altair5.5.0 · 1×
annotated-doc0.0.3 · 1×
annotated-types0.7.0 · 1×
anyio4.11.0 · 1×
attrs25.4.0 · 1×
beautifulsoup44.12.2 · 1×

For agents

$ claude mcp add Video_note_generator \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact