siyuan

Perform CRUD operations on SiYuan knowledge base blocks via kernel API.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/founderphantom/zola-agent --skill siyuan-founderphantom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/founderphantom/zola-agent/tree/main/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/founderphantom/zola-agent --skill siyuan-founderphantom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide programmatic access to SiYuan's kernel API to search, read, create, update, and delete blocks and documents in a self-hosted knowledge base via curl.

Core Features & Use Cases

  • Full CRUD operations on blocks and documents, including search and path queries across notebooks
  • Workflow automation for personal knowledge management, note synchronization, and team collaboration across local or remote SiYuan instances
  • Use Case: batch update blocks, create documents from external data, and automate note ingestion across notebooks

Quick Start

Invoke a first curl command against your SiYuan instance using SIYUAN_TOKEN to list or create a 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 creation and management via API?

No, this skill is specifically designed for the SiYuan kernel API and uses curl commands with SIYUAN_TOKEN authentication to interact with self-hosted SiYuan knowledge bases, rather than general-purpose note-taking platforms.

What do I need to start making curl API calls to my SiYuan knowledge base?

The kernel API supports full CRUD operations on blocks and documents, enabling workflows for personal knowledge management, team note collaboration, and automated document lifecycle management across your notebooks.

Can I batch update blocks and search notes across notebooks using the SiYuan API?

You can automate note ingestion by sending curl requests to create documents from external data and batch update blocks, supporting automated synchronization and team collaboration across local or remote SiYuan instances.

Does this approach work for team collaboration and automated document lifecycle management?

The skill handles authentication via SIYUAN_TOKEN and supports endpoints for search, block operations, and file management, enabling full CRUD operations on documents and blocks within your self-hosted SiYuan knowledge base.