siyuan

Search and manipulate SiYuan blocks and documents via the kernel API using curl.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SiYuan Note API provides programmatic access to search, read, create, update, and manage blocks and documents in a self-hosted SiYuan knowledge base via curl, reducing manual interactions and enabling automation.

Core Features & Use Cases

  • API-driven knowledge base management: search, read, create, update, and delete blocks and documents in SiYuan.
  • Automated workflows: integrate with CI/CD or local scripts to maintain notes and documentation.
  • Use Case: Automatically create and update notes across notebooks based on events and tasks.

Quick Start

Authenticate with your SiYuan token and run a curl command to read or modify blocks.

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 the API?

Manage SiYuan knowledge base blocks via API by sending curl requests to kernel endpoints for searching, reading, creating, updating, and deleting block data. It requires configuring the base URL, authentication token, and curl environment variables.

Can I automate note creation in SiYuan with curl?

Automate note creation in SiYuan with curl by sending POST requests to kernel API endpoints. This enables automated workflows and CI/CD integration to create or update documents across notebooks based on external events.

What do I need to access the SiYuan kernel API remotely?

Accessing the SiYuan kernel API remotely requires a valid SiYuan authentication token, the base URL of the local or remote instance, and curl installed to execute the read, update, and delete block operations.

Does the SiYuan API support searching for specific blocks?

The SiYuan API supports searching for specific blocks and documents through kernel API endpoints. Query the knowledge base using curl commands to retrieve targeted block data without manual interface interaction.

How to update existing documents in a SiYuan notebook via API?

Update existing documents in a SiYuan notebook via API by sending curl requests to the appropriate kernel endpoints. Modify block content programmatically by providing the block ID and new data payload through the configured base URL and token.