siyuan

Access SiYuan note operations via curl and authenticated JSON POST requests.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides curl-based access to a self-hosted SiYuan knowledge base so users can search, read, create, update, and manage blocks and documents without installing SDKs or writing custom integrations.

Core Features & Use Cases

  • Full-text and SQL search: Run full-text searches or safe SELECT SQL queries to find relevant blocks and documents.
  • Document and block management: Create notebooks and documents, append or update blocks, rename or delete content, and export documents as Markdown.
  • Operational guidance: Shows API patterns, ID validation, error handling, and common pitfalls for reliable automation with curl and jq.

Quick Start

Use the siyuan skill to search for "meeting notes" and return the first five matching blocks.

Frequently Asked Questions about siyuan

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

FAQPage Schema
How do I use curl to search notes in a self-hosted SiYuan instance?

Use curl to send authenticated JSON POST requests to your SiYuan instance API for note searching. The siyuan skill provides full-text and SQL SELECT query access to find relevant blocks and documents, returning structured JSON responses with code, msg, and data fields.

Can I create and update SiYuan documents via API without an SDK?

Yes, you can create and update SiYuan documents via API using curl POST requests without an SDK. The siyuan skill supports creating notebooks and documents, appending or updating blocks, renaming or deleting content, and exporting documents as Markdown.

Do I need an API token to manage SiYuan blocks through curl automation?

Yes, an API token is required to manage SiYuan blocks through curl automation. You must also provide the optional instance URL for your self-hosted SiYuan instance to perform authenticated POST requests that return structured JSON responses.

What's the best way to automate personal knowledge management tasks for SiYuan?

Automating personal knowledge management for SiYuan is best done using curl and authenticated JSON POST requests. The siyuan skill offers API patterns, ID validation, error handling, and common pitfalls for reliable automation of search, reading, and document operations.

Why are my SiYuan API curl requests returning errors during document operations?

SiYuan API curl requests may return errors if the API token is missing or block IDs are invalid. The siyuan skill provides operational guidance on ID validation, error handling, and common pitfalls to ensure reliable automation and proper structured JSON responses.