getnote-search Skill

Prerequisites

• getnote

  CLI installed and authenticated (

  getnote auth status

  should show "Authenticated")

Commands

Search notes

getnote search <query> [--kb <topic_id>] [--limit <n>]

--kb

topic_id

--limit

note_id

title

content

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":"...","created_at":"...","note_type":"..."}]}

• Note:

  results

  is at the top level, not nested under

  data

  .
• Get

  topic_id

  for

  --kb

  from

  getnote kbs -o json

  →

  data.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.