siyuan

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

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/Monjyu1101/AiDiy2026 --skill siyuan-monjyu1101
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/Monjyu1101/AiDiy2026/tree/main/backend_hermes/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/Monjyu1101/AiDiy2026 --skill siyuan-monjyu1101

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use the SiYuan kernel API via curl to search, read, create, update, and delete blocks and documents in a self-hosted knowledge base. No extra GUI tools needed.

Core Features & Use Cases

  • Full-text search and retrieval of blocks and documents
  • Read, create, update, and rename blocks and documents, including notebooks
  • Append blocks, export content as Markdown, and manage basic attributes
  • Ideal for automation scripts, batch processing, and knowledge-base maintenance on a self-hosted SiYuan instance

Quick Start

Set up your SiYuan API token and URL, then issue a curl command to search, read, create, update, or delete 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 manage SiYuan knowledge-base blocks using curl?

You can manage SiYuan knowledge-base blocks using curl by sending POST requests to the kernel API. This enables searching, reading, creating, updating, and deleting blocks and documents programmatically without extra GUI tools.

What do I need to automate SiYuan note management via the kernel API?

To automate SiYuan note management via the kernel API, you need a running self-hosted SiYuan instance, the SiYuan API URL, and a valid API token. You then issue curl POST commands to interact with your knowledge base.

Can I export content as Markdown from a self-hosted SiYuan instance using curl?

Yes, you can export content as Markdown from a self-hosted SiYuan instance using curl. By calling the kernel API, you can retrieve and export blocks and documents programmatically for your automation scripts.

Does the SiYuan kernel API support GET requests for searching and reading blocks?

No, the SiYuan kernel API uses only POST-based endpoints for searching and reading blocks. You must configure your curl commands to send POST requests with the required API token to interact with the knowledge base.

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

The limitations of using curl to manage blocks in a SiYuan knowledge base include relying exclusively on POST-based endpoints and requiring a running SiYuan instance with a valid API token to execute any search, read, or delete operations.