siyuan

Perform CRUD operations on SiYuan Note blocks and documents via its kernel API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This Skill removes the friction of manually navigating your knowledge base by providing a direct interface to search, create, and manage your notes and blocks programmatically.

Core Features & Use Cases

  • Automated Knowledge Management: Perform full-text searches, SQL queries, and block manipulations across your entire SiYuan instance.
  • Content Lifecycle: Create, update, rename, and delete documents or blocks without leaving your terminal or agent interface.
  • Use Case: Automatically append meeting notes to a specific daily document or query your database for all blocks tagged with a specific project name to generate a summary report.

Quick Start

Use the siyuan skill to search for all blocks containing the phrase project roadmap and return the results.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I automate SiYuan knowledge base management via API?

Automate SiYuan knowledge base management via API by using an interface to perform CRUD operations on blocks and documents, enabling programmatic content organization without manual navigation.

Can I run SQL queries to retrieve information from SiYuan notes?

Yes, you can run SQL queries to retrieve information from SiYuan notes by interacting with the SiYuan Note kernel API, facilitating complex information retrieval across your entire instance.

What do I need to connect to a local or remote SiYuan instance?

To connect to a local or remote SiYuan instance, you need a valid SiYuan API token, network access, and command-line dependencies like curl and jq to handle API requests and JSON parsing.

Does the SiYuan API interface support full-text search across documents?

Yes, the SiYuan API interface supports full-text search across documents, allowing you to query your entire knowledge base for specific phrases and return matching blocks programmatically.

How to programmatically append content to a daily document in SiYuan?

Programmatically append content to a daily document in SiYuan by utilizing block manipulation operations through the kernel API, allowing automated updates to specific blocks or documents.

What are the limitations of using curl and jq for SiYuan API automation?

Limitations of using curl and jq for SiYuan API automation include reliance on manual JSON parsing and network stability, as the interface requires direct API token authentication and valid network access to function.