siyuan

Manage SiYuan blocks and documents via curl requests to the kernel API.

150|25|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/Devsoul2026/Hermes-One-Click --skill siyuan-devsoul2026
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/Devsoul2026/Hermes-One-Click/tree/main/hermes-agent/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/Devsoul2026/Hermes-One-Click --skill siyuan-devsoul2026

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables developers and power users to automate SiYuan tasks by issuing kernel API requests directly from the command line, eliminating tedious manual API calls.

Core Features & Use Cases

  • Search blocks and notebooks via API
  • Read, create, update, and delete blocks and documents
  • Manage notebooks and export content for archiving or sharing
  • Use Case: automate note ingestion from external sources and organize notes in SiYuan

Quick Start

Query your SiYuan instance with curl to search, read, create, update, and delete blocks and documents using your API token.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I automate SiYuan block and document management from the command line?

Automate SiYuan block and document management by issuing POST requests with JSON payloads to the kernel API via curl. You can read, create, update, and delete blocks and documents programmatically for batch workflows.

What environment variables do I need to access the SiYuan API?

Accessing the SiYuan API requires the SIYUAN_TOKEN and SIYUAN_URL environment variables. These variables authenticate your curl requests and route them to your local or self-hosted SiYuan instance.

Can I use curl to batch search notebooks and blocks in a self-hosted SiYuan instance?

Batch searching notebooks and blocks in a self-hosted SiYuan instance is supported via curl API requests. The Skill sends POST requests with JSON payloads to query and retrieve block data programmatically.

Does this approach require any external dependencies or libraries?

No external dependencies or libraries are required beyond the standard curl utility. The Skill operates independently by sending POST requests with JSON payloads directly to the SiYuan kernel API endpoints.

What is the best way to automate note ingestion into a SiYuan knowledge base?

Automate note ingestion into a SiYuan knowledge base by using curl to call the kernel API for batch document creation. This eliminates manual API calls and enables automated workflows from external sources.

Can I export content from SiYuan blocks for archiving using the API?

Exporting content from SiYuan blocks for archiving is supported through the kernel API. You can use curl POST requests to manage notebooks and export documents programmatically for sharing or backup.