← 返回 Skills 市场
670
总下载
3
收藏
3
当前安装
15
版本数
在 OpenClaw 中安装
/install statsfm
功能描述
Comprehensive Music data tool for Spotify and Apple Music, powered by the stats.fm API. Look up album tracklists, artist discographies, and global charts wit...
安全使用建议
This skill appears to be a straightforward stats.fm client: it will make unauthenticated HTTPS requests to api.stats.fm and, if you provide a username, fetch that user's public/personal stats. Before installing, confirm your environment can run Python 3.6+ (the package contains a Python script) and be aware that providing a stats.fm username or storing it in memory/ENV (STATSFM_USER) exposes your public listening history to the skill. The metadata omits declaring the optional STATSFM_USER env var and does not list Python as a required binary—make sure the platform will run the script as intended. If you want to avoid any personal-data calls, do not supply a username.
功能分析
Type: OpenClaw Skill
Name: statsfm
Version: 2.6.1
The statsfm skill is a legitimate tool for analyzing Spotify and Apple Music listening data via the stats.fm API. The Python script (scripts/statsfm.py) is a well-structured wrapper that uses standard libraries to perform GET requests to the official API endpoints, with proper input sanitization using quote() and type enforcement via argparse. The SKILL.md instructions are focused on guiding the AI agent to provide detailed music analysis and do not contain any prompt-injection attacks or instructions to perform unauthorized actions.
能力评估
Purpose & Capability
Name/description (stats.fm music data) align with the included Python client and the referenced stats.fm API endpoints. The behavior (fetching user and public charts/streams data) is consistent with the stated purpose.
Instruction Scope
SKILL.md instructs the agent to call multiple stats.fm endpoints and to request a username for personal queries. It does not direct reading unrelated user files or exfiltrating data to third-party endpoints. The guidance to check agent memory for a stats.fm username is expected for a personalized-data skill.
Install Mechanism
There is no install spec (instruction-only), but the package includes a Python script (scripts/statsfm.py). The skill claims the script uses only the stdlib (no extra packages). The registry metadata does not declare a required Python binary; ensure the host can run Python 3.6+ before invoking the script.
Credentials
No secrets or credentials are required. The code optionally reads STATSFM_USER from the environment (DEFAULT_USER) to default the username — this is proportional to the feature. No other sensitive env vars or unrelated credentials are requested.
Persistence & Privilege
The skill is not always-enabled and uses default autonomous invocation settings. It does not request system-wide changes or access to other skills' configs.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install statsfm - 安装完成后，直接呼叫该 Skill 的名称或使用
/statsfm触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.6.1
- Fixed history range argument bug
- Updated recent command to include now playing track.
- Updated description to reflect Apple Music support and enhanced platform coverage.
v2.6.0
Update statsfm.py script for less ambiguous commands usage.
v2.5.2
Remove ambiguous legacy range aliases (weeks, months, lifetime)
v2.5.1
Tightened SKILL.md AI agents section: added ALWAYS check multiple ranges directive, compressed guidance from ~40 to ~25 lines while keeping all operational patterns
v2.5.0
Explicit range aliases (1d, 4w, 6m, all), duration ranges (7d, 14d, 30d, 90d), updated docs
v2.4.4
Fix docs conflict that triggered suspicious flag: Setup section now clearly separates public commands (no account) from personal stats commands (username required)
v2.4.3
Clarify description: account optional for public features, Spotify mentioned for personal stats
v2.4.2
Use local timezone in API calls, local time in recent streams, DRY refactor
v2.4.1
Remove non-essential files (README, LICENSE)
v2.4.0
New in 2.4.0:
- Added `album` command to look up album info and full tracklists, including track durations and [E] tags.
- Added `artist-albums` command to list an artist’s full discography, grouped by type (Albums, Singles & EPs, Compilations) with deduplication and overflow handling.
- Updated documentation and examples to cover new album/artist lookup features.
- Clarified description to highlight support for music data lookups without a username.
v2.3.7
- Removed README.md, consolidating documentation into SKILL.md only.
- Updated setup instructions: removed environment variable usage (STATSFM_USER); now only accepts username via `--user` flag.
- Adjusted error message and handling when no user is provided.
- Better user command output
v2.3.6
- Fixed the stats.fm script to sanitize inputs.
v2.3.5
Add IDs to currently playing.
v2.3.4
- Minor documentation update: clarified setup steps for setting your default username.
- Added note to also remember your user id when setting STATSFM_USER.
- Removed reference for agents to check TOOLS.md for default username.
- Add featured artists name
v2.3.3
Comprehensive Python CLI for querying stats.fm (Spotify listening stats). 18 commands for exploring listening history, tracking music eras, and analyzing taste
evolution.
Key features:
- Custom date ranges (--start/--end) for precise period analysis
- Automatic monthly breakdowns showing listening progression
- Top lists, detailed stats, global charts, and drill-downs
- Albums display by default (matching stats.fm UI)
- Works for Plus and Free users
- Zero dependencies (Python stdlib only)
Perfect for:
- Tracking listening eras ("When did my Sabrina era start?")
- Counting plays ("How many times did I listen to Espresso in 2025?")
- Comparing periods (Q1 vs Q4, summer vs winter)
- Discovering music patterns and conversions
元数据
常见问题
statsfm 是什么？
Comprehensive Music data tool for Spotify and Apple Music, powered by the stats.fm API. Look up album tracklists, artist discographies, and global charts wit... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 670 次。
如何安装 statsfm？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install statsfm」即可一键安装，无需额外配置。
statsfm 是免费的吗？
是的，statsfm 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
statsfm 支持哪些平台？
statsfm 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 statsfm？
由 Mel（@space0mel）开发并维护，当前版本 v2.6.1。
推荐 Skills