getnote-kb Skill

Prerequisites

• getnote

  CLI installed and authenticated (

  getnote auth status

  should show "Authenticated")

Commands

List all knowledge bases

getnote kbs

topic_id

name

description

note_count

created_at

getnote kbs
getnote kbs -o json

List subscribed knowledge bases

getnote kbs-sub [--page <n>]

--page

getnote kbs-sub
getnote kbs-sub --page 2
getnote kbs-sub -o json

Use

getnote kb <topic_id>

to browse notes inside a subscribed knowledge base.

List notes in a knowledge base

getnote kb <topic_id> [--limit <n>] [--all]

--limit

--all

getnote kb vnrOAaGY
getnote kb vnrOAaGY --all
getnote kb vnrOAaGY -o json

Create a knowledge base

getnote kb create <name> [--desc <description>]

getnote kb create "Research Papers"
getnote kb create "Project Docs" --desc "Documentation links"

Max 50 knowledge bases per day (resets at 00:00 Beijing time).

Add notes to a knowledge base

getnote kb add <topic_id> <note_id> [note_id...]

getnote kb add vnrOAaGY 1234567890
getnote kb add vnrOAaGY 1234567890 9876543210

Already-existing notes are silently skipped.

Remove notes from a knowledge base

getnote kb remove <topic_id> <note_id> [note_id...]

getnote kb remove vnrOAaGY 1234567890

⚠️ 订阅知识库限制：如果目标知识库是他人创建（通过

getnote kbs-sub

获取），且用户不是该知识库的管理员，则无法添加或移除笔记，API 会返回错误。只有自己创建的知识库（

getnote kbs

）才支持完整的增删操作。

List bloggers in a knowledge base

getnote kb bloggers <topic_id> [--page <n>]

follow_id

account_name

platform

follow_time

getnote kb bloggers vnrOAaGY
getnote kb bloggers vnrOAaGY --page 2 -o json

List blogger contents

getnote kb blogger-contents <topic_id> <follow_id> [--page <n>]

post_id_alias

getnote kb blogger-contents vnrOAaGY follow123
getnote kb blogger-contents vnrOAaGY follow123 --page 2

Show blogger content detail

getnote kb blogger-content <topic_id> <post_id>

post_media_text

getnote kb blogger-content vnrOAaGY post_abc123
getnote kb blogger-content vnrOAaGY post_abc123 -o json

List completed lives in a knowledge base

getnote kb lives <topic_id> [--page <n>]

getnote kb lives vnrOAaGY
getnote kb lives vnrOAaGY --page 2

Show live detail

getnote kb live <topic_id> <live_id>

post_summary

post_media_text

getnote kb live vnrOAaGY live_abc123
getnote kb live vnrOAaGY live_abc123 -o json

Show API quota usage

getnote quota

getnote quota
getnote quota -o json

Agent Usage Notes

• Use

  -o json

  when parsing results programmatically.

• kbs -o json

  returns

  {"success":true,"data":{"topics":[...],"total":N}}

• kbs-sub -o json

  returns the same shape as

  kbs -o json

  .

• kb <topic_id> -o json

  returns

  {"success":true,"data":{"notes":[...],"has_more":...}}

• Get

  topic_id

  from

  getnote kbs -o json

  or

  getnote kbs-sub -o json

  →

  data.topics[].topic_id

  field (not

  id

  ).

• kb add

  /

  kb remove

  accept multiple note IDs — prefer batching over multiple calls.
• Subscribed KBs are read-only unless the user is an admin of that KB.

  kb add

  /

  kb remove

  will return an API error on subscribed KBs owned by others. Use

  getnote kbs

  (owned) vs

  getnote kbs-sub

  (subscribed) to distinguish.

• kb bloggers

  → get

  follow_id

  →

  kb blogger-contents

  → get

  post_id_alias

  →

  kb blogger-content

  for full text.

• kb lives

  → get

  live_id

  →

  kb live

  for AI summary + transcript.

• quota -o json

  returns

  {"success":true,"data":{"read":{"daily":{limit,used,remaining,reset_at},"monthly":{...}},"write":{...},"write_note":{...}}}

• Exit code

  0

  = success; non-zero = error. Error details go to stderr.