名称： pocket-casts
描述： 下载 YouTube 视频并上传至 Pocket Casts Files，以供离线观看。仅供个人使用您拥有或有权使用的内容。
版本： 1.0.0
作者： emmanuelem

Pocket Casts YouTube 上传工具

下载 YouTube 视频并上传至 Pocket Casts Files，实现离线观看。

使用方法

~/skills/pocket-casts/scripts/upload.sh "YOUTUBE_URL"

或指定自定义标题：

~/skills/pocket-casts/scripts/upload.sh "YOUTUBE_URL" "自定义标题"

环境要求

必需组件

• yt-dlp - YouTube 下载器（通过 uv 安装：uvx yt-dlp）
• ffmpeg - 视频处理工具（安装：apt install ffmpeg）
• curl - HTTP 请求工具（通常已预装）
• jq - JSON 解析工具（安装：apt install jq）

推荐组件

• deno - JavaScript 运行时，用于应对 yt-dlp 可能遇到的挑战：
  bash curl -fsSL https://deno.land/install.sh | sh
  添加到 PATH：export PATH="$HOME/.deno/bin:$PATH"

设置步骤

1. 创建凭证目录：
   bash mkdir -p ~/.clawdbot/credentials/pocket-casts chmod 700 ~/.clawdbot/credentials/pocket-casts

2. 添加 Pocket Casts 刷新令牌：

登录 pocketcasts.com 后，通过浏览器开发者工具获取刷新令牌，然后执行：
bash cat > ~/.clawdbot/credentials/pocket-casts/config.json << 'EOF' { "refreshToken": "YOUR_REFRESH_TOKEN_HERE" } EOF chmod 600 ~/.clawdbot/credentials/pocket-casts/config.json

刷新令牌有效期约 1 年。访问令牌会自动获取。

3. 添加 YouTube Cookies（大多数视频必需）：

YouTube 的机器人检测机制需要来自已登录浏览器会话的 Cookies。

• 安装浏览器扩展 "Get cookies.txt LOCALLY"（或类似工具）
• 登录状态下访问 youtube.com
• 通过扩展导出 Cookies
• 保存至 ~/.clawdbot/credentials/pocket-casts/cookies.txt

bash chmod 600 ~/.clawdbot/credentials/pocket-casts/cookies.txt

工作原理

1. 通过 yt-dlp --remux-video mp4 下载视频
2. 使用存储的刷新令牌更新 Pocket Casts 访问令牌
3. 向 Pocket Casts API 请求预签名上传 URL
4. 通过预签名 URL 将文件 PUT 到 S3
5. 删除本地视频文件

环境变量

• CLAWDBOT_CREDENTIALS - 覆盖凭证目录（默认：~/.clawdbot/credentials）

注意事项

• 文件将出现在 Pocket Casts 的 "Files" 标签页中
• 视频可在应用（iOS/Android/Web）中原生播放
• 最大文件大小取决于您的 Pocket Casts 订阅（Plus 用户约 2GB）
• 如果 YouTube 屏蔽请求，可能需要更新 Cookies

⚠️ 法律免责声明

本工具仅限个人合理使用。

• YouTube 服务条款禁止通过非官方方式下载视频。根据您所在的司法管辖区和用途，下载行为可能违反 YouTube 条款。
• Pocket Casts 条款要求您拥有或有权使用上传至 Files 库的任何媒体内容。
• 版权法因国家/地区而异。未经许可下载和存储受版权保护的内容在您所在地区可能属违法行为。

使用本工具即表示您承担全部责任，确保您的使用行为符合所有适用的服务条款和法律。作者对任何滥用行为概不负责。

推荐用途： 个人录音、知识共享内容、您自己创作的视频或创作者明确允许下载的内容。