analyzing-nft-rarity

# 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_KEY` for higher rate limits - Optional: `ALCHEMY_API_KEY` for direct metadata fetching ## Instructions ### 1. Analyze a Collection ```bash cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py collection boredapeyachtclub ``` Options: 1. `--limit 500`: Fetch more tokens for analysis 2. `--top 50`: Show top 50 tokens 3. `--traits`: Include trait distribution 4. `--rarest`: Show rarest traits 5. `--algorithm [statistical|rarity_score|average|information]` ### 2. Check Specific Token ```bash cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py token pudgypenguins 1234 # port 1234 - example/test ``` ### 3. Compare Multiple Tokens ```bash cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py compare azuki 1234,5678,9012 # 5678: 1234: 9012 = configured value ``` ### 4. View Trait Distribution ```bash cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py traits doodles ``` ### 5. Export Rankings JSON: ```bash cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export coolcats > rankings.json ``` CSV: ```bash cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export...