Linkding 书签管理器

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

设置

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

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

从 Linkding 设置页面获取您的 API 令牌。

快速参考

列出/搜索书签

# 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"

创建书签

# 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 是否存在

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

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

更新书签

./scripts/linkding-api.sh update 123 --title "New Title" --tags "newtag1,newtag2"

归档/取消归档

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

删除

./scripts/linkding-api.sh delete 123

标签

# List all tags
./scripts/linkding-api.sh tags

# Create tag
./scripts/linkding-api.sh tag-create "mytag"

捆绑包（已保存的搜索）

# 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 格式。书签对象：

{
  "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"
}

常用模式

保存当前页面以供稍后查看：

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

快速搜索和显示：

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

批量更新标签：通过API PATCH更新，附带新的tag_names数组。