@oomol-lab/open-connector 1.9.0 → 1.9.2

package/assets/open-connector/catalog/apps/weread.json

@@ -0,0 +1,1514 @@
+{
+  "service": "weread",
+  "displayName": "WeRead",
+  "homepageUrl": "https://weread.qq.com/",
+  "categories": [
+    "Productivity"
+  ],
+  "authTypes": [
+    "api_key"
+  ],
+  "auth": [
+    {
+      "type": "api_key",
+      "label": "API Key",
+      "placeholder": "wrk-xxxxxxxx",
+      "description": "Get an API key linked to your WeRead account at https://weread.qq.com/r/weread-skills. The key provides Bearer-authenticated access to your reading data."
+    }
+  ],
+  "actions": [
+    {
+      "id": "weread.get_book",
+      "service": "weread",
+      "name": "get_book",
+      "description": "Get book details by ID.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId"
+        ],
+        "description": "Parameters for get_book."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "title": {
+            "type": "string",
+            "description": "Book title."
+          },
+          "author": {
+            "type": "string",
+            "description": "Book author."
+          },
+          "readerLink": {
+            "type": "string",
+            "description": "Use this upstream reader URL to open the book; do not construct a URL."
+          },
+          "deepLink": {
+            "type": "string",
+            "description": "Book details link; use when readerLink is absent."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Book metadata, including any upstream links and additional fields."
+      }
+    },
+    {
+      "id": "weread.get_reading_progress",
+      "service": "weread",
+      "name": "get_reading_progress",
+      "description": "Get reading progress. Progress 1 means 1%; completion requires progress 100 and finishTime.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId"
+        ],
+        "description": "Parameters for get_reading_progress."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "book": {
+            "type": "object",
+            "properties": {
+              "progress": {
+                "type": "integer",
+                "description": "Reading percentage from 0 to 100, not a fraction."
+              },
+              "recordReadingTime": {
+                "type": "number",
+                "description": "Accumulated reading time in seconds."
+              },
+              "finishTime": {
+                "type": "integer",
+                "description": "Completion Unix timestamp, present only after finishing."
+              },
+              "chapterUid": {
+                "type": "integer",
+                "description": "The chapter UID returned by list_chapters."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Reading progress and timestamps."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Reading progress response."
+      }
+    },
+    {
+      "id": "weread.get_reading_stats",
+      "service": "weread",
+      "name": "get_reading_stats",
+      "description": "Get reading statistics for one period. Durations are seconds; annual mode covers only the selected calendar year.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": [
+              "weekly",
+              "monthly",
+              "annually",
+              "overall"
+            ],
+            "description": "Period: weekly, monthly (default), annually or overall."
+          },
+          "baseTime": {
+            "type": "integer",
+            "description": "Unix timestamp in the desired period; 0 selects the current period. Overall always uses 0."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Parameters for get_reading_stats."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "baseTime": {
+            "type": "integer",
+            "description": "Normalized period start Unix timestamp; 0 for overall."
+          },
+          "totalReadTime": {
+            "type": "number",
+            "description": "Total reading and listening time in seconds for this period; prefer this over summing buckets."
+          },
+          "dayAverageReadTime": {
+            "type": "number",
+            "description": "Average seconds per calendar day, not per active reading day."
+          },
+          "readDays": {
+            "type": "integer",
+            "description": "Effective reading days, currently days with at least one minute of reading."
+          },
+          "readTimes": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "number",
+              "description": "Reading seconds in this bucket."
+            },
+            "description": "Bucket start timestamps mapped to reading seconds."
+          },
+          "dailyReadTimes": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "number",
+              "description": "Reading seconds on this day."
+            },
+            "description": "Optional daily timestamp-to-seconds map in annual mode."
+          },
+          "preferTime": {
+            "type": "array",
+            "items": {
+              "type": "number",
+              "description": "Reading seconds in this hour."
+            },
+            "description": "Hourly reading seconds ordered from 06:00 through 05:00 the next day."
+          },
+          "preferAuthor": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "Author name."
+                },
+                "readTime": {
+                  "type": "string",
+                  "description": "Formatted duration text, not a number of seconds."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Author preference."
+            },
+            "description": "Preferred authors."
+          },
+          "readLongest": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "book": {
+                  "type": "object",
+                  "properties": {
+                    "bookId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The book ID returned by search or the shelf."
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "Book title."
+                    },
+                    "author": {
+                      "type": "string",
+                      "description": "Book author."
+                    },
+                    "readerLink": {
+                      "type": "string",
+                      "description": "Use this upstream reader URL to open the book; do not construct a URL."
+                    },
+                    "deepLink": {
+                      "type": "string",
+                      "description": "Book details link; use when readerLink is absent."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Book metadata, including any upstream links and additional fields."
+                },
+                "albumInfo": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "Audio album metadata when this is audio content."
+                },
+                "readTime": {
+                  "type": "number",
+                  "description": "Reading or listening time in seconds for this period."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A reading-time ranking entry."
+            },
+            "description": "Top books or audio albums by reading time, up to 10 entries."
+          },
+          "readStat": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Summary stat, counts and optional scheme."
+            },
+            "description": "Upstream reading summary labels and formatted counts."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Reading statistics; fields vary with mode and available data."
+      }
+    },
+    {
+      "id": "weread.get_review",
+      "service": "weread",
+      "name": "get_review",
+      "description": "Get a single thought or review with optional comments and likes.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "reviewId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Thought or review ID."
+          },
+          "commentsCount": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Number of comments to fetch; default 10."
+          },
+          "commentsDirection": {
+            "type": "integer",
+            "description": "Comment order: 0 descending, 1 ascending.",
+            "enum": [
+              0,
+              1
+            ]
+          },
+          "likesCount": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Number of likes to fetch; default 10."
+          },
+          "likesDirection": {
+            "type": "integer",
+            "description": "Like order; only 0 (descending) is documented.",
+            "enum": [
+              0
+            ]
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "reviewId"
+        ],
+        "description": "Parameters for get_review."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "reviewId": {
+            "type": "string",
+            "description": "Thought or review ID."
+          },
+          "review": {
+            "type": "object",
+            "properties": {
+              "content": {
+                "type": "string",
+                "description": "Review text."
+              },
+              "abstract": {
+                "type": "string",
+                "description": "Highlighted source text, when this review refers to a passage."
+              },
+              "range": {
+                "type": "string",
+                "description": "Position range of the source passage, when available."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Review details, including conditional abstract, range, content and author fields."
+          },
+          "htmlContent": {
+            "type": "string",
+            "description": "Upstream rich-text HTML."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Thought or review details."
+      }
+    },
+    {
+      "id": "weread.get_shelf",
+      "service": "weread",
+      "name": "get_shelf",
+      "description": "Read the shelf. Visible entries equal books.length + albums.length + 1 when mp is nonempty; bookCount excludes audio and mp.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "Parameters for get_shelf."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "books": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "bookId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The book ID returned by search or the shelf."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Book title."
+                },
+                "author": {
+                  "type": "string",
+                  "description": "Book author."
+                },
+                "readerLink": {
+                  "type": "string",
+                  "description": "Use this upstream reader URL to open the book; do not construct a URL."
+                },
+                "deepLink": {
+                  "type": "string",
+                  "description": "Book details link; use when readerLink is absent."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Book metadata, including any upstream links and additional fields."
+            },
+            "description": "Ebooks and imported books, excluding audio albums and the mp entry."
+          },
+          "albums": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Audio album metadata and listening state."
+            },
+            "description": "Audiobook albums, which also count as shelf entries."
+          },
+          "mp": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Article collection entry; a nonempty object counts as one private shelf entry."
+          },
+          "archive": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Folder name and book IDs."
+            },
+            "description": "Book list folders."
+          },
+          "bookCount": {
+            "type": "integer",
+            "description": "Ebook count only; not the total shelf count."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Shelf response."
+      }
+    },
+    {
+      "id": "weread.get_underline_stats",
+      "service": "weread",
+      "name": "get_underline_stats",
+      "description": "Get chapter highlight popularity statistics without source text.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "chapterUid": {
+            "type": "integer",
+            "description": "The chapter UID returned by list_chapters."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId",
+          "chapterUid"
+        ],
+        "description": "Parameters for get_underline_stats."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "chapterUid": {
+            "type": "integer",
+            "description": "The chapter UID returned by list_chapters."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          },
+          "underlines": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Highlight range, count, score and type."
+            },
+            "description": "Highlight counts and scores, without text."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Chapter highlight statistics."
+      }
+    },
+    {
+      "id": "weread.list_book_reviews",
+      "service": "weread",
+      "name": "list_book_reviews",
+      "description": "List public book reviews. Continue with the last idx and returned synckey. Content is nested at reviews[].review.review.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "reviewListType": {
+            "type": "integer",
+            "description": "Filter: 0 all, 1 recommended, 2 negative, 3 newest, 4 average.",
+            "enum": [
+              0,
+              1,
+              2,
+              3,
+              4
+            ]
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page size; omit to use the upstream default."
+          },
+          "maxIdx": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Pagination offset from the previous page; initially 0."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId"
+        ],
+        "description": "Parameters for list_book_reviews."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          },
+          "reviewsCnt": {
+            "type": "integer",
+            "description": "Total public review count."
+          },
+          "reviewsHasMore": {
+            "type": "integer",
+            "description": "Whether another page exists: 1 means yes, 0 means no."
+          },
+          "reviews": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "idx": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Pagination offset from the previous page; initially 0."
+                },
+                "review": {
+                  "type": "object",
+                  "properties": {
+                    "reviewId": {
+                      "type": "string",
+                      "description": "Review ID."
+                    },
+                    "review": {
+                      "type": "object",
+                      "properties": {
+                        "content": {
+                          "type": "string",
+                          "description": "Review text."
+                        },
+                        "star": {
+                          "type": "integer",
+                          "description": "Rating: 20, 40, 60, 80 and 100 correspond to one through five stars."
+                        }
+                      },
+                      "additionalProperties": true,
+                      "description": "Public review body."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Public review wrapper."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Public review list entry."
+            },
+            "description": "Public review entries with two review wrappers."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Public reviews and pagination."
+      }
+    },
+    {
+      "id": "weread.list_chapters",
+      "service": "weread",
+      "name": "list_chapters",
+      "description": "List a book's chapter table of contents.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId"
+        ],
+        "description": "Parameters for list_chapters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          },
+          "chapters": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "chapterUid": {
+                  "type": "integer",
+                  "description": "The chapter UID returned by list_chapters."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Chapter title."
+                },
+                "chapterIdx": {
+                  "type": "integer",
+                  "description": "Chapter order."
+                },
+                "level": {
+                  "type": "integer",
+                  "description": "Heading level, starting at 1."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Chapter details."
+            },
+            "description": "Chapters in the book."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Chapter listing."
+      }
+    },
+    {
+      "id": "weread.list_highlight_reviews",
+      "service": "weread",
+      "name": "list_highlight_reviews",
+      "description": "List thoughts on specified highlight ranges, preserving per-range pagination.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "chapterUid": {
+            "type": "integer",
+            "description": "The chapter UID returned by list_chapters."
+          },
+          "reviews": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "range": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Position range returned by list_popular_highlights."
+                },
+                "maxIdx": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Pagination offset from the previous page; initially 0."
+                },
+                "count": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "Page size; values above 20 are truncated by the upstream service."
+                },
+                "synckey": {
+                  "type": "integer",
+                  "description": "The sync or pagination key returned by the previous response; initially 0."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "range"
+              ],
+              "description": "A highlight range query."
+            },
+            "description": "Highlight ranges and their independent page cursors."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId",
+          "chapterUid",
+          "reviews"
+        ],
+        "description": "Parameters for list_highlight_reviews."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "chapterUid": {
+            "type": "integer",
+            "description": "The chapter UID returned by list_chapters."
+          },
+          "reviews": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "range": {
+                  "type": "string",
+                  "description": "Highlight position range."
+                },
+                "hasMore": {
+                  "type": "integer",
+                  "description": "Whether another page exists: 1 means yes, 0 means no."
+                },
+                "maxIdx": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Pagination offset from the previous page; initially 0."
+                },
+                "synckey": {
+                  "type": "integer",
+                  "description": "The sync or pagination key returned by the previous response; initially 0."
+                },
+                "totalCount": {
+                  "type": "integer",
+                  "description": "Total thoughts for this range."
+                },
+                "pageReviews": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "review": {
+                        "type": "object",
+                        "properties": {
+                          "content": {
+                            "type": "string",
+                            "description": "Review text."
+                          },
+                          "abstract": {
+                            "type": "string",
+                            "description": "Highlighted source text, when this review refers to a passage."
+                          },
+                          "range": {
+                            "type": "string",
+                            "description": "Position range of the source passage, when available."
+                          }
+                        },
+                        "additionalProperties": true,
+                        "description": "Review details, including conditional abstract, range, content and author fields."
+                      }
+                    },
+                    "additionalProperties": true,
+                    "description": "Thought wrapper."
+                  },
+                  "description": "Thoughts on this page."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A range result."
+            },
+            "description": "Per-range results and cursors."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Thoughts for each requested range."
+      }
+    },
+    {
+      "id": "weread.list_highlights",
+      "service": "weread",
+      "name": "list_highlights",
+      "description": "List personal highlights in a book, excluding reading-position bookmarks. Query list_my_reviews as well to retrieve all exportable note content.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId"
+        ],
+        "description": "Parameters for list_highlights."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "updated": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "bookmarkId": {
+                  "type": "string",
+                  "description": "Highlight ID."
+                },
+                "markText": {
+                  "type": "string",
+                  "description": "Highlighted source text."
+                },
+                "chapterUid": {
+                  "type": "integer",
+                  "description": "The chapter UID returned by list_chapters."
+                },
+                "createTime": {
+                  "type": "integer",
+                  "description": "Creation Unix timestamp in seconds."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A personal highlight."
+            },
+            "description": "Highlights only; upstream filters out type 0 bookmarks."
+          },
+          "chapters": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Chapter metadata."
+            },
+            "description": "Chapter information used to locate highlights."
+          },
+          "book": {
+            "type": "object",
+            "properties": {
+              "bookId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The book ID returned by search or the shelf."
+              },
+              "title": {
+                "type": "string",
+                "description": "Book title."
+              },
+              "author": {
+                "type": "string",
+                "description": "Book author."
+              },
+              "readerLink": {
+                "type": "string",
+                "description": "Use this upstream reader URL to open the book; do not construct a URL."
+              },
+              "deepLink": {
+                "type": "string",
+                "description": "Book details link; use when readerLink is absent."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Book metadata, including any upstream links and additional fields."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Personal highlight content."
+      }
+    },
+    {
+      "id": "weread.list_my_reviews",
+      "service": "weread",
+      "name": "list_my_reviews",
+      "description": "List personal thoughts, chapter comments and book reviews. Continue with the returned synckey while hasMore is 1.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookid": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page size; omit to use the upstream default."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookid"
+        ],
+        "description": "Parameters for list_my_reviews."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "reviews": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "review": {
+                  "type": "object",
+                  "properties": {
+                    "content": {
+                      "type": "string",
+                      "description": "Review text."
+                    },
+                    "abstract": {
+                      "type": "string",
+                      "description": "Highlighted source text, when this review refers to a passage."
+                    },
+                    "range": {
+                      "type": "string",
+                      "description": "Position range of the source passage, when available."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Review details, including conditional abstract, range, content and author fields."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Personal review wrapper."
+            },
+            "description": "Personal review entries."
+          },
+          "totalCount": {
+            "type": "integer",
+            "description": "Total personal review count."
+          },
+          "hasMore": {
+            "type": "integer",
+            "description": "Whether another page exists: 1 means yes, 0 means no."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Personal reviews and pagination."
+      }
+    },
+    {
+      "id": "weread.list_notebooks",
+      "service": "weread",
+      "name": "list_notebooks",
+      "description": "List notebook summaries. Next lastSort is the final book's sort. Total notes include reviewCount + noteCount + bookmarkCount.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page size; omit to use the upstream default."
+          },
+          "lastSort": {
+            "type": "integer",
+            "description": "The last book's sort value from the previous page; omit on the first page."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Parameters for list_notebooks."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "totalBookCount": {
+            "type": "integer",
+            "description": "Total number of books with notes."
+          },
+          "totalNoteCount": {
+            "type": "integer",
+            "description": "Total highlights, personal reviews and bookmarks combined."
+          },
+          "hasMore": {
+            "type": "integer",
+            "description": "Whether another page exists: 1 means yes, 0 means no."
+          },
+          "books": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "bookId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The book ID returned by search or the shelf."
+                },
+                "book": {
+                  "type": "object",
+                  "properties": {
+                    "bookId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The book ID returned by search or the shelf."
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "Book title."
+                    },
+                    "author": {
+                      "type": "string",
+                      "description": "Book author."
+                    },
+                    "readerLink": {
+                      "type": "string",
+                      "description": "Use this upstream reader URL to open the book; do not construct a URL."
+                    },
+                    "deepLink": {
+                      "type": "string",
+                      "description": "Book details link; use when readerLink is absent."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Book metadata, including any upstream links and additional fields."
+                },
+                "sort": {
+                  "type": "integer",
+                  "description": "Cursor for the next lastSort request."
+                },
+                "noteCount": {
+                  "type": "integer",
+                  "description": "Highlight count only, not the total note count."
+                },
+                "reviewCount": {
+                  "type": "integer",
+                  "description": "Personal thoughts and reviews combined; do not count reviews twice."
+                },
+                "bookmarkCount": {
+                  "type": "integer",
+                  "description": "Reading-position bookmark count; bookmark content cannot be exported."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A notebook summary."
+            },
+            "description": "Books with notes."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Notebook summaries and pagination."
+      }
+    },
+    {
+      "id": "weread.list_popular_highlights",
+      "service": "weread",
+      "name": "list_popular_highlights",
+      "description": "Get up to 20 popular highlights with source text. The upstream result is fixed-size and does not support pagination.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "chapterUid": {
+            "type": "integer",
+            "description": "Chapter UID; 0 means all chapters and is the default."
+          },
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId"
+        ],
+        "description": "Parameters for list_popular_highlights."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "synckey": {
+            "type": "integer",
+            "description": "The sync or pagination key returned by the previous response; initially 0."
+          },
+          "totalCount": {
+            "type": "integer",
+            "description": "Total popular highlight count, possibly larger than this fixed-size result."
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "chapterUid": {
+                  "type": "integer",
+                  "description": "The chapter UID returned by list_chapters."
+                },
+                "range": {
+                  "type": "string",
+                  "description": "Highlight position range for list_highlight_reviews."
+                },
+                "markText": {
+                  "type": "string",
+                  "description": "Highlighted source text."
+                },
+                "totalCount": {
+                  "type": "integer",
+                  "description": "Number of readers highlighting this passage."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A popular highlight."
+            },
+            "description": "Popular highlight entries."
+          },
+          "chapters": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Chapter metadata."
+            },
+            "description": "Chapter information used to locate highlights."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Popular highlights."
+      }
+    },
+    {
+      "id": "weread.list_recommendations",
+      "service": "weread",
+      "name": "list_recommendations",
+      "description": "List personalized book recommendations. Continue with the last book's searchIdx as maxIdx.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page size; omit to use the upstream default."
+          },
+          "maxIdx": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Pagination offset from the previous page; initially 0."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Parameters for list_recommendations."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "books": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "bookId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The book ID returned by search or the shelf."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Book title."
+                },
+                "author": {
+                  "type": "string",
+                  "description": "Book author."
+                },
+                "readerLink": {
+                  "type": "string",
+                  "description": "Use this upstream reader URL to open the book; do not construct a URL."
+                },
+                "deepLink": {
+                  "type": "string",
+                  "description": "Book details link; use when readerLink is absent."
+                },
+                "searchIdx": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Pagination offset from the previous page; initially 0."
+                },
+                "reason": {
+                  "type": "string",
+                  "description": "Recommendation reason."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A recommended book."
+            },
+            "description": "Recommended books."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Personalized recommendations."
+      }
+    },
+    {
+      "id": "weread.list_similar_books",
+      "service": "weread",
+      "name": "list_similar_books",
+      "description": "List similar books. Defaults to count 12 and maxIdx 0; continue with the last idx and returned sessionId.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "bookId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The book ID returned by search or the shelf."
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page size; omit to use the upstream default."
+          },
+          "maxIdx": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Pagination offset from the previous page; initially 0."
+          },
+          "sessionId": {
+            "type": "string",
+            "description": "Session ID from the previous page; omit on the first page."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "bookId"
+        ],
+        "description": "Parameters for list_similar_books."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "booksimilar": {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "type": "string",
+                "description": "Session ID to send with the next page."
+              },
+              "books": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "idx": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Pagination offset from the previous page; initially 0."
+                    },
+                    "book": {
+                      "type": "object",
+                      "properties": {
+                        "bookInfo": {
+                          "type": "object",
+                          "properties": {
+                            "bookId": {
+                              "type": "string",
+                              "minLength": 1,
+                              "description": "The book ID returned by search or the shelf."
+                            },
+                            "title": {
+                              "type": "string",
+                              "description": "Book title."
+                            },
+                            "author": {
+                              "type": "string",
+                              "description": "Book author."
+                            },
+                            "readerLink": {
+                              "type": "string",
+                              "description": "Use this upstream reader URL to open the book; do not construct a URL."
+                            },
+                            "deepLink": {
+                              "type": "string",
+                              "description": "Book details link; use when readerLink is absent."
+                            }
+                          },
+                          "additionalProperties": true,
+                          "description": "Book metadata, including any upstream links and additional fields."
+                        }
+                      },
+                      "additionalProperties": true,
+                      "description": "Book result wrapper."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "A similar book result."
+                },
+                "description": "Similar book entries."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Similar books and their session."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Similar book recommendations."
+      }
+    },
+    {
+      "id": "weread.search",
+      "service": "weread",
+      "name": "search",
+      "description": "Search WeRead. Choose scope explicitly; use the last searchIdx as maxIdx for the next page. Response group scope may differ from request scope.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "keyword": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Search keywords."
+          },
+          "scope": {
+            "type": "integer",
+            "description": "Search type: 0 all, 10 ebooks, 16 web novels, 14 audio, 6 authors, 12 full text, 13 book lists, 2 public accounts, 4 articles.",
+            "enum": [
+              0,
+              10,
+              16,
+              14,
+              6,
+              12,
+              13,
+              2,
+              4
+            ]
+          },
+          "maxIdx": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Pagination offset from the previous page; initially 0."
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page size; omit to use the upstream default."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "keyword",
+          "scope"
+        ],
+        "description": "Parameters for search."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "sid": {
+            "type": "string",
+            "description": "Search session ID."
+          },
+          "hasMore": {
+            "type": "integer",
+            "description": "Whether another page exists: 1 means yes, 0 means no."
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "scope": {
+                  "type": "integer",
+                  "description": "Response group type; ebook groups can use 17."
+                },
+                "books": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "searchIdx": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "Pagination offset from the previous page; initially 0."
+                      },
+                      "bookInfo": {
+                        "type": "object",
+                        "properties": {
+                          "bookId": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "The book ID returned by search or the shelf."
+                          },
+                          "title": {
+                            "type": "string",
+                            "description": "Book title."
+                          },
+                          "author": {
+                            "type": "string",
+                            "description": "Book author."
+                          },
+                          "readerLink": {
+                            "type": "string",
+                            "description": "Use this upstream reader URL to open the book; do not construct a URL."
+                          },
+                          "deepLink": {
+                            "type": "string",
+                            "description": "Book details link; use when readerLink is absent."
+                          }
+                        },
+                        "additionalProperties": true,
+                        "description": "Book metadata, including any upstream links and additional fields."
+                      }
+                    },
+                    "additionalProperties": true,
+                    "description": "A search result."
+                  },
+                  "description": "Results in this group."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A search result group."
+            },
+            "description": "Result groups; do not filter groups by the requested scope."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Search response."
+      }
+    }
+  ]
+}