Linux 또는 Raspberry Pi 환경에서 기기 전체의 Spotify 재생을 제어할 수 있는 강력한 명령줄 인터페이스입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install spotify-cli
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 spotify-cli 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Spotify CLI란 무엇인가요?
Spotify CLI는 터미널을 떠나지 않고 음악을 관리하려는 개발자와 파워 유저를 위해 설계된 전문 도구입니다. 공식 Spotify Web API와 Spotipy Python 라이브러리를 활용하여 휴대폰, 컴퓨터 또는 웹 플레이어에서 실행 중인 모든 활성 Spotify 세션의 재생을 완전히 제어할 수 있습니다. Openclaw Skills 생태계의 일부로서 Raspberry Pi와 같은 헤드리스 시스템을 위한 고성능 인터페이스를 제공합니다.
이 도구는 음악이 사용자 경험의 핵심 구성 요소인 자동화된 환경을 구축하는 데 특히 유용합니다. 간단한 bash 명령을 통해 트랙 검색, 큐 관리 및 재생 상태 모니터링이 가능하므로 사용자 정의 대시보드나 스마트 홈 통합을 구축하는 사람들에게 완벽한 추가 기능입니다.
Spotify CLI 활용 사례
- 터미널 중심 개발 워크플로우에서 작업하는 동안 배경 음악 관리.
- 스피커에 연결된 헤드리스 Raspberry Pi에서 Spotify 재생 제어.
- 셸 스크립트 또는 시스템 트리거를 통한 음악 재생 자동화.
- AI 에이전트에게 특정 곡을 정확하게 검색하고 재생할 수 있는 신뢰할 수 있는 인터페이스 제공.
Spotify CLI 작동 원리
- CLI가 홈 디렉토리에 있는 로컬 설정 파일에서 Spotify 개발자 자격 증명을 로드합니다.
- 처음 실행할 때 OAuth2 인증 흐름을 시작하여 사용자가 애플리케이션을 승인할 수 있는 URL을 제공합니다.
- 인증이 완료되면 스킬은 Spotify API와의 지속적인 연결을 유지하기 위해 리프레시 토큰을 로컬에 저장합니다.
- 터미널을 통해 실행된 명령은 사용자의 활성 Spotify Connect 기기를 대상으로 하는 API 요청으로 변환됩니다.
- 특히 AI 에이전트가 사용할 때 트랙 선택의 정확성을 극대화하기 위해 '검색 후 확인' 로직을 활용합니다.
Spotify CLI 설정 가이드
1. 종속성 설치
pip3 install spotipy --break-system-packages
2. Spotify 개발자 앱 설정
Spotify Developer Dashboard에서 애플리케이션을 등록하고 Redirect URI를 http://127.0.0.1:8888/callback으로 설정합니다.
3. 설정 파일 생성
mkdir -p ~/.config/spotify-cli
cat << EOF > ~/.config/spotify-cli/config
SPOTIPY_CLIENT_ID=your_client_id
SPOTIPY_CLIENT_SECRET=your_client_secret
SPOTIPY_REDIRECT_URI=http://127.0.0.1:8888/callback
EOF
4. 설치 마무리
sudo cp spotify /usr/local/bin/spotify
sudo chmod +x /usr/local/bin/spotify
Spotify CLI 데이터 스키마 및 분류 체계
이 스킬은 빠른 실행과 보안을 보장하기 위해 설정 및 세션 데이터를 로컬에서 관리합니다.
| 파일 경로 | 목적 |
|---|---|
~/.config/spotify-cli/config |
API 인증을 위한 환경 변수를 저장합니다. |
~/.cache-* |
세션 유지를 위한 임시 OAuth 토큰을 저장합니다. |
| API 메타데이터 | 트랙 이름, 아티스트 ID 및 URI를 포함한 검색 결과를 추적합니다. |
Spotify CLI 고급 기능
- 기기 전환: devices 명령을 사용하여 특정 Spotify Connect 기기를 나열하고 타겟팅합니다.
- AI 최적화 워크플로우: 음성 또는 에이전트 명령에서 흔히 발생하는 퍼지 매칭 오류를 처리하기 위한 구조화된 검색-확인-재생 로직.
- 상태 모니터링: 현재 트랙 메타데이터 및 재생 진행 상황을 실시간으로 검색.
- 통합 준비 완료: 복잡한 자동화 작업을 위해 다른 Openclaw Skills에서 쉽게 래핑할 수 있도록 설계되었습니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Tencent Cloud COS & CI 통합
Tencent Cloud Object Storage(COS) 및 AI 기반 Cloud Infinite(CI) 미디어 처리 서비스를 관리하기 위한 강력한 통합 도구입니다.
Voicenotes 연동
Voicenotes.com의 음성 녹음, AI 생성 트랜스크립트 및 요약을 로컬 개발자 작업 공간으로 동기화하는 브리지입니다.
Obsidian CLI 자동화
프로세스 간 통신(IPC)을 통해 Obsidian 볼트와 프로그래밍 방식으로 상호 작용하기 위한 강력한 명령줄 인터페이스입니다.
인플루언서 리포트 스킬
고급 비디오 인텔리전스를 사용하여 인플루언서를 위한 종합적인 브랜드 안전 및 콘텐츠 품질 리포트를 생성하는 자동 심사 도구입니다.
바이럴 비디오 분석
비디오 광고 트랜스크립트와 페이싱을 분석하여 높은 ROI 콘텐츠를 위한 실행 가능한 코칭 피드백을 제공하는 AI 기반 진단 도구입니다.
추천*
