siyuan

Manage and retrieve notes in a self-hosted SiYuan knowledge base via curl commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill enables developers and users to programmatically search, read, create, and manage blocks and documents within a self-hosted SiYuan knowledge base using curl commands.

Core Features & Use Cases

  • Knowledge Base Management: Search for specific blocks or documents, create new notes, and organize content efficiently.
  • Content Retrieval and Editing: Read the content of blocks and update or delete them as needed to maintain a structured digital repository.
  • Quick Start: Use curl commands to fetch a block's content and modify it directly without manual interface interactions.

Quick Start

Use the SiYuan API to search for a keyword in your knowledge base.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I search for specific blocks in a self-hosted SiYuan knowledge base via API?

To search a self-hosted SiYuan knowledge base via API, you execute curl commands with the appropriate authorization headers and JSON payloads to retrieve matching blocks or documents programmatically.

Can I programmatically create and update notes in SiYuan using curl commands?

Yes, you can programmatically create and update notes in SiYuan by sending curl commands to the API, passing JSON payloads to manage block content and structure without manual interface interactions.

What do I need to automate document management and content retrieval in a SiYuan knowledge base?

Automating SiYuan knowledge base management requires a self-hosted SiYuan instance, valid API authorization headers, and curl commands formatted with JSON payloads to interact with the repository.

Does the SiYuan API support deleting blocks and restructuring documents automatically?

The SiYuan API supports deleting blocks and restructuring documents automatically by sending targeted HTTP requests with curl, allowing you to maintain a structured digital repository programmatically.

Why are my curl requests to the SiYuan API failing to retrieve block content?

SiYuan API requests fail when curl commands lack necessary authorization headers or contain malformed JSON payloads, preventing successful interaction with the self-hosted knowledge base repository.