Verified:GitHub

siyuan

Search, read, create, and manage SiYuan Note blocks and documents via the kernel API.

Updated Jun 5, 2026

Search Tags:#markdown #api #knowledge base #pkm #notes #curl #siyuan

One-click install

npx skills add https://github.com/xu1713/openhorse --skill siyuan-xu1713

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/xu1713/openhorse/tree/main/openhorse/openhorse/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/xu1713/openhorse --skill siyuan-xu1713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a self-hosted SiYuan knowledge base programmatically requires knowing dozens of API endpoints and their exact request formats. This Skill provides ready-to-use curl commands for every common operation, eliminating the need to read through SiYuan's API documentation. ## Core Features & Use Cases - Full-Text and SQL Search: Query blocks across all notebooks using full-text search or direct SQL SELECT statements against the blocks database. - Document and Block Management: Create notebooks and documents, append, update, and delete blocks, rename documents, and set custom block attributes. - Content Export: Export any document as Markdown for backup, migration, or publishing workflows. - Use Case: You want to log daily meeting notes automatically. Use the create document endpoint to generate a dated document in your Meetings notebook, then append blocks with discussion points and action items. ## Quick Start Set the SIYUAN_TOKEN environment variable from your SiYuan app's Settings > About page, then ask the AI to search your SiYuan notes for a specific topic or create a new document in a chosen notebook.

Frequently Asked Questions about siyuan

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

FAQPage Schema

Is there an alternative to curl for SiYuan integration?▼

Yes, the @porkll/siyuan-mcp MCP server provides native integration instead of raw curl calls. Install it via npx and configure it with your SIYUAN_TOKEN and SIYUAN_URL environment variables in your MCP server configuration.