360 Secure SkillHub
360 安全技能中心

Readwise Reader

该 Skill 提供一组 Python 命令行脚本，通过 Readwise Reader 服务管理文档库：列出与筛选文档、按网址或内容新建文档、更新位置与标签、批量更新（单次上限 50 条）、删除文档以及列出全部标签。使用前需配置访问令牌并安装依赖，输入输出为 JSON/JSONL；删除操作需显式确认。

xinthink
xinthink
热度 46.45
最近更新 2026-05-11 17:36:03
分类：知识依赖：代码执行 / 第三方 API / 读写文件应用场景：笔记整理 / 研究 / 工作流

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add readwise-reader
Metadata
name
reader
description
Interact with Readwise Reader library to list, create, update, and delete documents. Use when the user wants to manage their saved articles, reading lists, or retrieve document content. Triggers on mentions of "Readwise Reader", "Reader API", or requests to save/read/archive web articles.
homepage
https://github.com/xinthink/reader-mcp-server
metadata
{"clawdbot":{"emoji":"📚","requires":{"bins":["pip","python"],"env":["READWISE_ACCESS_TOKEN"]},"primaryEnv":"READWISE_ACCESS_TOKEN"}}

Reader

Interact with Readwise Reader library using executable scripts.

Quick Start

All Reader operations are available as scripts in the scripts/ subdirectory:

Script Purpose Input
list_documents.py Query documents CLI flags
create_document.py Save URL/content JSON payload
update_document.py Modify document JSON payload
bulk_update_documents.py Batch modify (max 50) JSON payload
delete_document.py Remove documents JSON payload
list_tags.py List all tags CLI flags

Authentication

Set the READWISE_ACCESS_TOKEN environment variable using one of these methods:

Method 1: Using a .env file

Create a .env file in the project directory:

READWISE_ACCESS_TOKEN=your-token-here

The scripts automatically load environment variables from .env using python-dotenv.

Method 2: Command line

Export in shell:

export READWISE_ACCESS_TOKEN=your-token-here

Or inline for a single command:

READWISE_ACCESS_TOKEN=your-token-here python scripts/list_documents.py

Getting your token

Get your token from: https://readwise.io/access_token

Setup

Install the required dependencies before using the scripts:

pip install -r scripts/requirements.txt

Common Workflows

List documents in a folder

python scripts/list_documents.py --location later --limit 10

Save a URL with tags

echo '{"url": "https://example.com/article", "tags": ["important"]}' | python scripts/create_document.py

Archive a document

echo '{"id": "doc-id", "location": "archive"}' | python scripts/update_document.py

Bulk archive multiple documents

echo '{"updates": [{"id": "doc1", "location": "archive"}, {"id": "doc2", "location": "archive"}]}' | python scripts/bulk_update_documents.py

Error Handling

Exit Code Meaning Action
0 Success Parse stdout
1 API error Check stderr for details
2 Auth error Verify READWISE_ACCESS_TOKEN
3 Rate limit Wait and retry
4 Invalid input Fix payload/flags

Errors are written to stderr in JSON format:

{"error": {"type": "...", "message": "...", "hint": "..."}}

Rate Limits

Scripts automatically handle retries for rate limits (429) and server errors (5xx). No action needed unless exit code 3.

Resources