siyuan

Manage SiYuan Note blocks and documents via kernel API requests.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This Skill solves the friction of manually interacting with a self-hosted SiYuan knowledge base by providing a direct interface to perform CRUD operations on blocks and documents via the kernel API.

Core Features & Use Cases

  • Automated Knowledge Management: Programmatically search, create, update, and delete notes or blocks without opening the desktop application.
  • Data Integration: Sync external data or AI-generated content directly into your personal knowledge base using SQL queries or block manipulation.
  • Use Case: Automatically append daily meeting summaries or research notes into specific notebooks based on tags or project names.

Quick Start

Use the siyuan skill to search for all blocks containing the keyword project and return the top five 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 note management without opening the desktop app?

You can automate SiYuan note management by sending authenticated POST requests directly to the SiYuan kernel API. This allows programmatic CRUD operations on blocks and documents, enabling automated knowledge base updates without manual interaction.

Can I run full-text search and SQL queries against my self-hosted SiYuan knowledge base?

Yes, you can execute full-text search and SQL-based data retrieval against a self-hosted SiYuan knowledge base. The API interface queries blocks and documents directly, returning structured results for external data integration and automated content extraction.

Do I need curl and jq to interact with the SiYuan API?

Yes, curl and jq are required dependencies to interact with the SiYuan API. Curl handles sending authenticated POST requests to the kernel API, while jq parses the JSON responses returned from full-text searches and SQL queries.

What is the best way to sync AI-generated content into my personal knowledge base?

The best way to sync AI-generated content into a personal knowledge base is using block manipulation via the SiYuan API. You can programmatically append summaries or research notes into specific notebooks based on tags or project names automatically.

Does the SiYuan API support remote instances or only local knowledge bases?

The SiYuan API supports both local and remote instances. You can execute authenticated POST requests against a remote SiYuan instance to manage blocks and documents, enabling automated knowledge management across self-hosted deployments.

Why use SQL queries for knowledge management instead of standard full-text search?

SQL queries offer structured data retrieval for knowledge management beyond standard full-text search. By querying the SiYuan kernel API with SQL, you can filter and integrate specific blocks or documents into external systems for automated data synchronization.