360 Secure SkillHub
360 安全技能中心

Readeck

封装 Readeck 书签服务的 REST 调用，用 curl 和 Bearer 令牌完成添加 URL、分页列出、读取单条、删除与标记已读/归档，支持标签和集合参数，并说明 401/404/422 错误含义。

jayphen
jayphen
热度 96.30
最近更新 2026-05-11 15:48:53
分类：知识依赖：第三方 API / 代码执行应用场景：笔记整理 / 研究 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add readeck
Metadata
name
readeck
description
Readeck integration for saving and managing articles. Supports adding URLs, listing entries, and managing bookmarks via Readeck's API. Configure custom URL and API key per request or via environment variables READECK_URL and READECK_API_KEY.

Readeck Integration

Configuration

Configure Readeck access via:

  • Request parameters: url and apiKey
  • Environment variables: READECK_URL and READECK_API_KEY

Core Operations

Add Article

Add a URL to Readeck for parsing and saving:

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

Response includes id, url, and title.

List Entries

Fetch saved articles:

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

Query parameters: page, limit, status, search.

Get Single Entry

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

Delete Entry

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

Mark as Read

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

Common Patterns

Save with tags:

{"url": "https://example.com", "tags": ["tech", "readlater"]}

Save to specific collection:

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

Filter by status: unread, read, archived

Error Handling

  • 401: Invalid API key
  • 404: Entry not found
  • 422: Invalid URL or request body