介绍
# Linkding Bookmark Manager
通过 Linkding REST API 查询和管理书签。
## 设置
配置文件：`~/.clawdbot/credentials/linkding/config.json`
```json { "url": "https://linkding.example.com", "apiKey": "your-api-token" } ```
请在 Linkding 设置页面获取您的 API 令牌。
## 快速参考
### 列出/搜索书签
```bash # List recent bookmarks ./scripts/linkding-api.sh bookmarks
# Search bookmarks ./scripts/linkding-api.sh bookmarks --query "python tutorial"
# List archived ./scripts/linkding-api.sh bookmarks --archived
# Filter by date ./scripts/linkding-api.sh bookmarks --modified-since "2025-01-01T00:00:00Z" ```
### 创建书签
```bash # Basic ./scripts/linkding-api.sh create "https://example.com"
# With metadata ./scripts/linkding-api.sh create "https://example.com" \ --title "Example Site" \ --description "A great resource" \ --tags "reference,docs"
# Archive immediately ./scripts/linkding-api.sh create "https://example.com" --archived ```
### 检查 URL 是否存在
```bash ./scripts/linkding-api.sh check "https://example.com" ```
如果找到，则返回现有的书签数据，以及抓取的元数据。
### 更新书签
```bash ./scripts/linkding-api.sh update 123 --title "New Title" --tags "newtag1,newtag2" ```
### 归档/取消归档
```bash ./scripts/linkding-api.sh archive 123 ./scripts/linkding-api.sh unarchive 123 ```
### 删除
```bash ./scripts/linkding-api.sh delete 123 ```
### 标签
```bash # List all tags ./scripts/linkding-api.sh tags
# Create tag ./scripts/linkding-api.sh tag-create "mytag" ```
### 捆绑包（已保存的搜索）
```bash # List bundles ./scripts/linkding-api.sh bundles
# Create bundle ./scripts/linkding-api.sh bundle-create "Work Resources" \ --search "productivity" \ --any-tags "work,tools" \ --excluded-tags "personal" ```
## 响应格式
所有响应均为 JSON。书签对象：
```json { "id": 1, "url": "https://example.com", "title": "Example", "description": "Description", "notes": "Personal notes", "is_archived": false, "unread": false, "shared": false, "tag_names": ["tag1", "tag2"], "date_added": "2020-09-26T09:46:23.006313Z", "date_modified": "2020-09-26T16:01:14.275335Z" } ```
## 常用模式
**保存当前页面以供稍后阅读：** ```bash ./scripts/linkding-api.sh create "$URL" --tags "toread" --unread ```
**快速搜索并显示：** ```bash ./scripts/linkding-api.sh bookmarks --query "keyword" --limit 10 | jq -r '.results[] | "\(.title) - \(.url)"' ```
**批量标签更新：** 通过 API PATCH 请求更新，使用新的 tag_names 数组。