@crafter/spoti-cli 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -0
- package/package.json +3 -2
package/README.md
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# spoti-cli
|
|
2
|
+
|
|
3
|
+
Spotify Web API from your terminal. Search, recommend, create playlists. Built for AI agents.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
bun add -g spoti-cli
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Setup
|
|
12
|
+
|
|
13
|
+
1. Create a Spotify app at [developer.spotify.com/dashboard](https://developer.spotify.com/dashboard/create)
|
|
14
|
+
2. Set redirect URI to `http://localhost:8888/callback`
|
|
15
|
+
3. Authenticate:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
spoti-cli auth --client-id YOUR_CLIENT_ID
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Usage
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
# Search tracks, artists, albums
|
|
25
|
+
spoti-cli search "Daft Punk" --type artist --json
|
|
26
|
+
spoti-cli search "Around the World" --type track --limit 5
|
|
27
|
+
|
|
28
|
+
# Get recommendations from seeds
|
|
29
|
+
spoti-cli recommend --seed-genres electronic,house --energy 0.8 --limit 20 --json
|
|
30
|
+
|
|
31
|
+
# Create a playlist
|
|
32
|
+
spoti-cli create "Late Night Electronics" --tracks URI1,URI2,URI3 --public
|
|
33
|
+
|
|
34
|
+
# Manage playlists
|
|
35
|
+
spoti-cli playlist list --json
|
|
36
|
+
spoti-cli playlist get PLAYLIST_ID --json
|
|
37
|
+
spoti-cli playlist add PLAYLIST_ID --tracks URI1,URI2
|
|
38
|
+
|
|
39
|
+
# Current user
|
|
40
|
+
spoti-cli me --json
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Tunable Attributes
|
|
44
|
+
|
|
45
|
+
Fine-tune recommendations with audio features:
|
|
46
|
+
|
|
47
|
+
| Flag | Range | What it controls |
|
|
48
|
+
|------|-------|-----------------|
|
|
49
|
+
| `--energy` | 0.0–1.0 | Intensity |
|
|
50
|
+
| `--danceability` | 0.0–1.0 | Groove factor |
|
|
51
|
+
| `--valence` | 0.0–1.0 | Happy ↔ sad |
|
|
52
|
+
| `--tempo` | BPM | Speed |
|
|
53
|
+
| `--acousticness` | 0.0–1.0 | Acoustic ↔ electronic |
|
|
54
|
+
| `--instrumentalness` | 0.0–1.0 | Instrumental ↔ vocal |
|
|
55
|
+
| `--popularity` | 0–100 | Mainstream factor |
|
|
56
|
+
|
|
57
|
+
## AI Agents
|
|
58
|
+
|
|
59
|
+
Every command supports `--json`. Pair with Claude, GPT, or any LLM to generate playlists from natural language.
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
"Create a lo-fi playlist for studying"
|
|
63
|
+
→ AI maps mood → search seeds → recommend → create
|
|
64
|
+
→ Playlist on your Spotify
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Stack
|
|
68
|
+
|
|
69
|
+
Bun · TypeScript · Spotify Web API · OAuth2 PKCE
|
|
70
|
+
|
|
71
|
+
## License
|
|
72
|
+
|
|
73
|
+
MIT — [Crafter Station](https://github.com/crafter-station)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@crafter/spoti-cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Spotify Web API from your terminal. Search, recommend, and create playlists.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -22,7 +22,8 @@
|
|
|
22
22
|
"@types/bun": "^1.2.0"
|
|
23
23
|
},
|
|
24
24
|
"files": [
|
|
25
|
-
"dist"
|
|
25
|
+
"dist",
|
|
26
|
+
"README.md"
|
|
26
27
|
],
|
|
27
28
|
"keywords": [
|
|
28
29
|
"spotify",
|