AI播客剪辑工具

Prerequisites

Setup options

./setup.sh              # full install + launch UI
./setup.sh --install    # install only
./setup.sh --ui         # launch UI only (skip install)
./setup.sh --mcp        # print MCP config for Claude

---

Quick Start

git clone https://github.com/nmbrthirteen/podcli.git
cd podcli
chmod +x setup.sh podcli
./setup.sh

This will:

1. Check system dependencies (Node, Python, FFmpeg)
2. Create a Python virtual environment and install packages
3. Install Node packages and build TypeScript
4. Set up PodStack slash commands and knowledge base templates
5. Create the local .podcli/ data directory
6. Launch the web UI at http://localhost:3847

Usage

Full options

./podcli process episode.mp4 \ --transcript transcript.txt \ --top 8 \ --caption-style branded \ --crop center \ --logo logo.png ```

Configuration

Copy .env.example to .env (setup.sh does this automatically):

Config profiles (multi-show / multi-machine)

Portable bundles zip your config home (not cache or rendered clips):

podcli config export ~/backups/myshow.zip
podcli config import ~/backups/myshow.zip --home ~/.podcli-myshow --activate
podcli config status

Activate a config root without importing: podcli config use ~/.podcli-myshow (writes .podcli-home in the project).

3. Generate the full content package

Open the project in Claude Code and run:

/prep-episode

This runs the PodStack pipeline — a gstack-style workflow that gives you:

• 8-15 scored moments with timestamps, categories, and reasoning
• 8 title options per clip following your show's title spec (verified against 6 quality gates)
• Ready-to-paste descriptions with hooks, guest attribution, hashtags, SEO keywords
• Thumbnail briefs for both podcast (16:9) and shorts (9:16) formats
• Brand review that catches banned words, voice violations, and weak hooks
• Publish checklist covering pre-upload, at-publish, first-24-hours, and day 3-4 optimization

Content Workflow (PodStack)

• /process-transcript — extract and score best moments from any transcript
• /generate-titles — 8 titles per clip with 6-point verification checklist
• /generate-descriptions — descriptions + hashtags + SEO keywords
• /plan-thumbnails — thumbnail text + designer briefs for both formats
• /review-content — paranoid brand check (banned words, voice, title rules)
• /prep-episode — full pipeline: transcript → publish-ready package
• /publish-checklist — pre/post-publish optimization
• /retro-episode — performance analysis after publishing

Content Workflow (PodStack)

Open the project in Claude Code, then use slash commands:

```bash

Full pipeline — transcript to publish-ready package

/prep-episode

MCP Server (Claude Integration)

podcli is a Model Context Protocol server — Claude can use it as a tool to create clips through conversation.

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "podcli": {
      "command": "node",
      "args": ["/path/to/podcli/dist/index.js"],
      "env": {
        "PYTHON_PATH": "/path/to/podcli/venv/bin/python3"
      }
    }
  }
}

Claude Code:

claude mcp add podcli -- node /path/to/podcli/dist/index.js

Run ./setup.sh --mcp to get the exact config with your paths filled in.