siyuan

Manage SiYuan Notes blocks and documents via curl-based API requests.

Updated May 11, 2026
One-click install
npx skills add https://github.com/richardnguyen0715/keep-it-real --skill siyuan-richardnguyen0715
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/richardnguyen0715/keep-it-real/tree/main/refer-projects/hermes-agent/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/richardnguyen0715/keep-it-real --skill siyuan-richardnguyen0715

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of manually managing and searching through self-hosted SiYuan knowledge bases, allowing for efficient API-based operations.

Core Features & Use Cases

  • API Access to SiYuan Notes: Enables searching, reading, creating, and managing blocks and documents within a SiYuan knowledge base.
  • curl-based Operations: Provides a simple curl interface for API interactions, suitable for automated workflows.
  • Use Case: Quickly search for specific notes, retrieve block content, create new documents, or manage attributes within your SiYuan instance.

Quick Start

Search for notes related to 'project planning' in your SiYuan knowledge base.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I manage and search SiYuan knowledge base notes via API?

You can automate SiYuan notes management via API by using curl to search, read, create, and update blocks and documents. This approach enables efficient knowledge base management and integration with other tools.

How do I search for specific blocks and documents in SiYuan using curl?

To search for specific blocks and documents in SiYuan using curl, you execute API requests against your knowledge base. You need to include a valid SiYuan API token in your curl commands to authenticate and retrieve the matching block content.

What do I need to access the SiYuan API for notes management?

To access the SiYuan API for notes management, you need curl and jq installed, along with a valid SiYuan API token. These prerequisites allow you to send HTTP requests and parse the JSON responses returned by your knowledge base.

Can I automate knowledge base management and integrate SiYuan with other tools?

Yes, you can automate knowledge base management and integrate SiYuan with other tools using its API. By leveraging curl-based operations, you can programmatically manage documents and blocks within your automated workflows.

Does SiYuan API work with curl for creating and updating documents?

Yes, the SiYuan API works with curl for creating and updating documents. It provides a simple curl interface for API interactions, enabling you to manage attributes, create new documents, and update existing blocks within your knowledge base.