yt-repurpose

yt-repurpose

Extract YouTube transcripts and repurpose them into social media posts.

Available as a CLI tool, a Node.js library, and an MCP server for AI assistants.

Quick Start

# Install globally
npm install -g yt-repurpose

# Set your Google API key (YouTube Data API v3)
yt-repurpose config set google-api-key YOUR_KEY

# Extract a transcript
yt-repurpose https://www.youtube.com/watch?v=VIDEO_ID

# Repurpose into social posts (requires Anthropic or OpenAI key)
yt-repurpose config set anthropic-key YOUR_KEY
yt-repurpose https://www.youtube.com/watch?v=VIDEO_ID --repurpose

# Choose platforms and provider
yt-repurpose https://www.youtube.com/watch?v=VIDEO_ID --repurpose --platforms twitter,tiktok,linkedin --provider openai

Getting a Google API Key

1. Go to Google Cloud Console
2. Create a project (or select an existing one)
3. Enable the YouTube Data API v3
4. Create an API key under Credentials
5. Set it: yt-repurpose config set google-api-key YOUR_KEY

CLI Usage

# Transcript only (default)
yt-repurpose <youtube-url>

# Repurpose with LLM
yt-repurpose <youtube-url> --repurpose

# Options
--repurpose              Generate social media posts from transcript
--platforms <list>       Comma-separated: twitter,tiktok,linkedin,instagram,blog (default: twitter,linkedin)
--provider <name>        LLM provider: anthropic or openai (default: anthropic)
--model <model>          Override default model
--google-api-key <key>   Google API key (overrides config)
--anthropic-key <key>    Anthropic API key (overrides config)
--openai-key <key>       OpenAI API key (overrides config)

# Config management
yt-repurpose config set <key> <value>
yt-repurpose config get <key>
# Keys: google-api-key, anthropic-key, openai-key

MCP Server

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "yt-repurpose": {
      "command": "npx",
      "args": ["-y", "yt-repurpose-mcp"],
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key"
      }
    }
  }
}

MCP Tools

• get_youtube_transcript - Extract transcript from a YouTube URL. Returns the title and full text for the LLM to naturally repurpose.
• repurpose_transcript - Extract and repurpose in one step using an LLM (requires Anthropic or OpenAI key in env).

Library Usage

import { getTranscript, repurpose } from 'yt-repurpose-core';

// Extract transcript
const result = await getTranscript({
  url: 'https://www.youtube.com/watch?v=VIDEO_ID',
  googleApiKey: 'YOUR_KEY',
});
console.log(result.title, result.fullText);

// Repurpose with LLM
const posts = await repurpose({
  transcript: result.fullText,
  title: result.title,
  platforms: ['twitter', 'linkedin'],
  provider: 'anthropic',
  apiKey: 'YOUR_ANTHROPIC_KEY',
});

Packages

| Package | npm | Description | |---------|-----|-------------| | yt-repurpose | CLI | Command-line tool | | yt-repurpose-mcp | MCP Server | For AI assistants (Claude Desktop, etc.) | | yt-repurpose-core | Library | Core transcript + repurpose logic |

License

MIT