readeck

# 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: ```bash 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: ```bash curl "$READECK_URL/api/bookmarks?limit=20" \ -H "Authorization: Bearer $READECK_API_KEY" ``` Query parameters: `page`, `limit`, `status`, `search`. ### Get Single Entry ```bash curl "$READECK_URL/api/bookmarks/$ID" \ -H "Authorization: Bearer $READECK_API_KEY" ``` ### Delete Entry ```bash curl -X DELETE "$READECK_URL/api/bookmarks/$ID" \ -H "Authorization: Bearer $READECK_API_KEY" ``` ### Mark as Read ```bash 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:** ```json {"url": "https://example.com", "tags": ["tech", "readlater"]} ``` **Save to specific collection:** ```json {"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