nCore-scraper

This is a small tool to get movies data from the biggest Hungarian torrent site.

Get started

Install

$ npm install ncore-scraper

Basic usage

const nCoreScraper = require("ncore-scraper");

const options = {
    user: 'YourNcoreUserName',
    pass: 'YourHashedNcorePass',
    searchTerms: ['Back to the future'],
    debug: true
};

const scraper = new nCoreScraper(options);

scraper.start().then(movieList => {
    console.log(movieList);
});

Options reference

You can pass these options to the nCoreScraper() constructor if you want to change default props.

Required options

• options.user: String, Your nCore username.
• options.pass : String, Your hashed nCore password.

Get hashed nCore password

To get hashed password, you need to log in to the site with "Lower security". This means the backend generates a key, that you can use for login.

After login, you can find the pass cookie in the browser's developer toolbar.

Optional options

• options.debug: Boolean, You can get information about the scraping state on the console. (Default false)
• options.searchTerms : Array, List of movie searching terms. You can use it to find movies by release or by a year. For example to get newly released movies you can use an array of years: [1987, 1989, 1990]. (Default value is the last 2 years, [2020, 2021])

Class:nCoreScraper

nCoreScraper.start

This is a promise. You can start the scraping with this method, after that, you will get a list of movies. This method has an optional argument, the searchTerm String. If you pass a string param, the scraper will use that instead of the default value.

The data you will get is an object of objects. The Object structure is the following:

[imdbId]: {
    imdbId: String,
    [lang(`hu` or `en`)]: {
        [quality(`sd` or `hd`)]: {
            [torrentId]: {
                id: String,
                imdbId: String,
                name: String,
                lang: String,
                quality: String,
                size: Number,
                downloads: Number,
                downloadUrl: String
            }
        }
    }
}

Movie information

• id: String, torrent id.
• imdbId: String, imdb id.
• name: String, name of torrent.
• lang: String, the language of torrent. It can be hu or en.
• quality: String, quality of torrent. It can be sd or hd.
• size: Number, size of the torrent in gigabytes. It is a float number.
• downloads: Number, download count of the movie. It can be between 1 and 5
• downloadUrl: String, download URL of torrent file.

Example:

{
    tt0088763: {
        imdbId: 'tt0088763',
        hu: {
            sd: [
                {
                    id: 'torrentId',
                    imdbId: 'tt0088763',
                    name: 'Back.To.The.Future.I',
                    lang: 'hu',
                    quality: 'sd',
                    size: 1.67,
                    downloads: 5,
                    downloadUrl: 'http://torrent-download.url' 
                }
            ],
            hd: [
                {
                    id: 'torrentId',
                    imdbId: 'tt0088763',
                    name: 'Back.To.The.Future.I',
                    lang: 'hu',
                    quality: 'hd',
                    size: 9.47,
                    downloads: 5,
                    downloadUrl: 'http://torrent-download.url' 
                }
            ]
        },
        en: {
            sd: [
                {
                    id: 'torrentId',
                    imdbId: 'tt0088763',
                    name: 'Back.To.The.Future.I',
                    lang: 'en',
                    quality: 'sd',
                    size: 1.77,
                    downloads: 5,
                    downloadUrl: 'http://torrent-download.url' 
                }
            ],
            hd: [
                {
                    id: 'torrentId',
                    imdbId: 'tt0088763',
                    name: 'Back.To.The.Future.I',
                    lang: 'en',
                    quality: 'hd',
                    size: 8.12,
                    downloads: 5,
                    downloadUrl: 'http://torrent-download.url' 
                }
            ]
        }
    }
}