Longwave

Longwave — 面向 AI Agent 的视频流水线

为任意 AI Agent 提供创作者的完整视频流水线。 将一集长视频转为 Shorts、缩略图、节目说明和播客订阅源，然后发布到创作者自己的 YouTube 频道。

支持 Grok Bot、Grok Build、Cursor、Claude Code 和 Meta Muse。只需建立一个 MCP 连接，使用 OAuth 2.1，全程无需 API 密钥。

Agent 负责协调。Longwave 负责渲染和发布。 Agent 无需下载视频，也不持有 Google 凭据，更不会操作 YouTube Studio。

可生成的内容

将一集长视频、一档播客或一条 YouTube 视频交给 Longwave，即可获得一整套分发内容：

• 带字幕的竖屏 Shorts 和片段 — 根据文字稿剪辑、构图并添加字幕。
• 结合上下文的 AI 缩略图 — 根据剧集自身的文字稿生成吸引点、副标题和场景，而不是从某一帧截取。
• 基于文字稿的元数据 — 针对每个发布目的地撰写标题、说明、章节、节目说明和各平台发布文案。
• 一条 X 帖文和一段 X 视频混剪 — 链接帖文和原生视频片段是独立的输出，两者都可基于同一集内容生成。
• 播客 RSS 订阅源，并发布到 13 个目录 — 包括 Apple Podcasts、Spotify、Amazon Music、iHeartRadio、Pocket Casts、Castbox 等。
• 面向创作者频道的公开简介链接页。

YouTube 和 X 会自动发布。 其他所有片段都会渲染为带字幕的竖屏文件，可直接上传到 Reels、TikTok 和 LinkedIn。Longwave 不受这些平台的条款约束，也不会联系这些平台；由创作者自己的 Agent 在创作者的会话中完成这一步。

---

为什么要做这个

Agent 已经可以剪辑视频并操作浏览器，但有两件事它无法自行做到：

1. 经过验证的 YouTube 上传授权。 Google 已批准 Longwave 使用 youtube.force-ssl — 正式环境模式，没有用户数量上限，也不会显示“未验证应用”页面。创作者只需连接一次，Longwave 就会向 Agent 委派受限访问权限。自行搭建集成意味着必须先通过 OAuth 应用审核和 Google 验证，才能上传第一个视频。

2. 一条流水线，而非单条命令。 剪辑一个 Short 是最简单的部分。Longwave 还会处理字幕、标题和说明、缩略图、播放列表分配、每日上传上限、跨平台发布日程、播客 RSS 订阅源，以及上传中途失败时的重试。

因此，这不是一个封装 yt-dlp 和 YouTube Studio 书签脚本的工具，而是一个以 15 个工具形式开放的发布管理系统。

---

安装

grok plugin install Longwave-Media/longwave-plugin

也可以将其添加为可自托管的目录源：

grok plugin marketplace add Longwave-Media/longwave-plugin

两种方式都无需审核。Cursor 和 Claude Code 会读取相同的文件；Muse 则会根据 URL 构建自己的 MCP 客户端。

连接

无需配置，本仓库中也不存储任何凭据。 对 MCP 端点发起未经身份验证的调用会返回：

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://www.longwave.media/.well-known/oauth-protected-resource"

符合规范的客户端会按此流程自行注册、打开浏览器，然后由创作者登录并批准授权。必须使用 PKCE S256。这是有意为之：Agent Plugins v1.0.0 §7.2.1 禁止在 headers 中嵌入密钥，而规范预期通过 OAuth 发现机制来实现授权。

• MCP 端点 — https://www.longwave.media/api/mcp（Streamable HTTP，无状态）
• 受保护资源元数据 — https://www.longwave.media/.well-known/oauth-protected-resource
• 授权服务器 — https://www.longwave.media/.well-known/oauth-authorization-server

工具

15 种工具——足以端到端运行创作者的剪辑工作流，而且有意不再增加。可用范围采用默认拒绝的允许列表，而非 API 的镜像，因此只有在此处存在经过所有权检查的后端路由时，才会提供相应工具。

创建和查看——首次连接时授予

工具	功能
account_status	频道已连接吗？还剩多少积分？请先调用此工具。
create_shorts_job	将长篇节目剪辑成 Shorts。免费——发布时才会消耗积分。
get_job	查看任务进度、剪辑数量和错误。
list_clips	查看生成的内容，以及各平台的状态和在线 URL。
create_supercut	从源视频或现有剪辑中拼接一段较长的视频。

读取——首次连接时授予

工具	功能
list_episodes	创作者的长篇内容目录，按时间从新到旧排列，并显示状态。
get_episode	查看单集的完整信息：标题、备注、章节、转录文本和播客状态。
get_insights	频道级摘要：单集数量、反复出现的主题和钩子类型。
get_content_intelligence	Longwave 对下一步制作内容的文字分析。
get_channel_overview	已连接的平台及各平台的表现情况。
list_playlists	播放列表，以及哪个列表是上传目标位置。
list_thumbnail_styles	缩略图样式目录。

更改公开内容——每次都需要单独批准

工具	功能
publish_shorts	将 Shorts 发布到 YouTube，可安排发布时间。
reschedule_post	将排队中的帖子改到其他时段，或取消排期。
approve_thumbnail	在单集中发布 AI 生成的缩略图。

首次连接时不会授予发布和更改缩略图的权限——创作者必须单独批准这项额外授权，因为这两种操作都会更改公开内容。服务器会通过 403 + WWW-Authenticate: ... error="insufficient_scope" 请求额外权限。

无论是否已授权，tools/list 都会返回完整目录，因此客户端可以查看有哪些工具并申请使用；授权会在调用时强制执行。tools/list 是权威来源，并包含每个工具的完整 JSON Schema——上表是为阅读此代码库的人提供的。

每个会修改数据的工具都接受一个 idempotency_key。使用相同的键重试超时调用，就会获得原始结果，而不会创建第二个任务或发布第二条公开帖子。

费用

创作者注册后即可免费开始：赠送 200 积分，无需信用卡，积分永不过期。

积分按实际发布的每条 Short向创作者收取——渲染失败不收费，未发布的剪辑也不收费。

操作	积分
发布一条 Short	1
通过自动发布功能发布一条 Short	1.5
通过共享应用配额发布到 X	4
上传一集完整的长篇节目	5，另加每 GB 1 积分

**Agent 从不处理付款。**它不持有信用卡，也无法访问结账页面。余额不足时，工具会返回一个 top_up_url；Agent 只需将其交给创作者，然后停止操作。

发布平台

• 通过 Longwave 使用官方 API 发布——YouTube（单集及其 Shorts）、X（一条帖子和一段超级剪辑）、公开的 Link-in-Bio 页面，以及通过播客 RSS 分发到 13 个目录。
• 作为可下载文件——每条 Short 都是 CDN 上的竖屏文件，并附有字幕和元数据，因此 Agent 可以通过创作者本人已登录的会话将其发布到任何平台。

Longwave 不受任何第三方平台条款约束，也从不联系这些平台。我们介绍的是可用能力；实际操作由创作者的 Agent 执行。

软件包布局

两个生态系统对插件包的描述方式不同，而找不到 MCP 配置的客户端会安装一个包含零个工具的插件。因此，这里同时提供两种布局：

路径	约定
plugin.json	Agent Plugins v1.0.0 — 封闭式架构，位置固定
mcp.json	Agent Plugins v1.0.0 — 传输方式为 streamable-http
.grok-plugin/plugin.json	Grok / xAI 市场 — 已对照 xAI 自行引入的 external_plugins/neon 和第三方 getsentry/plugin-grok 验证
.mcp.json	Grok MCP 配置 — 传输方式为 http
skills/longwave/SKILL.md	两者共用 — 模型读取的说明
.grok-plugin/marketplace.json	可自托管目录（跟踪仓库 HEAD）
assets/logo.svg	列表标志 — Groundswell 标记，遵循品牌规范，使用单色 currentColor
assets/icon.svg	1:1 市场标识 — Groundswell 位于墨色底板上，1024 全出血。这才是列表磁贴需要的图标，因为没有底板的单色标记在浅色或繁杂背景上会消失

维护方

Longwave 是 Signal Group Limited（新西兰 · NZBN 9429035771678 · 公司编号 1396666）的产品。 仪表板仓库中的 scripts/verify-plugin-package.ts 会在每次发布前验证此软件包 — 共 58 项检查，涵盖两种清单约定、作者信息一致性、两个配置中的单一 MCP 端点，以及技能的 allowed-tools、此 README 与实时工具清单之间的差异。

提交到 xAI 官方目录

条目位于 xai-org/plugin-marketplace，其中的源代码必须固定到完整的 40 位小写提交 SHA — scripts/validate-catalog.py 会强制执行此要求，而 Grok 克隆后会重新验证 git rev-parse HEAD == sha，因此强制推送无法悄无声息地发布新代码。xAI 还要求源代码位于组织仓库中；我们的组织仓库是 Longwave-Media。

git ls-remote https://github.com/Longwave-Media/longwave-plugin.git HEAD

然后添加条目、重新生成组件索引、验证并提交 PR：

python3 scripts/generate-plugin-index.py
python3 scripts/validate-catalog.py

每次发布都要重新固定 sha — 切勿创建并行条目。

提交到 Cursor Marketplace（这是 Grok Bot 的插件目录）

Grok Bot 从 Cursor Marketplace 安装插件 — Settings → Plugins — 此市场与上文提到的 Grok Build 目录是不同的平台。提交方式是填写表单，而不是提交拉取请求：在 https://cursor.com/marketplace/publish 粘贴此仓库的 URL。Cursor 团队会手动审核每个新列表及其每次更新，因此无需维护 SHA 固定值 — 列表会跟踪默认分支。

此软件包已经采用 Cursor 接受的格式：根目录下有符合 Agent Plugins 规范的 plugin.json，并与 mcp.json、skills/ 和 README.md 并列。市场搜索会匹配 keywords 和 description，因此清单中包含创作者会输入的通用词 — youtube、shorts、reels、video、clips、podcast — 而不只是产品术语。

隐私与数据

此软件包不收集任何信息，也不存储任何内容。创作者操作的所有内容均由托管的 Longwave 服务根据其自身条款处理：https://www.longwave.media/terms 和 https://www.longwave.media/privacy。YouTube 凭据绝不会离开 Longwave 的服务器，Agent 只会收到不透明且范围受限的 Longwave 令牌。

支持

[email protected] · https://www.longwave.media · 组织资料

许可证

此软件包采用 MIT 许可证。这不涵盖托管的 Longwave 服务。