WeRead Search

Search books, authors and content in WeRead bookstore

✨ The solution you've been looking for

Search books, authors, official accounts and other content in WeRead bookstore. Supports e-books, web novels, audiobooks, book lists, etc.

WeRead Search Bookstore

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

Search for Three-Body

Skill Processing

Searching...

Agent Response

Found 'The Three-Body Problem' by Liu Cixin, rating 92, 420K readers

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
Search BooksSearch e-books in bookstoresearch keyword
Search AuthorSearch author informationauthor name
Search Web NovelsSearch web novelsnovel keyword

Typical Use Cases

Search Books

Search for desired books in bookstore

Search Author

Find works by specific author

Overview

search — Search

Supports multiple search types, switch tabs via scope parameter to specify different search result pages.

API

/store/search

Request Parameters:

ParameterTypeRequiredDescription
keywordstringYesSearch keyword
scopeintNoSearch type. Agent should select explicitly according to the “Scope Selection Guide” below; defaults to 10 (e-books) if not specified
maxIdxintNoPagination offset, default 0
countintNoItems per page, defaults to 15 if not specified. Do not pass when user doesn’t specify count

Scope Mapping:

scopeNameDescription
0AllComprehensive search, results contain multiple groups; suitable when user only says “search” without specifying type
10e-booksSearch e-books only (excluding web novels); suitable when user explicitly “searches for a book”
16Web NovelsSearch web novels only
14AudiobooksAudiobooks/albums/podcasts
6AuthorsSearch authors
12Full TextSearch book content
13Book ListsSearch book lists
2Official AccountsSearch official accounts
4ArticlesSearch official account articles

Scope Selection Guide (Agent auto-selects based on user intent):

  • User explicitly says “search book/find book/look for a book” or requests bookId → scope=10 (e-books)
  • User only says “search for xx” without specifying book/author/article/account → scope=0 (all)
  • User says “web novel/online novel” → scope=16; for general “novel” intent, still use scope=10
  • User says “audiobook/audio/podcast/album” → scope=14
  • User says “search author xx/find author” → scope=6
  • User says “mentioned in book/full text search” → scope=12
  • User says “book lists/recommend book lists” → scope=13
  • User says “search official account” → scope=2
  • User says “search article” → scope=4

Response (V3 Format):

FieldDescription
sidSearch session ID
hasMoreHas more results (1=yes, 0=no)
resultsSearch result groups array
results[].titleGroup title (e.g., “e-books”, “authors”)
results[].scopeGroup type
results[].scopeCountTotal results in group
results[].booksBooks/results array
results[].books[].bookInfo.bookIdBook ID
results[].books[].bookInfo.titleBook title
results[].books[].bookInfo.authorAuthor
results[].books[].bookInfo.coverCover URL
results[].books[].readingCountReader count
results[].books[].newRatingRating (0-100)
results[].books[].newRatingCountRating count

Workflow

  1. Select scope based on user intent, call /store/search.
  2. Extract results from results. Single tab mode (scope>0) usually has one group; all mode (scope=0) has multiple groups.
  3. Display results: title, author, rating, reader count, category. Mark sold-out items (soldout=1).
  4. After user selects a book, call /book/info for full details.
  5. Pagination: When hasMore is 1, use the last searchIdx as maxIdx for next page.

Environment Matrix

Dependencies

WEREAD_API_KEY environment variable

Author
weread
1.0.3
2026-05-17
reading