SuperAPI AI 工具集

pp-nypl-digital-collections

编程与开发

查看项目

更新于 10-16 01:32

技能介绍

用途:该工具围绕纽约公共图书馆数字馆藏 API(源文档 https://api.repo.nypl.org/)提供命令行与技能封装,便于在终端或智能体流程中检索该馆藏数据。

主要能力:collections 命令可列出馆藏并获取子捕获;items 命令覆盖条目计数、详情(MODS)、精选条目、METS ALTO、精简 ALTO、纯文本 ALTO、权限信息、总条目数、捕获列表、最近新增、根级 UUID、按标识符查找、关键词搜索等;mods 命令返回指定 UUID 的 MODS 书目数据。可通过 which "<能力描述>" 用自然语言定位命令。

安装方式:npx -y @mvanhorn/printing-press-library install nypl-digital-collections --cli-only,安装后可用 nypl-digital-collections-pp-cli --version 校验;若 npx 不可用,可回退到 go install github.com/mvanhorn/printing-press-library/library/other/nypl-digital-collections/cmd/nypl-digital-collections-pp-cli@latest(需 Go 1.26.6 或更新)。

认证与用法:先运行 nypl-digital-collections-pp-cli auth setup 获取密钥步骤,再设置 export NYPL_DIGITAL_COLLECTIONS_NYPL_TOKEN="<your-key>",或用 ~/.config/nypl-digital-collections-pp-cli/config.toml 持久化,随后用 doctor 校验。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes;支持 --select 筛字段、--dry-run 预览、--deliver 输出到 stdout、文件或 webhook、profile 保存常用参数。

适用场景:需要以脚本或智能体方式批量拉取 NYPL 数字馆藏元数据与文本、按标识符定位条目、导出 JSON 结果时。

限制:资料来源注明 NYPL Repo API 自 2026 年 8 月 1 日起将停用;需自行获取并配置令牌;条目详情等操作的 UUID 必须属于有效捕获;离线使用依赖本地 SQLite 存储是否已有同步数据;其余计费、价格、平台支持等信息暂未提供。