SuperAPI AI 工具集

pp-pcgs

数据与分析

查看项目

更新于 10-16 01:32

技能介绍

用途:该技能驱动 pcgs-pp-cli 二进制,面向 PCGS 评级硬币与纸币的只读查询,适合批量校验证书、提取完整 CoinFacts 元数据、在 1,000 次/天的调用预算下同步人口/价格指南/拍卖数据,作为个人收藏系统的上游数据源,而非收藏系统本身。不可用于创建、更新、删除、发布、下单等改变远端状态的操作。

主要能力:coin batch 解析 CSV/JSON/JSONL 证书列表并批量查询,--dry-run 可零调用预估成本,--resumable 与 --checkpoint 支持跨 UTC 日分批;refresh 仅刷新 PCGS 可变字段(Population、PriceGuideValue、AuctionList、Images 等)并输出字段级差异;coin pop-curve 一次拉取某 PCGSNo 的 1–70 级、PlusGrade 及可选 82–98 Details 编码;order hydrate 根据送评号拉取订单并展开每个证书的 CoinFacts 与可选图片;audit 查询本地 lookup_log;search 基于 FTS5 与数值过滤在本地缓存上检索,不消耗配额。另有 banknote 与 order 系列命令。

使用方式:先安装并验证 CLI,npx -y @mvanhorn/printing-press-library install pcgs --cli-only,或 go install github.com/mvanhorn/printing-press-library/library/other/pcgs/cmd/pcgs-pp-cli@latest(需 Go 1.26.6+),随后 pcgs-pp-cli --version 确认。设置 PCGS_AUTH_TOKEN 为 https://www.pcgs.com/publicapi 生成的 bearer token,并用 pcgs-pp-cli doctor 验证。任意命令可加 --agent,展开为 --json --compact --no-input --no-color --yes;--select 可只保留所需字段。可用 pcgs-pp-cli which "<能力描述>" 定位命令。

适用场景:批量验证 PCGS 证书、按配额规划大列表查询、同步市场数据、按等级分析稀缺度、结合送评号展开订单、在本地缓存上做检索与审计。

限制:仅只读;受每天 1,000 次调用预算限制;需先安装 CLI 并确保其在 PATH 中,否则不要执行技能命令;需要 PCGS 认证令牌;图片命令仅返回 URL,不下载二进制。与其他工具的联动组合需另行安装对应 CLI,本 CLI 不自动依赖它们。部分细节(如具体错误码语义)资料未完整提供。