pdf2audio-minimax
Convert PDF files to MP3 audio using MiniMax MCP Server's text-to-audio tool. Use when user wants to convert a PDF to audio/MP3, create audiobook from PDF, or text-to-speech for PDF documents. Requires PDF file path; voice ID is optional (auto-selects based on content).
When & Why to Use This Skill
This Claude skill enables the seamless conversion of PDF documents into high-quality MP3 audio files using the MiniMax text-to-audio engine. It features intelligent text extraction that filters out headers and page numbers, automatic voice selection tailored to the content's genre (such as children's stories, romance, or news), and automated file organization. It is a powerful tool for transforming static text into accessible, portable audio content.
Use Cases
- Audiobook Creation: Automatically convert PDF novels or stories into organized MP3 chapters with genre-appropriate voice acting.
- Productivity & Multitasking: Transform long reports, academic papers, or business documents into audio for listening during commutes or exercise.
- Accessibility Support: Assist visually impaired users or those with reading difficulties by providing a high-quality text-to-speech alternative for PDF documents.
- Content Repurposing: Help educators and content creators quickly turn written scripts or educational PDFs into audio materials for students or audiences.
| name | pdf2audio-minimax |
|---|---|
| description | "Convert PDF files to MP3 audio using MiniMax MCP Server's text-to-audio tool. Use when user wants to convert a PDF to audio/MP3, create audiobook from PDF, or text-to-speech for PDF documents. Requires PDF file path; voice ID is optional (auto-selects based on content)." |
PDF to Audio Converter (MiniMax)
Convert PDF documents to MP3 audio files using MiniMax text-to-audio.
Input Format
/pdf2audio-minimax <pdf_file_path> [voice_id]
Examples:
/pdf2audio-minimax /path/to/story.pdf(auto-select voice)/pdf2audio-minimax /path/to/story.pdf Chinese (Mandarin)_Gentleman
Workflow
1. Parse Arguments
Extract from user input:
pdf_path: Full path to the PDF file (required)voice_id: Voice identifier (optional)
2. Read PDF Content
Read: file_path = <pdf_path>
3. Extract Text & Metadata
Extract readable text, skipping page numbers and headers. Keep chapter titles, body text, dialogue.
Extract metadata for file naming:
- Story Name: Extract from the PDF's parent directory name (e.g.,
/path/我的世界/chapters/file.pdf→我的世界) - Chapter Number: Extract from filename pattern
*-XX.pdfor content like第X章(e.g.,我的世界-03.pdf→03) - Chapter Title: Extract from the first chapter heading in content (e.g.,
第3章：迷宫里的真心话→迷宫里的真心话)
4. Select Voice
If voice_id provided: Use the specified voice.
If voice_id not provided: Auto-select based on content keywords:
| Content Keywords | Voice ID |
|---|---|
| 童话、儿童、小朋友、冒险 | Chinese (Mandarin)_Cute_Spirit |
| 言情、爱情、浪漫、甜蜜 | Chinese (Mandarin)_Sweet_Lady |
| 科幻、悬疑、历史、战争 | Chinese (Mandarin)_Gentleman |
| 新闻、报告、公告 | Chinese (Mandarin)_News_Anchor |
| Default | Chinese (Mandarin)_Gentleman |
For complete voice list, see references/voices.md.
5. Convert to Audio
mcp__MiniMax__text_to_audio:
text: <extracted_text>
voice_id: <selected_voice_id>
output_directory: <audiobook subdirectory in story folder>
language_boost: "Chinese"
speed: 1
6. Rename Output File
After MiniMax generates the MP3, rename it to follow the naming convention:
<STORY_NAME>_<CHAPTER_NUMBER>_<CHAPTER_TITLE>.mp3
Examples:
我的世界_03_迷宫里的真心话.mp3文明的最后一个变量_01_第一次接触.mp3
Rename command:
mv "<generated_file>.mp3" "<output_directory>/<STORY_NAME>_<CHAPTER_NUMBER>_<CHAPTER_TITLE>.mp3"
7. Output
Report the final MP3 path with the properly formatted filename.
Quick Reference: Common Voices
| Use Case | Voice ID |
|---|---|
| Audiobook (male) | Chinese (Mandarin)_Gentleman |
| Audiobook (female) | Chinese (Mandarin)_Soft_Girl |
| Children's story | Chinese (Mandarin)_Cute_Spirit |
| News/Formal | Chinese (Mandarin)_News_Anchor |
Full voice reference: references/voices.md