WeRead Statistics

Track and analyze reading habits and statistics

✨ The solution you've been looking for

View WeRead reading statistics, including reading duration, days, preference analysis, and reading summary.

WeRead Reading Statistics Analytics

See It In Action

Interactive preview & real-world examples

Live Demo
Skill Demo Animation

AI Conversation Simulator

See how users interact with this skill

User Prompt

How much did I read this month?

Skill Processing

Querying...

Agent Response

This month you read 12 books, 23 hours total, averaging 45 minutes per day

Quick Start (3 Steps)

Get up and running in minutes

1

Install

2

Config

Set WEREAD_API_KEY environment variable
3

First Trigger

Commands

CommandDescriptionRequired Args
View Reading SummaryGet overall reading statisticsNone
View Yearly StatisticsGet yearly reading statisticsyear (optional)
View Monthly StatisticsGet monthly reading statisticsyear, month

Typical Use Cases

View Reading Summary

Get overall reading statistics

View Monthly Statistics

Get monthly reading breakdown

Overview

readdata — Reading Statistics

API

/readdata/getsummary — Reading Summary

Request Parameters: None

Response:

FieldDescriptionUnit
totalReadingTimeTotal reading durationseconds
totalReadingDaysTotal reading daysdays
totalReadBooksTotal finished booksbooks
bookCountTotal books in shelfbooks
noteCountTotal notesnotes
highlightCountTotal highlightshighlights
recentReadBookRecently read bookobject

/readdata/getyear — Yearly Statistics

Request Parameters:

ParameterTypeRequiredDescription
yearintNoYear, default current year

Response:

FieldDescriptionUnit
yearYear-
monthData[]Monthly data array-
monthData[].readingTimeMonthly reading durationseconds
monthData[].readingDaysMonthly reading daysdays
monthData[].bookCountBooks finishedbooks
totalReadingTimeYear total reading timeseconds
totalReadingDaysYear total reading daysdays
totalBookCountYear total booksbooks

/readdata/getmonth — Monthly Statistics

Request Parameters:

ParameterTypeRequiredDescription
yearintYesYear
monthintYesMonth (1-12)

Response:

FieldDescriptionUnit
readingTimeMonthly reading durationseconds
readingDaysMonthly reading daysdays
bookCountBooks finishedbooks
weekData[]Weekly data-

Output Format

  • Time: Convert seconds → “X hours Y minutes”
  • Dates: Unix timestamp → YYYY-MM-DD
  • Use natural language: “You read 23 hours this month, averaging 45 minutes per day”

Workflow

  1. Overall summary: Call /readdata/getsummary.
  2. Yearly stats: Call /readdata/getyear.
  3. Monthly stats: Call /readdata/getmonth with year and month.

Environment Matrix

Dependencies

WEREAD_API_KEY environment variable

Author
weread
1.0.3
2026-05-17
reading