Readwise & Reader API

Skill 提供 bundled shell 脚本 scripts/readwise.sh，通过命令行调用 Readwise v2 与 Reader v3 API，实现保存 URL、浏览/搜索阅读列表、管理高亮与笔记、查看每日回顾、列出书籍，命令统一输出 JSON。需 READWISE_TOKEN 环境变量。

gchapim

热度 91.11

最近更新 2026-05-11 15:53:14

分类：知识依赖：代码执行 / 第三方 API应用场景：笔记整理 / 研究 / 工作流

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add readwise-api

Metadata

name: readwise
description: Manage Readwise highlights, books, daily review, and Reader documents (save-for-later / read-it-later). Use when the user wants to save articles or URLs to Reader, browse their reading list, search saved documents, review highlights, create or manage highlights and notes, check their daily review, list books/sources, or interact with Readwise/Reader in any way.

Readwise & Reader

Interact with Readwise (highlights, books, daily review) and Reader (save-for-later documents) via the bundled CLI script.

Setup

Requires READWISE_TOKEN env var. Get a token at https://readwise.io/access_token — works for both Readwise and Reader APIs.

CLI Usage

scripts/readwise.sh [--pretty] <command> [args...]

Reader Commands (Documents)

# Save a URL to Reader
readwise.sh save "https://example.com/article" --location later --tags "ai,research"

# List reading list (inbox)
readwise.sh list --location later --limit 10

# Search documents by title/author
readwise.sh search "transformer"

# Update a document
readwise.sh update DOC_ID --location archive --tags "done,good"

# Delete a document
readwise.sh delete DOC_ID

# List all tags
readwise.sh tags

Readwise Commands (Highlights & Books)

# Get today's daily review
readwise.sh review

# Export highlights (optionally for a specific book)
readwise.sh highlights --book-id 12345 --limit 20

# Get a single highlight
readwise.sh highlight 456789

# Create a highlight
readwise.sh highlight-create --text "Important quote" --title "Book Name" --note "My thought"

# Update highlight color/note
readwise.sh highlight-update 456789 --color blue --note "Updated note"

# Delete a highlight
readwise.sh highlight-delete 456789

# List books/sources
readwise.sh books --category articles --limit 10

# Get book details
readwise.sh book 12345

Output

All commands output JSON. Add --pretty for formatted output.

Common Workflows

Save article and tag it:

readwise.sh save "https://arxiv.org/abs/2401.12345" --title "Cool Paper" --tags "ml,papers" --location later

Check reading list:

readwise.sh list --location later --limit 5

Today's review highlights:

readwise.sh review

Find highlights about a topic: Export all highlights then filter, or search Reader docs:

readwise.sh search "attention mechanism"
readwise.sh highlights --updated-after "2024-01-01"

Archive finished articles:

readwise.sh update DOC_ID --location archive

API Reference

For detailed endpoint documentation, parameters, and response shapes, read references/api.md.

Key details:

Rate limits: Readwise v2: 240 req/min (20/min for list endpoints). Reader v3: 20 req/min (50/min for create/update).
Categories: Books: books, articles, tweets, podcasts. Reader: article, email, rss, highlight, note, pdf, epub, tweet, video.
Locations (Reader): new, later, shortlist, archive, feed
Highlight colors: yellow, blue, pink, orange, green, purple