rote-toolkit 0.3.4 → 0.4.0

package/README.md

@@ -1,7 +1,7 @@
-# Rote Toolkit
-
 <p align="right">English | <a href="./README.zh-CN.md">中文</a></p>
 
+# Rote Toolkit
+
 Rote Toolkit is a TypeScript toolkit for connecting to and extending your [Rote](https://rote.ink) note system from terminal workflows and AI agents. It uses the Rote OpenKey API for simple, reusable authentication.
 
 Main project repository: [`Rabithua/rote`](https://github.com/Rabithua/rote).
@@ -63,6 +63,12 @@ List recent notes (with archive/tag filters):
 rote list --limit 5 --archived -t "knowledge"
 ```
 
+List explore notes (no auth required):
+
+```bash
+rote explore --limit 5
+```
+
 ## MCP Usage
 
 ### Do I need pre-installation?
@@ -135,6 +141,7 @@ rote-mcp
 - `rote_delete_note`
 - `rote_search_notes`
 - `rote_list_notes`
+- `rote_explore_notes`
 
 ## Local Development
 

package/README.zh-CN.md

@@ -1,7 +1,7 @@
-# Rote Toolkit
-
 <p align="right"><a href="./README.md">English</a> | 中文</p>
 
+# Rote Toolkit
+
 Rote Toolkit 是一个基于 TypeScript 的增强工具包，主要用于在终端或 AI Agents 侧连接和增强你的 [Rote](https://rote.ink) 笔记系统。基于 Rote OpenKey API 授权，即插即用，无需繁复的登录流程。
 
 主项目仓库：[`Rabithua/rote`](https://github.com/Rabithua/rote)。
@@ -63,6 +63,12 @@ rote search "MCP"
 rote list --limit 5 --archived -t "知识管理"
 ```
 
+获取探索页面的笔记（无需配置 OpenKey）：
+
+```bash
+rote explore --limit 5
+```
+
 ## MCP 模式使用指南
 
 ### 是否需要提前安装？
@@ -135,6 +141,7 @@ rote-mcp
 - `rote_delete_note`
 - `rote_search_notes`
 - `rote_list_notes`
+- `rote_explore_notes`
 
 ## 本地开发
 

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import type { AddReactionInput, CreateArticleInput, CreateNoteInput, ListNotesInput, RemoveReactionInput, RemoveReactionResponse, RoteArticle, RoteNote, RotePermissions, RoteProfile, RoteReaction, SearchNotesInput, ToolkitConfig, UpdateNoteInput, UpdateProfileInput } from "./types.js";
+import type { AddReactionInput, CreateArticleInput, CreateNoteInput, ExploreNotesInput, ListNotesInput, RemoveReactionInput, RemoveReactionResponse, RoteArticle, RoteNote, RotePermissions, RoteProfile, RoteReaction, SearchNotesInput, ToolkitConfig, UpdateNoteInput, UpdateProfileInput } from "./types.js";
 export declare class RoteClient {
     private readonly apiUrl;
     private readonly openKey;
@@ -8,6 +8,7 @@ export declare class RoteClient {
     deleteNote(noteId: string): Promise<unknown>;
     searchNotes(input: SearchNotesInput): Promise<RoteNote[]>;
     listNotes(input?: ListNotesInput): Promise<RoteNote[]>;
+    exploreNotes(input?: ExploreNotesInput): Promise<RoteNote[]>;
     createArticle(input: CreateArticleInput): Promise<RoteArticle>;
     addReaction(input: AddReactionInput): Promise<RoteReaction>;
     removeReaction(input: RemoveReactionInput): Promise<RemoveReactionResponse>;

package/dist/api.js

@@ -111,6 +111,13 @@ export class RoteClient {
         }
         return this.request(`/v2/api/openkey/notes?${params.toString()}`);
     }
+    async exploreNotes(input = {}) {
+        const params = new URLSearchParams({
+            limit: String(input.limit ?? 20),
+            skip: String(input.skip ?? 0),
+        });
+        return this.request(`/v2/api/notes/public?${params.toString()}`);
+    }
     async createArticle(input) {
         if (!input.content?.trim()) {
             throw new Error("content is required");

package/dist/cli.js

@@ -159,6 +159,19 @@ program
     });
     printNotes(notes);
 });
+program
+    .command("explore")
+    .description("List explore notes (no authentication required)")
+    .option("-l, --limit <limit>", "max results", parseInt, 20)
+    .option("-s, --skip <skip>", "offset", parseInt, 0)
+    .action(async (options) => {
+    const client = new RoteClient();
+    const notes = await client.exploreNotes({
+        limit: options.limit,
+        skip: options.skip,
+    });
+    printNotes(notes);
+});
 program
     .command("mcp")
     .description("Start MCP server over stdio")

package/dist/mcp.js

@@ -271,6 +271,35 @@ export async function startMcpServer() {
             ],
         };
     });
+    server.registerTool("rote_explore_notes", {
+        description: "Get explore notes in Rote (no authentication required).",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Max results, default 20"),
+            skip: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Pagination offset, default 0"),
+        },
+    }, async ({ limit, skip }) => {
+        const notes = await client.exploreNotes({ limit, skip });
+        const lines = notes.map((note, i) => `${i + 1}. ${truncateSingleLine(note.content, 100)}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: lines.length > 0 ? lines.join("\n") : "No explore notes found.",
+                },
+            ],
+        };
+    });
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/types.d.ts

@@ -100,3 +100,7 @@ export interface ListNotesInput {
     archived?: boolean;
     tag?: string[];
 }
+export interface ExploreNotesInput {
+    limit?: number;
+    skip?: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rote-toolkit",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "CLI and MCP toolkit for Rote OpenKey API",
   "type": "module",
   "main": "dist/index.js",