用途：分析 NFT 系列的稀有度，检查单个代币稀有度，或对多个 NFT 进行比较。
主要能力：从 OpenSea API 获取系列元数据；解析并规范化特征属性；用多种算法计算稀有度（rarity_score 即 1/频率之和，默认且与 rarity.tools 一致；statistical 为向后兼容的同义算法；average 为特征稀有度均值；information 为基于熵的 -log2）；按综合稀有度评分对代币排名；以 JSON 和 CSV 导出；展示特征分布与最稀有特征；支持缓存管理。输出包括系列摘要、带百分位的排名、代币特征明细及贡献度、并排对比。
使用方式：需 Python 3.8+ 与 requests 库；可选 OPENSEA_API_KEY 提高速率限制，可选 ALCHEMY_API_KEY 直接获取元数据。分析系列：cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py collection boredapeyachtclub；可加 --limit 500、--top 50、--traits、--rarest、--algorithm [statistical|rarity_score|average|information]。查看单个代币：python3 rarity_analyzer.py token pudgypenguins 1234。比较：python3 rarity_analyzer.py compare azuki 1234,5678,9012。查看特征分布：python3 rarity_analyzer.py traits doodles。导出：python3 rarity_analyzer.py export coolcats > rankings.json，加 --format csv 则以 CSV 输出。缓存：python3 rarity_analyzer.py cache --list 或 cache --clear。
适用场景：适用于任何具备 OpenSea 上架、标准 attributes 数组格式且元数据可访问的 ERC-721/ERC-1155 系列。
限制：未提供具体价格、收费方式或效果保证；错误处理参见 ${CLAUDE_SKILL_DIR}/references/errors.md（含 API 速率限制、IPFS 网关问题、系列或代币 ID 未找到），示例与工作流参见 examples.md。