PluginBench
Skill
Pass
Audit score 90

getnote-search

iswalle/getnote-cli

How to install getnote-search

npx skills add https://github.com/iswalle/getnote-cli --skill getnote-search
Claude Code
Cursor
Windsurf
Cline
Full instructions (SKILL.md)

Source of truth, from iswalle/getnote-cli.


name: getnote-search version: 0.4.0 description: Semantic search across notes in Get笔记 via the getnote CLI

getnote-search Skill

Semantic search across all notes or within a specific knowledge base.

Prerequisites

  • getnote CLI installed and authenticated (getnote auth status should show "Authenticated")

Commands

Search notes

getnote search <query> [--kb <topic_id>] [--limit <n>]
FlagDefaultDescription
--kbLimit search to a knowledge base (topic_id)
--limit10Max results (max 10)

Results are ranked by semantic relevance (high → low). Each result includes: note_id, title, content (excerpt), score, created_at, note_type.

Note: note_id is only populated for NOTE type results. Other types (FILE, BLOGGER, LIVE, etc.) return an empty note_id.

# Search across all notes
getnote search "大模型 API"

# Search within a knowledge base
getnote search "RAG" --kb qnNX75j0

# Limit results + JSON output
getnote search "机器学习" --limit 5 -o json

Agent Usage Notes

  • Use -o json when parsing results programmatically.
  • JSON response: {"success":true,"results":[{"note_id":"...","title":"...","content":"...","score":0.95,"created_at":"...","note_type":"..."}]}
  • Note: results is at the top level, not nested under data.
  • Get topic_id for --kb from getnote kbs -o jsondata.topics[].topic_id.
  • For NOTE type results, use getnote note <note_id> to get the full content.
  • Max --limit is 10; use getnote notes for browsing without a query.
  • Exit code 0 = success; non-zero = error. Error details go to stderr.