getnote-search

Name: getnote-search
Author: iswalle

Semantic search across notes in Get笔记 via the getnote CLI

INSTALLATION

npx skills add https://github.com/iswalle/getnote-cli --skill getnote-search

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

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>]

Flag

Default

Description

--kb

—

Limit search to a knowledge base (topic_id)

--limit

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