메뉴
使用 Python + spotipy 控制 Spotify 播放的技能。支持播放/暂停/切歌/音量/随机、搜索歌曲并播放、按关键词混合生成歌单（如抖音热歌、某风格、某歌手）、查看当前播放状态和设备列表。当用户提到"Spotify"、"播放音乐"、"切歌"、"暂停"、"搜索歌曲"、"换歌单"、"spotify-hub"，或任何需要控制 Spotify 播放的场景，必须触发本技能。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
闲鱼（咸鱼/goofish）二手商品搜索与查询技能。支持搜索商品、查询价格行情、 筛选城市/价格区间/排序、查看商品详情、管理收藏、查询订单和已发布商品。 支持输出网页链接和 fleamarket:// APP 直达链接。 内置「关键字增强」：当搜索结果为空或极少时，自动补充同类别替代关键字重试， 大幅提升搜索命中率。 当用户提到「闲鱼」「咸鱼」「二手」「goofish」「搜一下xx多少钱」「找一下xx的商品」 「搜不到」，或任何需要查询闲鱼商品价格/搜索二手商品的场景，必须触发本技能。
查询 App Store 全球各地区应用价格的技能，通过 appstoreprice.org 获取数据。 使用 Minis 内置浏览器（minis-browser-use CLI）在页面上下文中直接调用网站原生签名函数， 无需 API Key、无需自行实现签名算法。支持：按名称搜索应用、查询单个 App 所有地区价格、 获取最便宜地区排行、分页浏览应用列表。 当用户提到"App Store 价格"、"哪个区最便宜"、"土耳其区价格"、"appstoreprice"、 "app 比价"、"App Store 低价区"、"订阅哪个区划算"，或任何需要查询 iOS/macOS App 跨地区价格对比的场景，必须触发本技能。
夸克网盘文件管理工具。支持登录、列目录、转存分享链接、下载文件、创建目录。登录改用 minis-browser-use 替代原项目的 Playwright。当用户提到「夸克网盘」「夸克下载」「夸克转存」「quark」「pan.quark.cn」时触发本技能。
Reverse DCF（反推现金流折现模型）估值工具。用市场价格倒推市场隐含增长率预期，替代正向DCF"调参数凑结论"的套路。适用于FCFF为正的成熟公司（A股/港股/美股）。当用户说"反推DCF"、"Reverse DCF"、"隐含增长率"、"市场隐含预期"、"price in"、"估值反推"、"反推估值"、"用DCF算一下"或要求"算算市场在赌什么"时触发。不适合FCFF为负的公司（此时改用PS隐含收入反推）。
美股实时行情查询。三大指数（道指/标普/纳指） + Magnificent 7（NVDA/AAPL/MSFT/GOOGL/AMZN/META/TSLA）+ VIX恐慌指数 + 0DTE Gamma状态分析。当用户说"美股"、"查美股"、"美国股市"、"七姐妹"、"Magnificent 7"、"VIX"、"恐慌指数"、"标普"、"纳指"、"道指"时触发。
免费语音合成（edge-tts），无需 API Key 无需注册。将文本转为 mp3 音频文件。 当用户说"朗读""语音合成""文字转语音""TTS""生成音频""读一下" "读出来""念一下""听一下"或任何需要将文本转为语音播放的场景时触发。
| name | spotify-hub |
| version | 1.0.0 |
| description | 使用 Python + spotipy 控制 Spotify 播放的技能。支持播放/暂停/切歌/音量/随机、搜索歌曲并播放、按关键词混合生成歌单（如抖音热歌、某风格、某歌手）、查看当前播放状态和设备列表。当用户提到"Spotify"、"播放音乐"、"切歌"、"暂停"、"搜索歌曲"、"换歌单"、"spotify-hub"，或任何需要控制 Spotify 播放的场景，必须触发本技能。 |
通过 spotipy 库调用 Spotify Web API，控制播放并搜索音乐。
两个脚本均使用 uv inline script 声明依赖（spotipy>=2.26.0），用 uv run 执行时自动安装，无需手动 pip install，开箱即用。
必须设置以下环境变量（未设置则引导用户创建）：
凭证申请：https://developer.spotify.com/dashboard → Create App → Redirect URI 填 http://127.0.0.1:8888/callback
Token 保存在 ~/.config/spotify/cache，含 refresh_token，正常情况下永久有效，无需重复授权。
需要授权时，在后台启动授权服务器，获取 URL 后直接给用户点击：
# 后台启动授权服务器
import subprocess, time
subprocess.Popen(["uv", "run", "--script", "--cache-dir", "/root/.cache/uv",
"/var/minis/skills/spotify-hub/scripts/spotify_auth.py"],
stdout=open("/tmp/spotify_auth.log", "w"), stderr=subprocess.STDOUT)
time.sleep(2)
url = open("/tmp/spotify_auth_url.txt").read().strip()
print(url)
然后在回复中给用户提供可点击的授权链接：
[👉 点击授权 Spotify](<url>)
授权完成后浏览器显示"✅ Spotify 授权成功！"，用户告知后即可继续操作。
所有操作通过 /var/minis/skills/spotify-hub/scripts/spotify.py 执行：
uv run --script --cache-dir /root/.cache/uv /var/minis/skills/spotify-hub/scripts/spotify.py <cmd> [args]
| 命令 | 说明 |
|---|---|
status | 当前播放状态 + 设备列表 |
play / pause | 播放 / 暂停 |
next / prev | 下一首 / 上一首 |
volume <0-100> | 设置音量 |
shuffle on/off | 随机播放开关 |
repeat off/track/context | 循环模式 |
seek <秒或mm:ss> | 跳转进度 |
search <关键词> | 搜索并播放 |
play-track <id/uri> | 播放指定歌曲 |
play-playlist <id/uri> | 播放指定歌单 |
save / unsave | 收藏 / 取消收藏当前歌曲 |
liked [数量] | 查看已收藏歌曲 |
recent [数量] | 最近播放记录 |
top [tracks/artists] [数量] | 最常听歌曲 / 艺术家 |
playlists | 查看我的歌单列表 |
create-playlist <名称> | 新建歌单 |
add-to-playlist <id> | 当前歌曲加入歌单 |
follow <艺术家名> | 关注艺术家 |
following | 查看关注的艺术家 |
第三方公开歌单会返回 403，不要尝试读取歌单，改用多关键词搜索混合播放：
from scripts.spotify import get_sp, search_multi_and_play
sp = get_sp()
keywords = ["抖音热门", "douyin trending", "tiktok viral 2024", "抖音神曲"]
search_multi_and_play(sp, keywords, count_each=10, market="HK")
或直接用 shell_execute 调用 spotify.py search：
uv run --script --cache-dir /root/.cache/uv /var/minis/skills/spotify-hub/scripts/spotify.py search "抖音热门"
market="HK" 可搜到更多中文歌曲pip show spotipy 可验证）