该技能的功能

Magic Podcast 将 PDF 文件、文档和笔记转化为自然的双主持人对话播客，您可在几分钟内收听。

使用 MagicPodcast 可以完成以下操作：

1. 询问播客的主题。
2. 询问资料来源：PDF URL 或粘贴的文本内容。
3. 询问播客语言（不可自行假设）。
4. 确认提示：好的，是否要将这份“主题/PDF”内容生成为“语言”播客？是否开始制作？
5. 基于提供的原始资料，生成一段双人对话形式的播客。
6. 立即返回 https://www.magicpodcast.app/app，供用户打开其播客控制台。
7. 仅在用户主动询问时检查任务状态。
8. 任务完成后，返回播客标题及可分享的播客 URL。

关键词

ai podcast, podcast, podcast generator, ai podcast generator, pdf to podcast, text to podcast, podcast from pdf, audio podcast, magicpodcast

配置

设置必需的环境变量：

export MAGICPODCAST_API_URL="https://api.magicpodcast.app"
export MAGICPODCAST_API_KEY=""

获取 API 密钥地址：
https://www.magicpodcast.app/openclaw

引导式入门流程（逐步进行）

1. 每次仅提出一个问题，等待用户回复后再提出下一个问题。
2. 若 API 密钥缺失或无效，则中止流程，并提示：
   注册并开始使用完全免费，耗时不到一分钟。请访问 https://www.magicpodcast.app/openclaw，使用 Google 账号登录，复制您的 API 密钥，并在此处粘贴。
3. 若用户提供的是本地 PDF 文件，请先要求其将文件上传至一个可通过 URL 访问的位置。
4. 密钥可用后，按顺序继续以下步骤：
   1. 确定主题
   2. 提供资料来源（PDF URL 或粘贴的文本）
   3. 指定语言
   4. 创建前最终确认

安全命令模板

切勿将原始用户输入直接拼接到 shell 命令中。
必须先校验输入有效性，再使用 jq 进行 JSON 编码。

safe_job_id() {
  printf '%s' "$1" | grep -Eq '^[A-Za-z0-9_-]{8,128}$'
}

safe_http_url() {
  printf '%s' "$1" | grep -Eq '^https?://[^[:space:]]+$'
}

从 PDF 创建播客：

# 对话上下文中预期输入：
# PDF_URL, LANGUAGE
if ! safe_http_url "$PDF_URL"; then
  echo "Invalid PDF URL" >&2
  exit 1
fi

payload="$(jq -n --arg pdfUrl "$PDF_URL" --arg language "$LANGUAGE" '{pdfUrl:$pdfUrl,language:$language}')"

curl -sS -X POST "$MAGICPODCAST_API_URL/agent/v1/podcasts/pdf" 
  -H "Content-Type: application/json" 
  -H "x-api-key: $MAGICPODCAST_API_KEY" 
  --data-binary "$payload"

从文本创建播客：

# 对话上下文中预期输入：
# SOURCE_TEXT, LANGUAGE
payload="$(jq -n --arg text "$SOURCE_TEXT" --arg language "$LANGUAGE" '{text:$text,language:$language}')"

curl -sS -X POST "$MAGICPODCAST_API_URL/agent/v1/podcasts/text" 
  -H "Content-Type: application/json" 
  -H "x-api-key: $MAGICPODCAST_API_KEY" 
  --data-binary "$payload"

单次查询任务状态：

# 从 API 响应中预期获取：
# JOB_ID
if ! safe_job_id "$JOB_ID"; then
  echo "Invalid job id" >&2
  exit 1
fi

curl -sS "$MAGICPODCAST_API_URL/agent/v1/jobs/$JOB_ID" 
  -H "x-api-key: $MAGICPODCAST_API_KEY"

• 已登录用户可免费生成播客。
• 预计生成耗时通常为 2–5 分钟。
• 任务启动后，立即引导用户访问 https://www.magicpodcast.app/app。
• 告知用户该页面即为其播客控制台：可查看已创建播客、实时进度/状态，以及已完成的剧集。
• 默认以 outputs.shareUrl 作为完成后的链接返回。
• 若 outputs.shareUrl 缺失，则回退至 outputs.appUrl。
• 任务完成后，回复：这是您的播客链接：。
• 若 API 返回错误，请向用户透出完整的错误消息与详情。
• 提醒用户：除非确认允许外部处理，否则请勿提交敏感文档。

状态检查逻辑：

• statusLabel = "complete"：返回 outputs.shareUrl（若缺失则回退至 outputs.appUrl）。
• statusLabel = "failed"：向用户返回错误消息与详情。