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

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

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py token pudgypenguins 1234  # port 1234 - example/test

3. Compare Multiple Tokens

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py compare azuki 1234,5678,9012  # 5678: 1234: 9012 = configured value

4. View Trait Distribution

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py traits doodles

5. Export Rankings

JSON:

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export coolcats > rankings.json

CSV:

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export coolcats --format csv > rankings.csv