siyuan

Manage self-hosted SiYuan knowledge bases via API with curl and jq.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill siyuan-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/Signmanal/VIGIL/tree/main/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/Signmanal/VIGIL --skill siyuan-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually navigating the SiYuan UI to search, edit, and organize notes across a self-hosted knowledge base is slow and disruptive to workflows for security analysts, researchers, and productivity-focused users who need to access and update information quickly without context switching.

Core Features & Use Cases

  • Fast Note Search: Run full-text or SQL queries across all SiYuan blocks to instantly find relevant notes, IOCs, or research artifacts without manual browsing.
  • CRUD Operations: Create, update, and delete documents, blocks, and notebooks directly via the API to organize investigation findings, research notes, or personal knowledge base content.
  • Use Case: A security analyst investigating a phishing alert can use this skill to search SiYuan for related threat intelligence, append new findings to an existing investigation document, and tag blocks with custom priority attributes in seconds.

Quick Start

Use the siyuan skill to search your SiYuan knowledge base for all notes tagged with 'phishing' and append the top 3 most recent results to your active investigation document.

Frequently Asked Questions about siyuan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate SiYuan note management via API?

You can automate SiYuan note management by using curl and jq to send POST requests to the official SiYuan kernel API endpoints, executing full-text searches, SQL queries, and CRUD operations on blocks and documents.

How do I search a self-hosted SiYuan knowledge base for investigation notes?

To search a self-hosted SiYuan knowledge base, run full-text or SQL queries across all SiYuan blocks via the REST API to instantly find relevant notes, IOCs, or research artifacts without manual UI navigation.

Can I use curl to append new findings to an existing SiYuan document?

Yes, you can use curl to execute POST requests against SiYuan kernel API endpoints to append new findings to an existing document and update blocks directly for investigation tracking.

What do I need to run SQL queries against a SiYuan knowledge base?

To run SQL queries against a SiYuan knowledge base, you need a valid SiYuan API token and your instance URL to authenticate curl POST requests to the kernel API endpoints.

Is it possible to create and delete notebooks in SiYuan without opening the UI?

Yes, you can create, update, and delete notebooks, documents, and blocks directly via the SiYuan REST API using curl, eliminating the need to manually navigate the SiYuan UI.

Can I use this for security investigation note tracking in SiYuan?

Yes, this approach is designed for security investigation note tracking, allowing analysts to search for threat intelligence, append findings, and tag blocks with custom priority attributes in seconds.