siyuan

Manage SiYuan Note API blocks and documents using curl commands.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/NITISH-gitbit/hermes-custom --skill siyuan-nitish-gitbit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/NITISH-gitbit/hermes-custom/tree/main/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/NITISH-gitbit/hermes-custom --skill siyuan-nitish-gitbit

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the management of SiYuan notes using curl commands, enabling efficient searching, reading, creating, and updating of blocks and documents within a self-hosted knowledge base.

Core Features & Use Cases

  • API Access: Access SiYuan Note API for various operations like searching, reading, creating, and managing blocks and documents.
  • curl Integration: No extra tools needed, just curl and an API token.
  • Use Case: Quickly search for notes, create new documents, or update existing blocks within your SiYuan knowledge base.

Quick Start

Use the siyuan skill to search for notes containing "project plan".

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I manage SiYuan notes using curl commands?

You can manage SiYuan notes using curl by sending HTTP requests to the SiYuan Note API. This approach allows you to search, read, create, and update blocks and documents directly from the command line without extra tools.

Can I automate SiYuan note management tasks from the command line?

Yes, you can automate SiYuan note management by executing curl commands against the API. This enables scripted workflows for searching notes, creating new documents, and updating existing blocks within your self-hosted knowledge base.

Do I need any extra tools besides curl to interact with the SiYuan API?

No extra tools are needed besides curl and an API token, though jq is listed as a dependency for parsing JSON responses. You can directly access the SiYuan Note API for various block and document operations.

What is the best way to search for notes in a self-hosted SiYuan knowledge base?

The best way to search notes in a self-hosted SiYuan knowledge base is using curl commands to query the API. This method quickly retrieves notes containing specific keywords like project plans without requiring a graphical interface.

Does curl work with SiYuan for creating and updating document blocks?

Yes, curl works with SiYuan for creating and updating document blocks. By targeting the SiYuan Note API with curl requests, you can efficiently manage block content and document structures programmatically.

Why use curl for SiYuan note management instead of other API tools?

Using curl for SiYuan note management offers a lightweight, dependency-minimal approach for API interaction. It is ideal for users who prefer command-line interactions and need to automate note management tasks without installing specialized API clients.