analyzing-nft-rarity
1
总安装量
1
周安装量
#54296
全站排名
安装命令
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill analyzing-nft-rarity
Skill 文档
Analyzing NFT Rarity
Overview
NFT rarity analysis skill that:
- Fetches collection metadata from OpenSea API
- Parses and normalizes trait attributes
- Calculates rarity using multiple algorithms
- Ranks tokens by composite rarity score
- Exports data in JSON and CSV formats
Prerequisites
- Python 3.8+ with requests library
- Optional:
OPENSEA_API_KEYfor higher rate limits - Optional:
ALCHEMY_API_KEYfor direct metadata fetching
Instructions
1. Analyze a Collection
cd {baseDir}/scripts && python3 rarity_analyzer.py collection boredapeyachtclub
Options:
--limit 500: Fetch more tokens for analysis--top 50: Show top 50 tokens--traits: Include trait distribution--rarest: Show rarest traits--algorithm [statistical|rarity_score|average|information]
2. Check Specific Token
cd {baseDir}/scripts && python3 rarity_analyzer.py token pudgypenguins 1234
3. Compare Multiple Tokens
cd {baseDir}/scripts && python3 rarity_analyzer.py compare azuki 1234,5678,9012
4. View Trait Distribution
cd {baseDir}/scripts && python3 rarity_analyzer.py traits doodles
5. Export Rankings
JSON:
cd {baseDir}/scripts && python3 rarity_analyzer.py export coolcats > rankings.json
CSV:
cd {baseDir}/scripts && python3 rarity_analyzer.py export coolcats --format csv > rankings.csv
6. Manage Cache
cd {baseDir}/scripts && python3 rarity_analyzer.py cache --list
cd {baseDir}/scripts && python3 rarity_analyzer.py cache --clear
Rarity Algorithms
| Algorithm | Description | Best For |
|---|---|---|
rarity_score |
Sum of 1/frequency (default) | General use, matches rarity.tools |
statistical |
Same as rarity_score | Backward compatibility |
average |
Mean of trait rarities | Balanced scoring |
information |
Entropy-based (-log2) | Information theory approach |
Output
- Collection Summary: Name, supply, trait types
- Rankings: Tokens sorted by rarity score with percentile
- Token Detail: Full trait breakdown with contribution
- Comparison: Side-by-side trait comparison
Supported Collections
Works with any ERC-721/ERC-1155 collection that has:
- OpenSea listing
- Standard attributes array format
- Accessible metadata
Error Handling
See {baseDir}/references/errors.md for:
- API rate limiting
- IPFS gateway issues
- Collection not found
- Token ID not found
Examples
See {baseDir}/references/examples.md for:
- Collection analysis workflows
- Token comparison
- Export and caching
- Algorithm comparison
Resources
- OpenSea API – Metadata source
- Rarity Tools – Reference rankings
- IPFS – Decentralized metadata