Skip to main content Calculate NFT rarity scores and rank tokens by trait uniqueness.
Use when analyzing NFT collections, checking token rarity, or comparing NFTs.
Trigger with phrases like "check NFT rarity", "analyze collection", "rank tokens", "compare NFTs".
npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill analyzing-nft-rarity ai automation claude-code devops mcp ai-agents
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:
--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 ${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 cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export coolcats > rankings.json
cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export coolcats --format csv > rankings.csv
6. Manage Cache cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py cache --list
cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py cache --clear
Rarity Algorithms Algorithm Description Best For rarity_scoreSum of 1/frequency (default) General use, matches rarity.tools statisticalSame as rarity_score Backward compatibility averageMean of trait rarities Balanced scoring informationEntropy-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 ${CLAUDE_SKILL_DIR}/references/errors.md for:
API rate limiting
IPFS gateway issues
Collection not found
Token ID not found
Examples See ${CLAUDE_SKILL_DIR}/references/examples.md for:
Collection analysis workflows
Token comparison
Export and caching
Algorithm comparison
Resources Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).