技能简介
Linkding 是一款轻量级自托管书签管理工具,通过 REST API 实现书签的增删改查、标签管理和归档操作。
业务背景
知识工作者、研究团队及内容策展人可集中管理网页资源,通过标签体系实现信息分类与快速检索。支持归档与已读标记,帮助过滤无效链接,构建个人或团队的知识资产库,提升信息复用效率。
落地案例:某咨询团队建立行业情报库,成员将调研文章保存至Linkding并添加"竞品分析""政策解读"等标签;项目经理通过关键词搜索快速调取历史资料,利用Bundles功能将季度报告所需链接分组共享,避免重复检索分散在各浏览器的书签。
能做什么
- 保存网页链接并添加标题、描述和标签
- 按关键词搜索已存书签
- 将书签标记为已读/未读或归档状态
- 创建标签集合与智能搜索分组(Bundles)
- 检查 URL 是否已存在避免重复保存
使用说明
安装配置
- 在 Linkding 设置页面获取 API Token
- 创建配置文件
~/.clawdbot/credentials/linkding/config.json:
{"url": "https://linkding.example.com","apiKey": "your-api-token"}
常用操作
列出最近书签:./scripts/linkding-api.sh bookmarks
搜索书签:./scripts/linkding-api.sh bookmarks --query "python tutorial"
创建书签:./scripts/linkding-api.sh create "https://example.com" --title "站点名称" --tags "参考,文档"
检查 URL 是否存在:./scripts/linkding-api.sh check "https://example.com"
更新书签:./scripts/linkding-api.sh update 123 --title "新标题"
归档/取消归档:./scripts/linkding-api.sh archive 123 / unarchive 123
删除书签:./scripts/linkding-api.sh delete 123
管理标签:./scripts/linkding-api.sh tags / tag-create "新标签"
创建搜索分组:./scripts/linkding-api.sh bundle-create "工作资源" --search "效率" --any-tags "工作,工具"
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | URL 地址;可选:标题、描述、标签列表、归档/未读/共享状态;搜索时支持关键词、日期范围、标签过滤 |
| 输出 | JSON 格式书签对象(含 ID、URL、标题、描述、笔记、归档状态、阅读状态、共享状态、标签名、创建/修改时间);搜索结果列表;标签列表;分组列表 |
| 适用人群 | 自托管服务使用者、命令行偏好者、团队知识库维护人员、数据隐私敏感用户 |
| 不包含 | 浏览器插件自动保存、网页正文全文检索、多层级文件夹结构、社交化书签分享功能 |
风险提示
- 需自行部署 Linkding 服务并确保网络可访问
- API Token 泄露可能导致书签数据被篡改
- 归档操作不可逆,删除前请确认
- 大量书签批量操作时建议先测试小范围数据
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/jmagar/linkding/SKILL.md
来源类型:GitHub 开源技能
