joplin-api

TotalClaw 作者 totalclaw

通过 REST API 管理 Joplin 笔记。用于以编程方式创建、阅读、更新、删除或搜索 Joplin 笔记。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~killgfat-joplin-api

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~killgfat-joplin-api/file -o killgfat-joplin-api.md

## 概述（中文）

通过 REST API 管理 Joplin 笔记。用于以编程方式创建、阅读、更新、删除或搜索 Joplin 笔记。

## 原文

# Joplin API Skill

Manage Joplin notes, notebooks, and tags via Joplin Data API.

---

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `JOPLIN_BASE_URL` | No | `http://localhost:41184` | Joplin API URL |
| `JOPLIN_TOKEN` | **Yes** | - | API Token from Web Clipper |

---

## Quick Start

### 1. Get API Token

1. Open Joplin → **Tools** → **Options** → **Web Clipper**
2. Enable service and copy the token

### 2. Test Connection

```bash
python3 joplin.py ping
```

---

## Basic Commands

```bash
python3 joplin.py ping                    # Test connection
python3 joplin.py create --title "Title"  # Create note
python3 joplin.py search "keyword"        # Search
python3 joplin.py list --type notes       # List notes
python3 joplin.py stats                   # Statistics
```

---

## Security

- Import/Export restricted to workspace directory
- Sensitive system directories blocked

---

## Documentation

- `references/API.md` - Full API reference
- `references/CONFIGURATION.md` - Configuration examples