WeRead Bookshelf

View bookshelf, manage e-books and audiobooks

✨ The solution you've been looking for

View WeRead bookshelf, including e-books and albums/audiobooks. Understand bookshelf count rules including e-books, albums, and article favorites.

WeRead Bookshelf Audiobooks

See It In Action

Interactive preview & real-world examples

Live Demo

AI Conversation Simulator

See how users interact with this skill

User Prompt

How many books are in my bookshelf?

Skill Processing

Querying...

Agent Response

Your bookshelf has 13 items: 10 e-books + 3 albums/audiobooks

Quick Start (3 Steps)

Get up and running in minutes

Install

Config

Set WEREAD_API_KEY environment variable

First Trigger

Commands

Command	Description	Required Args
View Bookshelf	View user bookshelf	None

Typical Use Cases

View Bookshelf

View user's bookshelf content

Overview

shelf — Bookshelf Management

Important Concepts

Album = Audiobook - they are the same concept. In WeRead, audiobook content exists as “albums” in the albums field, separate from books (e-books).

Bookshelf “books” include both e-books and albums/audiobooks. When user asks “how many books in my bookshelf”, count both books[] and albums[].

API

/shelf/sync

Request Parameters: None (user identity auto-identified via API Key)

Response:

Field	Description
`books[]`	E-books array
`books[].bookId`	Book ID
`books[].title`	Book title
`books[].author`	Author
`books[].cover`	Cover URL
`books[].readUpdateTime`	Last reading time
`books[].finishReading`	Finished status (1=finished)
`albums[]`	Albums/audiobooks array
`albums[].albumInfo.albumId`	Album ID
`albums[].albumInfo.name`	Album name
`albums[].albumInfo.authorName`	Narrator/author
`albums[].albumInfo.trackCount`	Track count
`mp`	Article favorites entry (if exists)

Count Rules

Question/Metric	Calculation	Description
Total bookshelf items	`books.length + albums.length + (mp ? 1 : 0)`	Default answer for “how many books”
E-book count only	`books.length`	Only when user explicitly asks for e-books
Audiobook/album count	`albums.length`	Separate count for audiobooks

Important: Always use the formula books.length + albums.length + (mp ? 1 : 0) when answering shelf count questions.

Environment Matrix

Dependencies

WEREAD_API_KEY environment variable

Author: weread
: 1.0.3
: 2026-05-17
: reading