OpenSkillIndex← back to search
claude-codedata

Claude-skill-registry analyzing-nft-rarity

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/analyzing-nft-rarity" ~/.claude/skills/majiayu000-claude-skill-registry-analyzing-nft-rarity && rm -rf "$T"
manifest: skills/data/analyzing-nft-rarity/SKILL.md
tags
#nft#rarity#api#data-analysis#opensea
source content

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 {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

AlgorithmDescriptionBest For
rarity_score
Sum of 1/frequency (default)General use, matches rarity.tools
statistical
Same as rarity_scoreBackward compatibility
average
Mean of trait raritiesBalanced 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