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.
See It In Action
Interactive preview & real-world examples
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
Install
Config
First Trigger
Commands
| Command | Description | Required Args |
|---|---|---|
| Search Books | Search e-books in bookstore | search keyword |
| Search Author | Search author information | author name |
| Search Web Novels | Search web novels | novel 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:
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Search keyword |
scope | int | No | Search type. Agent should select explicitly according to the “Scope Selection Guide” below; defaults to 10 (e-books) if not specified |
maxIdx | int | No | Pagination offset, default 0 |
count | int | No | Items per page, defaults to 15 if not specified. Do not pass when user doesn’t specify count |
Scope Mapping:
| scope | Name | Description |
|---|---|---|
0 | All | Comprehensive search, results contain multiple groups; suitable when user only says “search” without specifying type |
10 | e-books | Search e-books only (excluding web novels); suitable when user explicitly “searches for a book” |
16 | Web Novels | Search web novels only |
14 | Audiobooks | Audiobooks/albums/podcasts |
6 | Authors | Search authors |
12 | Full Text | Search book content |
13 | Book Lists | Search book lists |
2 | Official Accounts | Search official accounts |
4 | Articles | Search 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 usescope=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):
| Field | Description |
|---|---|
sid | Search session ID |
hasMore | Has more results (1=yes, 0=no) |
results | Search result groups array |
results[].title | Group title (e.g., “e-books”, “authors”) |
results[].scope | Group type |
results[].scopeCount | Total results in group |
results[].books | Books/results array |
results[].books[].bookInfo.bookId | Book ID |
results[].books[].bookInfo.title | Book title |
results[].books[].bookInfo.author | Author |
results[].books[].bookInfo.cover | Cover URL |
results[].books[].readingCount | Reader count |
results[].books[].newRating | Rating (0-100) |
results[].books[].newRatingCount | Rating count |
Workflow
- Select
scopebased on user intent, call/store/search. - Extract results from
results. Single tab mode (scope>0) usually has one group; all mode (scope=0) has multiple groups. - Display results: title, author, rating, reader count, category. Mark sold-out items (soldout=1).
- After user selects a book, call
/book/infofor full details. - Pagination: When
hasMoreis 1, use the lastsearchIdxasmaxIdxfor next page.
Environment Matrix
Dependencies
- Author
- weread
- 1.0.3
- 2026-05-17
- reading
WeRead
WeRead Assistant - Search books, manage bookshelf, view notes and highlights, browse reviews, …
View Details →WeRead Book Info
View WeRead book details, table of contents, and reading progress. Get book basic info, publication …
View Details →WeRead Bookshelf
View WeRead bookshelf, including e-books and albums/audiobooks. Understand bookshelf count rules …
View Details →