getnotes-cli 0.1.3__tar.gz → 0.1.5__tar.gz

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/CHANGELOG.md

@@ -5,6 +5,12 @@
 此文件的格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 并且本项目遵循 [语义化版本规范 (Semantic Versioning)](https://semver.org/spec/v2.0.0.html)。
 
+## [0.1.5] - 2026-02-28
+
+### 新增 (Added)
+- **笔记搜索功能**：新增 `search` CLI 命令，支持根据关键词搜索笔记，结果以 Rich 表格展示，支持分页浏览。
+- **MCP 搜索工具**：MCP 服务器新增 `search_notes(query)` 工具，允许 LLM 客户端直接搜索用户笔记并返回结构化结果。
+
 ## [0.1.3] - 2026-02-27
 
 ### 新增 (Added)

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getnotes-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: Get 笔记 CLI 下载工具 — 自动登录、批量下载、Markdown 导出
 Author: Han Zhang
 License: MIT
@@ -18,11 +18,11 @@ Description-Content-Type: text/markdown
 
 # getnotes-cli 🗂️
 
-> Get笔记 CLI 下载工具 — 自动登录、批量下载、知识库管理、Markdown 导出、录音图片等附件下载
->
+Get笔记 Cli 下载工具和 MCP 集成，支持自动登录、批量下载、知识库管理、笔记搜索、Markdown 导出、录音图片等附件下载。
+
 > **初衷与设计理念：**
+> - 🤖 **Agent 工作流**：提供标准化的 CLI 和 MCP 接入，便于无缝嵌入到各类大模型 Agent 或自动化流程中，充当高质量的个人知识上下文。
 > - 📦 **数据自有化**：将你在平台积攒的笔记、知识库等数字资产完整下载到本地，实现数据的真正自有化与安全备份。
-> - 🤖 **Agent 工作流**：提供标准化的 CLI 和本地文件系统接口，便于无缝嵌入到各类大模型 Agent 或自动化流程中，充当高质量的个人知识上下文。
 
 [![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
@@ -32,7 +32,8 @@ Description-Content-Type: text/markdown
 - 🔐 **自动登录** — 通过 Chrome DevTools Protocol 自动获取 Bearer token，无需手动抓包
 - 📥 **批量下载** — 分页拉取全部笔记，支持指定数量
 - 📤 **新建笔记** — 支持通过本地 Markdown 或文本文件创建笔记，并支持自动上传内嵌图片
-- 📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
+- � **笔记搜索** — 根据关键词搜索笔记，支持分页浏览
+- �📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
 - 📝 **Markdown 导出** — 每条笔记保存为 Markdown，包含元信息、标签、正文、引用内容
 - 🔊 **附件下载** — 自动下载音频、图片附件，并在 Markdown 中内嵌链接
 - 💾 **缓存管理** — 自动跳过已下载且未变化的笔记，支持增量更新
@@ -41,7 +42,43 @@ Description-Content-Type: text/markdown
 - ⏱️ **可配置间隔** — 自定义请求间隔，避免频率限制
 - 📊 **自动索引** — 自动生成笔记索引文件 `INDEX.md`
 
-## 📦 安装
+## 🤖 MCP 服务器
+
+Get笔记 CLI 提供原生的 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器支持，允许集成 [Claude Desktop](https://claude.ai/download) 等 AI 客户端直接为你管理笔记和知识库。
+
+### 配置 Claude Desktop
+
+编辑 Claude Desktop 配置文件 `claude_desktop_config.json`（通常在 `~/Library/Application Support/Claude/`）：
+
+```json
+{
+  "mcpServers": {
+    "getnotes": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "getnotes-cli",
+        "getnotes-mcp"
+      ]
+    }
+  }
+}
+```
+
+> **注意**：在使用 MCP 服务器前，确保你在终端执行过 `getnotes login` 获取了 Token。
+
+### 可用 MCP Tools
+
+- `download_notes(limit=10)`: 下载近期笔记为 Markdown 文件。
+- `create_note(content)`: 直接提交文本建立新笔记。
+- `create_link_note(url)`: 通过 AI 解析链接创建深度笔记。
+- `search_notes(query)`: 根据关键词搜索笔记并返回匹配结果。
+- `list_notebooks()`: 获取你创建的知识库列表及对应 ID。
+- `download_notebook(notebook_id)`: 下载指定的知识库内容。
+- `list_subscribed_notebooks()`: 获取订阅知识库列表。
+- `download_subscribed_notebook(notebook_id)`: 下载指定的订阅知识库。
+
+## 📦 Cli 安装
 
 ### 使用 uv 安装（推荐）
 
@@ -93,6 +130,19 @@ getnotes create -f my_note.md -i img1.png -i img2.jpg
 getnotes create-link <url>
 ```
 
+### 搜索笔记
+
+```bash
+# 根据关键词搜索笔记
+getnotes search "AI 提效"
+
+# 查看第 2 页结果
+getnotes search "AI 提效" --page 2
+
+# 自定义每页数量
+getnotes search "AI 提效" --page-size 20
+```
+
 ### 下载笔记
 
 ```bash
@@ -217,46 +267,12 @@ getnotes --version
 getnotes --help
 getnotes create --help
 getnotes download --help
+getnotes search --help
 getnotes notebook --help
 getnotes subscribe --help
 getnotes config --help
 ```
 
-## 🤖 MCP 服务器
-
-Get笔记 CLI 提供原生的 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器支持，允许集成 [Claude Desktop](https://claude.ai/download) 等 AI 客户端直接为你管理笔记和知识库。
-
-### 配置 Claude Desktop
-
-编辑 Claude Desktop 配置文件 `claude_desktop_config.json`（通常在 `~/Library/Application Support/Claude/`）：
-
-```json
-{
-  "mcpServers": {
-    "getnotes": {
-      "command": "uv",
-      "args": [
-        "tool",
-        "run",
-        "getnotes-mcp"
-      ]
-    }
-  }
-}
-```
-
-> **注意**：在使用 MCP 服务器前，确保你在终端执行过 `getnotes login` 获取了 Token。
-
-### 可用 MCP Tools
-
-- `download_notes(limit=10)`: 下载近期笔记为 Markdown 文件。
-- `create_note(content)`: 直接提交文本建立新笔记。
-- `create_link_note(url)`: 通过 AI 解析链接创建深度笔记。
-- `list_notebooks()`: 获取你创建的知识库列表及对应 ID。
-- `download_notebook(notebook_id)`: 下载指定的知识库内容。
-- `list_subscribed_notebooks()`: 获取订阅知识库列表。
-- `download_subscribed_notebook(notebook_id)`: 下载指定的订阅知识库。
-
 ## 📁 输出目录结构
 
 默认输出到 `~/Downloads/getnotes_export/`：

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/README.md

@@ -1,10 +1,10 @@
 # getnotes-cli 🗂️
 
-> Get笔记 CLI 下载工具 — 自动登录、批量下载、知识库管理、Markdown 导出、录音图片等附件下载
->
+Get笔记 Cli 下载工具和 MCP 集成，支持自动登录、批量下载、知识库管理、笔记搜索、Markdown 导出、录音图片等附件下载。
+
 > **初衷与设计理念：**
+> - 🤖 **Agent 工作流**：提供标准化的 CLI 和 MCP 接入，便于无缝嵌入到各类大模型 Agent 或自动化流程中，充当高质量的个人知识上下文。
 > - 📦 **数据自有化**：将你在平台积攒的笔记、知识库等数字资产完整下载到本地，实现数据的真正自有化与安全备份。
-> - 🤖 **Agent 工作流**：提供标准化的 CLI 和本地文件系统接口，便于无缝嵌入到各类大模型 Agent 或自动化流程中，充当高质量的个人知识上下文。
 
 [![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
@@ -14,7 +14,8 @@
 - 🔐 **自动登录** — 通过 Chrome DevTools Protocol 自动获取 Bearer token，无需手动抓包
 - 📥 **批量下载** — 分页拉取全部笔记，支持指定数量
 - 📤 **新建笔记** — 支持通过本地 Markdown 或文本文件创建笔记，并支持自动上传内嵌图片
-- 📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
+- � **笔记搜索** — 根据关键词搜索笔记，支持分页浏览
+- �📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
 - 📝 **Markdown 导出** — 每条笔记保存为 Markdown，包含元信息、标签、正文、引用内容
 - 🔊 **附件下载** — 自动下载音频、图片附件，并在 Markdown 中内嵌链接
 - 💾 **缓存管理** — 自动跳过已下载且未变化的笔记，支持增量更新
@@ -23,7 +24,43 @@
 - ⏱️ **可配置间隔** — 自定义请求间隔，避免频率限制
 - 📊 **自动索引** — 自动生成笔记索引文件 `INDEX.md`
 
-## 📦 安装
+## 🤖 MCP 服务器
+
+Get笔记 CLI 提供原生的 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器支持，允许集成 [Claude Desktop](https://claude.ai/download) 等 AI 客户端直接为你管理笔记和知识库。
+
+### 配置 Claude Desktop
+
+编辑 Claude Desktop 配置文件 `claude_desktop_config.json`（通常在 `~/Library/Application Support/Claude/`）：
+
+```json
+{
+  "mcpServers": {
+    "getnotes": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "getnotes-cli",
+        "getnotes-mcp"
+      ]
+    }
+  }
+}
+```
+
+> **注意**：在使用 MCP 服务器前，确保你在终端执行过 `getnotes login` 获取了 Token。
+
+### 可用 MCP Tools
+
+- `download_notes(limit=10)`: 下载近期笔记为 Markdown 文件。
+- `create_note(content)`: 直接提交文本建立新笔记。
+- `create_link_note(url)`: 通过 AI 解析链接创建深度笔记。
+- `search_notes(query)`: 根据关键词搜索笔记并返回匹配结果。
+- `list_notebooks()`: 获取你创建的知识库列表及对应 ID。
+- `download_notebook(notebook_id)`: 下载指定的知识库内容。
+- `list_subscribed_notebooks()`: 获取订阅知识库列表。
+- `download_subscribed_notebook(notebook_id)`: 下载指定的订阅知识库。
+
+## 📦 Cli 安装
 
 ### 使用 uv 安装（推荐）
 
@@ -75,6 +112,19 @@ getnotes create -f my_note.md -i img1.png -i img2.jpg
 getnotes create-link <url>
 ```
 
+### 搜索笔记
+
+```bash
+# 根据关键词搜索笔记
+getnotes search "AI 提效"
+
+# 查看第 2 页结果
+getnotes search "AI 提效" --page 2
+
+# 自定义每页数量
+getnotes search "AI 提效" --page-size 20
+```
+
 ### 下载笔记
 
 ```bash
@@ -199,46 +249,12 @@ getnotes --version
 getnotes --help
 getnotes create --help
 getnotes download --help
+getnotes search --help
 getnotes notebook --help
 getnotes subscribe --help
 getnotes config --help
 ```
 
-## 🤖 MCP 服务器
-
-Get笔记 CLI 提供原生的 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器支持，允许集成 [Claude Desktop](https://claude.ai/download) 等 AI 客户端直接为你管理笔记和知识库。
-
-### 配置 Claude Desktop
-
-编辑 Claude Desktop 配置文件 `claude_desktop_config.json`（通常在 `~/Library/Application Support/Claude/`）：
-
-```json
-{
-  "mcpServers": {
-    "getnotes": {
-      "command": "uv",
-      "args": [
-        "tool",
-        "run",
-        "getnotes-mcp"
-      ]
-    }
-  }
-}
-```
-
-> **注意**：在使用 MCP 服务器前，确保你在终端执行过 `getnotes login` 获取了 Token。
-
-### 可用 MCP Tools
-
-- `download_notes(limit=10)`: 下载近期笔记为 Markdown 文件。
-- `create_note(content)`: 直接提交文本建立新笔记。
-- `create_link_note(url)`: 通过 AI 解析链接创建深度笔记。
-- `list_notebooks()`: 获取你创建的知识库列表及对应 ID。
-- `download_notebook(notebook_id)`: 下载指定的知识库内容。
-- `list_subscribed_notebooks()`: 获取订阅知识库列表。
-- `download_subscribed_notebook(notebook_id)`: 下载指定的订阅知识库。
-
 ## 📁 输出目录结构
 
 默认输出到 `~/Downloads/getnotes_export/`：

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getnotes-cli"
-version = "0.1.3"
+version = "0.1.5"
 description = "Get 笔记 CLI 下载工具 — 自动登录、批量下载、Markdown 导出"
 readme = "README.md"
 license = {text = "MIT"}

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/src/getnotes_cli/cli.py

@@ -175,6 +175,96 @@ def create_link(
         raise typer.Exit(1)
 
 
+# ========================================================================
+# search 命令
+# ========================================================================
+
+
+@app.command()
+def search(
+    query: str = typer.Argument(
+        ...,
+        help="搜索关键词",
+    ),
+    page: int = typer.Option(
+        1, "--page", "-p",
+        help="页码（从 1 开始）",
+    ),
+    page_size: int = typer.Option(
+        10, "--page-size", "-s",
+        help="每页数量（默认 10）",
+    ),
+    token: Optional[str] = typer.Option(
+        None, "--token", "-t",
+        help="直接传入 Bearer token（跳过缓存检查）",
+    ),
+) -> None:
+    """🔍 搜索笔记 — 根据关键词搜索相关笔记"""
+    from getnotes_cli.searcher import NoteSearcher
+
+    auth = _get_auth(token)
+
+    console.print(f"\n[bold]🔍 正在搜索: {query}[/bold]\n")
+
+    try:
+        searcher = NoteSearcher(auth)
+        result = searcher.search(query, page=page, page_size=page_size)
+    except Exception as e:
+        console.print(f"[red]✗[/red] 搜索失败: {e}")
+        raise typer.Exit(1)
+
+    items = result["items"]
+    total = result["total"]
+    has_more = result["has_more"]
+
+    if not items:
+        console.print("[dim]未找到相关笔记。[/dim]")
+        return
+
+    table = Table(title=f"搜索结果 — '{query}' （共 {total} 条，第 {page} 页）")
+    table.add_column("#", style="dim", width=4)
+    table.add_column("标题 / 摘要", style="cyan", max_width=50)
+    table.add_column("类型", style="yellow", width=8)
+    table.add_column("标签", style="green", max_width=20)
+    table.add_column("创建时间", style="dim", width=12)
+
+    for i, item in enumerate(items, (page - 1) * page_size + 1):
+        title = NoteSearcher.strip_highlight(item.get("title", "").strip())
+        note_type = item.get("note_type", "")
+
+        # 获取高亮摘要
+        highlight = item.get("highlight_info", {})
+        snippet = ""
+        for key in ("title", "content", "ref_content"):
+            parts = highlight.get(key, [])
+            text = next((p for p in parts if p.strip()), "")
+            if text:
+                snippet = NoteSearcher.extract_highlight(text)
+                break
+
+        display = title if title else (snippet[:40] + "..." if len(snippet) > 40 else snippet)
+        if not display:
+            display = f"(ID: {item.get('note_id', '?')[-8:]})"
+
+        tags = ", ".join(
+            NoteSearcher.strip_highlight(t.get("name", "")) for t in item.get("tags", [])
+            if t.get("type") != "system"
+        )
+        if len(tags) > 20:
+            tags = tags[:18] + "…"
+
+        created = item.get("created_at", "")[:10]
+
+        table.add_row(str(i), display, note_type, tags, created)
+
+    console.print(table)
+
+    if has_more:
+        next_page = page + 1
+        console.print(f"\n[dim]还有更多结果，使用 `getnotes search \"{query}\" --page {next_page}` 查看下一页[/dim]")
+    console.print(f"[dim]共 {total} 条匹配结果[/dim]")
+
+
 
 # ========================================================================
 # download 命令

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/src/getnotes_cli/config.py

@@ -18,6 +18,9 @@ NOTE_CREATE_API_URL = "https://get-notes.luojilab.com/voicenotes/web/notes"
 # 通过链接创建笔记流式 API
 LINK_NOTE_CREATE_API_URL = "https://get-notes.luojilab.com/voicenotes/web/notes/stream"
 
+# 搜索笔记 API
+SEARCH_API_URL = "https://get-notes.luojilab.com/voicenotes/web/notes/search"
+
 # 获取图片上传 Token API
 IMAGE_TOKEN_API_URL = "https://get-notes.luojilab.com/voicenotes/web/token/image"
 

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/src/getnotes_cli/mcp/server.py

@@ -20,6 +20,7 @@ Tools available:
 - download_notes(limit=10): Download recent notes as Markdown
 - create_note(content): Create a new note from text content
 - create_link_note(url): Use AI to create a deep note from a link URL
+- search_notes(query): Search notes by keyword and return matching results
 - list_notebooks(): Get a list of the user's notebooks
 - download_notebook(notebook_id): Download a specific notebook
 

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/src/getnotes_cli/mcp/tools/notes.py

@@ -7,9 +7,10 @@ from getnotes_cli.auth import get_or_refresh_token
 from getnotes_cli.config import DEFAULT_OUTPUT_DIR
 from getnotes_cli.creator import NoteCreator
 from getnotes_cli.downloader import NoteDownloader
+from getnotes_cli.searcher import NoteSearcher
 
 # We will export the functions that should be registered
-__all__ = ["download_notes", "create_note", "create_link_note"]
+__all__ = ["download_notes", "create_note", "create_link_note", "search_notes"]
 
 def download_notes(limit: int = 10, force: bool = False) -> str:
     """Download the most recent notes to the default output directory.
@@ -107,3 +108,71 @@ def create_link_note(url: str) -> str:
             
     except Exception as e:
         return f"Error creating note from link: {e}"
+
+def search_notes(query: str, page: int = 1, page_size: int = 10) -> str:
+    """Search for notes by keyword and return matching results.
+    
+    Args:
+        query: The search keyword or phrase to find relevant notes.
+        page: Page number (starting from 1, default: 1).
+        page_size: Number of results per page (default: 10).
+        
+    Returns:
+        A formatted string with matching notes including titles, types, tags, and snippets.
+    """
+    try:
+        auth = get_or_refresh_token()
+    except Exception as e:
+        return f"Error: Authentication failed. Please run 'getnotes login' in your terminal. ({e})"
+        
+    searcher = NoteSearcher(auth)
+    
+    try:
+        result = searcher.search(query, page=page, page_size=page_size)
+    except Exception as e:
+        return f"Error searching notes: {e}"
+    
+    items = result["items"]
+    total = result["total"]
+    has_more = result["has_more"]
+    
+    if not items:
+        return f"No notes found matching '{query}'."
+    
+    lines = [f"Found {total} notes matching '{query}' (page {page}):"]
+    lines.append("")
+    
+    for i, item in enumerate(items, (page - 1) * page_size + 1):
+        title = NoteSearcher.strip_highlight(item.get("title", "").strip())
+        note_type = item.get("note_type", "")
+        note_id = item.get("note_id", "")
+        created = item.get("created_at", "")
+        
+        # Get highlight snippet
+        highlight = item.get("highlight_info", {})
+        snippet = ""
+        for key in ("title", "content", "ref_content"):
+            parts = highlight.get(key, [])
+            text = next((p for p in parts if p.strip()), "")
+            if text:
+                snippet = NoteSearcher.extract_highlight(text)
+                break
+        
+        display = title or snippet[:60] or f"(Note {note_id[-8:]})"
+        tags = ", ".join(
+            NoteSearcher.strip_highlight(t.get("name", "")) for t in item.get("tags", [])
+            if t.get("type") != "system"
+        )
+        
+        lines.append(f"{i}. [{note_type}] {display}")
+        if tags:
+            lines.append(f"   Tags: {tags}")
+        if snippet and title:
+            lines.append(f"   Snippet: {snippet}")
+        lines.append(f"   ID: {note_id} | Created: {created}")
+        lines.append("")
+    
+    if has_more:
+        lines.append(f"(More results available — use page={page + 1} to see next page)")
+    
+    return "\n".join(lines)

getnotes_cli-0.1.5/src/getnotes_cli/searcher.py

@@ -0,0 +1,70 @@
+"""笔记搜索 — 根据关键词搜索笔记"""
+
+import re
+
+import httpx
+
+from getnotes_cli.auth import AuthToken
+from getnotes_cli.config import SEARCH_API_URL
+
+
+class NoteSearcher:
+    """笔记搜索器"""
+
+    def __init__(self, token: AuthToken):
+        self.token = token
+        self.client = httpx.Client(timeout=30)
+
+    def search(
+        self,
+        query: str,
+        page: int = 1,
+        page_size: int = 10,
+    ) -> dict:
+        """搜索笔记
+
+        Args:
+            query: 搜索关键词
+            page: 页码（从 1 开始）
+            page_size: 每页数量
+
+        Returns:
+            包含 items, total, has_more 的字典
+        """
+        params = {
+            "page": page,
+            "page_size": page_size,
+            "query": query,
+        }
+        headers = self.token.get_headers()
+        resp = self.client.get(
+            SEARCH_API_URL,
+            headers=headers,
+            params=params,
+            timeout=30,
+        )
+        resp.raise_for_status()
+        data = resp.json()
+
+        content = data.get("c", {})
+        return {
+            "items": content.get("items", []),
+            "total": content.get("total", 0),
+            "has_more": content.get("has_more", False),
+        }
+
+    @staticmethod
+    def strip_highlight(text: str) -> str:
+        """移除高亮标签 <hl>...</hl>，保留内部文本"""
+        return re.sub(r"</?hl>", "", text)
+
+    @staticmethod
+    def extract_highlight(text: str) -> str:
+        """提取高亮文本片段，用于展示"""
+        text = text.replace("\\n", "\n").strip()
+        # 移除 hl 标签
+        clean = re.sub(r"</?hl>", "", text)
+        # 截断过长内容
+        if len(clean) > 120:
+            clean = clean[:120] + "..."
+        return clean

{getnotes_cli-0.1.3 → getnotes_cli-0.1.5}/uv.lock

@@ -476,7 +476,7 @@ wheels = [
 
 [[package]]
 name = "getnotes-cli"
-version = "0.1.2"
+version = "0.1.4"
 source = { editable = "." }
 dependencies = [
     { name = "fastmcp" },