skills.rest
Beat-YT
Beat-YTCOMMUNITY
Explore all skills by this author →
𝕏@beat_t1GitHub

statsfm

Query the stats.fm API to retrieve listening history, play counts, and global charts.

3|1|Updated Feb 24, 2026
Search Tags:#charts#spotify#now-playing#top-tracks#statsfm#music-data#artist-history
One-click install
npx skills add https://github.com/Beat-YT/statsfm-cli --skill statsfm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: statsfm
Source: https://github.com/Beat-YT/statsfm-cli/tree/main
Command: npx skills add https://github.com/Beat-YT/statsfm-cli --skill statsfm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Access and analyze your stats.fm listening data without fiddly setup, enabling quick insights into personal or public music activity.

Core Features & Use Cases

  • Unified CLI to view top artists/tracks/albums/genres, now playing, recent streams, detailed breakdowns, and global charts.
  • Personal and public data access: run commands with or without a username, enabling both private profiles and public lookups.
  • Drill-downs and time-based analyses: per-artist history, per-album breakdowns, and time-range comparisons across months and days.

Quick Start

Ask stats.fm for your top tracks in the last 4 weeks using your username.

Frequently Asked Questions about statsfm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze my stats.fm listening history and play counts?▼

You can query your Spotify listening history through the stats.fm API to reveal play counts, top tracks, and recent streams. Use the optional --user flag for private profile data or omit it to query public listening history.

Can I view my top Spotify tracks and artist history for a specific month?▼

Yes, you can retrieve top tracks and artist history for specific time ranges. The Skill supports monthly breakdowns and per-day time-range comparisons to analyze your Spotify listening activity across defined periods.

Does this stats.fm data tool require external Python dependencies?▼

No, querying stats.fm data requires no external dependencies. The Skill uses a Python 3.6+ script built entirely on the standard library, requiring only a valid Python environment and a stats.fm account for private data access.

What's the best way to check now-playing Spotify tracks and global charts?▼

The best way to check now-playing tracks and global charts is via the unified CLI querying stats.fm data. It provides direct access to current playback status and global chart rankings without manual API configuration.

Can I look up public stats.fm profiles and album breakdowns without logging in?▼

You can look up public stats.fm profiles and per-album breakdowns without authentication by running commands without a username. This enables public listening history queries and discography drill-downs for any publicly available profile.

Related Skills

Explore More Data & Analytics Skills→
viralcodeviralcode
61

emporia-energy

Query Emporia Vue energy data via PyEmVue cloud or local ESPHome API.

Community
Intermediate
adelproadelpro
2

repo-metrics

Track GitHub repository metrics as JSON time-series for trend analysis.

Community
Intermediate
claude-office-skillsclaude-office-skills
368

Spotify Automation

Automate Spotify playback, playlist management, and audio analysis via the Spotify API.

Official
Intermediate
aayushsoamaayushsoam
1

spotify

Control Spotify playback, search, playlists, and device transfer via the Clawbot Spotify toolset.

Community
Advanced