名称： linkding
版本： 1.0.1
描述： 使用 Linkding 管理书签。当用户要求“保存书签”、“添加链接”、“搜索书签”、“列出我的书签”、“查找已保存链接”、“为书签添加标签”、“归档书签”、“检查 URL 是否已保存”、“列出标签”、“创建合集”或提及 Linkding 书签管理时使用。

Linkding 书签管理器

通过 Linkding REST API 查询和管理书签。

配置

配置文件：~/.clawdbot/credentials/linkding/config.json

{
  "url": "https://linkding.example.com",
  "apiKey": "your-api-token"
}

API 令牌可在 Linkding 设置页面获取。

快速参考

列出/搜索书签

# 列出最近的书签
./scripts/linkding-api.sh bookmarks

# 搜索书签
./scripts/linkding-api.sh bookmarks --query "python 教程"

# 列出已归档的书签
./scripts/linkding-api.sh bookmarks --archived

# 按日期筛选
./scripts/linkding-api.sh bookmarks --modified-since "2025-01-01T00:00:00Z"

创建书签

# 基础创建
./scripts/linkding-api.sh create "https://example.com"

# 带元数据创建
./scripts/linkding-api.sh create "https://example.com" \
  --title "示例网站" \
  --description "一个优质资源" \
  --tags "参考,文档"

# 创建后立即归档
./scripts/linkding-api.sh create "https://example.com" --archived

检查 URL 是否存在

./scripts/linkding-api.sh check "https://example.com"

如果找到，返回现有书签数据及抓取的元数据。

更新书签

./scripts/linkding-api.sh update 123 --title "新标题" --tags "新标签1,新标签2"

归档/取消归档

./scripts/linkding-api.sh archive 123
./scripts/linkding-api.sh unarchive 123

删除书签

./scripts/linkding-api.sh delete 123

标签管理

# 列出所有标签
./scripts/linkding-api.sh tags

# 创建标签
./scripts/linkding-api.sh tag-create "我的标签"

合集（保存的搜索）

# 列出所有合集
./scripts/linkding-api.sh bundles

# 创建合集
./scripts/linkding-api.sh bundle-create "工作资源" \
  --search "生产力" \
  --any-tags "工作,工具" \
  --excluded-tags "个人"

响应格式

所有响应均为 JSON 格式。书签对象示例：

{
  "id": 1,
  "url": "https://example.com",
  "title": "示例",
  "description": "描述",
  "notes": "个人备注",
  "is_archived": false,
  "unread": false,
  "shared": false,
  "tag_names": ["标签1", "标签2"],
  "date_added": "2020-09-26T09:46:23.006313Z",
  "date_modified": "2020-09-26T16:01:14.275335Z"
}

常用模式

保存当前页面稍后阅读：

./scripts/linkding-api.sh create "$URL" --tags "待读" --unread

快速搜索并显示：

./scripts/linkding-api.sh bookmarks --query "关键词" --limit 10 | jq -r '.results[] | "\(.title) - \(.url)"'

批量更新标签： 通过 API PATCH 请求更新 tag_names 数组。