用途:连接 Readwise API,按日期范围获取并分析用户的阅读活动,包括保存的文章、创建的划线,以及被划线最多的内容。默认范围为最近 7 天。
主要能力:提供八种模式——all(综合摘要,含关键学习点、活动时间线、分类分布、统计面板)、learnings(仅洞察)、timeline(每日活动可视化与峰值)、categories(领域分布)、dashboard(指标)、articles(文章列表)、highlights(按来源分组的划线)、top-highlighted(按划线数排名)。分析含领域推断、模式识别与洞察提取。
使用方式:先设置环境变量 export READWISE_API_TOKEN="your_token_here",令牌获取地址为 https://readwise.io/access_token。依赖通过 pnpm 自动安装。日期参数支持 --today、--yesterday、--last-week、--last-month,以及自定义 --from YYYY-MM-DD 与 --to YYYY-MM-DD。示例:pnpm tsx skills/readwise-api/scripts/fetch-todays-activity.ts all --from 2025-01-01 --to 2025-01-07。
限制:API 限速 20 请求/分钟,脚本自动以 3 秒延迟节流;Reader API 仅支持起始日期,结束日期在客户端过滤,可能多取数据;时区为本地,日期转 UTC 传给 API。缺失令牌、网络错误与空结果均有相应提示。
适用场景:查询个人阅读总结、学习洞察、活跃时段与关注主题。