名称： readeck
描述： Readeck 集成，用于保存和管理文章。支持通过 Readeck API 添加 URL、列出条目和管理书签。可通过请求参数或环境变量 READECK_URL 和 READECK_API_KEY 配置自定义 URL 和 API 密钥。

Readeck 集成

配置

通过以下方式配置 Readeck 访问：
- 请求参数：url 和 apiKey
- 环境变量：READECK_URL 和 READECK_API_KEY

核心操作

添加文章

将 URL 添加到 Readeck 进行解析和保存：

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

响应包含 id、url 和 title。

列出条目

获取已保存的文章：

curl "$READECK_URL/api/bookmarks?limit=20" \
  -H "Authorization: Bearer $READECK_API_KEY"

查询参数：page、limit、status、search。

获取单个条目

curl "$READECK_URL/api/bookmarks/$ID" \
  -H "Authorization: Bearer $READECK_API_KEY"

删除条目

curl -X DELETE "$READECK_URL/api/bookmarks/$ID" \
  -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": "https://example.com", "tags": ["tech", "readlater"]}

保存到指定集合：

{"url": "https://example.com", "collection": "my-collection"}

按状态筛选： unread（未读）、read（已读）、archived（已归档）

错误处理

• 401：API 密钥无效
• 404：条目未找到
• 422：URL 或请求正文无效