SUN-to-Spotify

Product Introduction

1. Definition: SUN-to-Spotify is a specialized AI-powered audio generation and publishing skill for the Claude Code platform. Technically, it is a command-line interface (CLI) wrapper and automation layer that integrates with the sun-cli tool to transform text prompts into professionally produced, multi-speaker dialogue podcasts and audiobooks, then facilitates their direct publication to a user's personal Spotify library.
2. Core Value Proposition: It exists to democratize high-quality, personalized audio content creation for non-technical users and creators. The product eliminates the complex, multi-step process of scriptwriting, voice synthesis, audio engineering, and distribution by providing a single, conversational interface (via Claude) to generate and publish AI-native podcasts on-demand. Its primary value lies in turning any idea, question, or news feed into a streamable audio experience within minutes.

Main Features

1. AI-Powered Podcast Generation: The core feature uses the underlying sun-cli to interface with Sun's AI models. Users provide a natural language prompt (e.g., "startup advice," "history deep dive"). The system then autonomously conducts research, writes a multi-character dialogue script, synthesizes voices for each character, and mixes the final audio with professional-grade production. The output is a segmented MP3 podcast file, complete with metadata.
2. Direct Spotify Library Integration: The skill's end-to-end workflow is designed to culminate in Spotify publishing. After audio generation is complete, the skill can trigger the next step: uploading the generated podcast directly to the user's connected Spotify account. This bypasses traditional podcast hosting platforms and RSS feed management, making the content instantly available for streaming or offline listening across all Spotify devices.
3. Claude Code Skill Automation: This feature is the user-facing automation layer. The skill, when installed in Claude Code's skills directory, teaches the AI assistant how to execute the entire sun-cli workflow. It automates login, job creation with the sun audio create command, continuous status polling with sun audio status, and finally downloading the finished audio manifest and files using sun audio get. This removes the need for users to manually use the terminal or remember CLI syntax.

Problems Solved

1. Pain Point: High barrier to entry for audio content creation. Traditional podcast production requires significant time, technical skill (audio editing software), financial investment (microphones, hosting), and creative effort (scriptwriting, recording, editing).
2. Target Audience: The primary user personas are Curious Learners and Professionals seeking on-demand knowledge in audio format, Content Creators and Developers exploring AI-native media tools, and Busy Executives or Entrepreneurs who want personalized briefings (e.g., daily news, market summaries) consumed during commutes.
3. Use Cases: Essential for generating custom learning content (e.g., summarizing a business book as a podcast), creating personalized daily briefings based on calendar events or news topics, producing niche dialogue content on-demand (e.g., a philosophical debate), and rapidly prototyping audio ideas without production overhead.

Unique Advantages

1. Differentiation: Unlike standalone text-to-speech (TTS) tools or basic AI voice generators, SUN-to-Spotify produces narrative dialogue with multiple AI speakers, creating a more engaging "podcast" experience rather than a monotone reading. Compared to manual podcast publishing, it eliminates the entire post-production and distribution pipeline.
2. Key Innovation: The integration of a conversational AI agent (Claude) as the control plane for a complex audio generation and publishing API. The innovation is the "skill" abstraction that allows users to command a sophisticated audio production studio through natural language, making advanced AI audio generation accessible to anyone who can type a request.

Frequently Asked Questions (FAQ)

1. How does SUN-to-Spotify work with Claude? SUN-to-Spotify is installed as a skill within Claude Code, teaching Claude how to use the sun-cli tool. You simply tell Claude what podcast you want, and it automatically executes the commands to generate the audio and manage the process, acting as an intelligent automation layer between your request and the Sun AI platform.
2. Is the audio from SUN-to-Spotify free to publish on Spotify? Yes, you can publish the AI-generated podcasts to your personal Spotify library. The skill is designed to work with Sun's audio generation service and facilitates the upload process. You must have a Spotify account, and standard Spotify terms of service for user-uploaded content apply.
3. What are the limitations of the AI podcast generation? The generation is constrained by prompt length (1-4000 characters) and duration (5-120 minutes, default 30). The AI researches and writes the script based on your prompt, so highly technical or niche topics may vary in accuracy. The audio segments use AI voices, and the output quality is dependent on Sun's underlying models.
4. Can I use SUN-to-Spotify without Claude Code? Yes, the core functionality is available via the standalone sun-cli command-line tool, which can be installed manually via pip, pipx, or uv. The Claude Code skill primarily provides automation and a natural language interface for the same CLI commands.
5. How do I get an API token for SUN-to-Spotify automation? After installing the CLI and running sun login, you can create a personal API token using the command sun tokens create <name>. This SUN_TOKEN is used for headless/CI environments, allowing scripts or servers to authenticate with the Sun service without an interactive browser login.