siyuan

Manage SiYuan blocks and documents via the kernel API using curl.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill siyuan-yangel-hide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/Yangel-hide/video-production-planner-agent/tree/main/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill siyuan-yangel-hide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Programmers and knowledge managers often struggle with manual interactions with a self-hosted SiYuan knowledge base. This skill provides programmatic access to the SiYuan kernel API via curl, enabling automated management of blocks and documents.

Core Features & Use Cases

  • Full API operations: search, read, create, update, and delete blocks and documents through curl requests.
  • Self-hosted PKM automation: manage notes in a local SiYuan instance with API tokens.
  • Use case: automatically create daily notes, search across notes, and bulk update blocks.

Quick Start

Configure your environment with SIYUAN_TOKEN and SIYUAN_URL, then use the API to create or read blocks and documents.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I automate creating notes and searching blocks in a self-hosted SiYuan knowledge base?

Configure your environment with SIYUAN_TOKEN and SIYUAN_URL, then send curl requests with JSON payloads to the SiYuan kernel API endpoints. This enables programmatic search, creation, and management of blocks and documents.

What do I need to interact with the SiYuan kernel API using curl?

To interact with the SiYuan kernel API using curl, you need a SiYuan API token set as SIYUAN_TOKEN and a base URL set as SIYUAN_URL. These authenticate your curl requests to the self-hosted instance.

Can I bulk update blocks and documents in my SiYuan note system via API?

Yes, you can bulk update blocks and documents in your SiYuan note system via API. By sending curl requests with specific JSON payloads to the kernel endpoints, you can programmatically update and manage multiple blocks.

How does programmatic access to a SiYuan knowledge base work?

Programmatic access to a SiYuan knowledge base works by using curl to send JSON payloads to the kernel API endpoints. This bypasses the UI to directly search, read, create, update, and delete blocks and documents.

What are the limitations of using curl to manage a SiYuan knowledge base?

Using curl to manage a SiYuan knowledge base requires constructing raw JSON payloads for each request and depends on a self-hosted instance. It lacks a graphical interface, meaning users must manually parse API responses.