该技能的功能

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"：将错误消息与详情返回给用户。