Readeck文章管理

技能简介

Readeck是一款开源的稍后阅读工具，本技能通过其API实现文章的保存、查询与管理，支持自定义标签和分类整理。

能做什么

• 添加网页链接到Readeck进行解析保存
• 列出已保存的文章条目，支持分页和搜索
• 查看单篇文章详情
• 删除不需要的书签
• 标记文章为已读/未读/归档状态
• 为文章添加标签或指定收藏集

使用说明

安装与配置

本技能无需额外安装包，但需配置Readeck服务访问信息：

1. 部署Readeck服务或获取现有服务地址
2. 在Readeck中生成API密钥
3. 配置方式二选一：
   • 环境变量：设置READECK_URL和READECK_API_KEY
   • 请求参数：每次调用时传入url和apiKey

基本调用示例

# 添加文章
curl -X POST "$READECK_URL/api/bookmarks" \
  -H "Authorization: Bearer $READECK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

# 列出文章（支持page/limit/status/search参数）
curl "$READECK_URL/api/bookmarks?limit=20" \
  -H "Authorization: Bearer $READECK_API_KEY"

# 标记已读
curl -X PUT "$READECK_URL/api/bookmarks/$ID/status" \
  -H "Authorization: Bearer $READECK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "read"}'

高级用法

• 保存时加标签：{"url": "...", "tags": ["tech", "readlater"]}
• 指定收藏集：{"url": "...", "collection": "my-collection"}
• 状态过滤：unread、read、archived

输入与输出

见下方输入与输出表格。

风险提示

• API密钥泄露可能导致书签数据被他人访问或篡改
• 自托管服务需自行保障可用性和数据备份
• 部分网页解析可能失败，建议检查返回状态
• 频繁调用可能触发服务限流

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jayphen/readeck/SKILL.md
来源类型：GitHub仓库