CNFT crawler and price floor checker for rarities on sale

Gathers information about currently offered NFTs and tries to evaluate them against the provided rarity chart (de-duplicated version).

pre-requisites

In order to run the script, you have to have NodeJS installed and should be familiar with editing a simple configuration file

prior to first run

clone the project from github (git clone https://github.com/slippyex/cnft-crawler.git)
cd cnft-crawler/
npm install

usage

simply edit the file under /config/ to fit your lookup criteria and run it via ❯ node src/index.js

Additionally, you can override any parameter in the config file by using it as an argument

❯ node src/index.js --project="Cardano Caricatures" --extraTags="epic" "rare" --minPrice=20 --maxPrice=120 --filter="extraTags"

❯ node src/index.js crawl --minPrice=600 --maxPrice=1800 --project="Cardano Waifus" --extraTags="SS" --filter="extraTags"

for instance would look for the given project and checks for trait tags epic and rare and flags them

You can also check for the floor of a given project by calling it via ❯ node src/index.js --project="Spacebudz" --floor

which would give an output similar to this

❯ node src/index.js floor --project="Spacebudz" 
entering cnft crawler with floor check on project Spacebudz
Current floor for project Spacebudz is 3550 ADA

Have a closer look to the output and decide if you want to check and buy

❯ node src/index.js --help

provides an overview of all possible combinations and options, you can use

example configuration

module.exports = {
// project to crawl (as shown on cnft.io projects list)
//  project: 'Clay Nation by Clay Mates',
project: 'Bitlands',
// threshold of trait in percent
// if 5 that means, that the trait has to have a minimum of 5% in order to be considered
threshold: 5,
// minimum amount of traits with the above threshold in order to be considered valuable
// if 3 that means, we have to have at least 3 traits with a minimum of 5% in rarity
minTrigger: 5,
// if any of the given extra tags is found in the traits, we consider the item
// valuable, regardless of the percent coverage above
//extraTags: ['blue clay', 'green clay', 'laser eyes', 'duck', 'angel wings', 'orangutan'],
extraTags: ['rare'],
// filters results just based on the given rarity criteria
filter: 'rarity',  
// minimum price in ADA
minPrice: 1000,
// maximum price in ADA
maxPrice: 1200,
// maximum amount of pages to crawl - each page has an output of 25 items
maxPages: 15
}

example output