search

mnsrulz / nurlresolver

Node url resolver. Direct link generator for many known sites.
MIT License
15 stars 10 forks source link
javascript nodejs

readme

nurlresolver

Streamline your download experience with this Node.js package designed to extract direct, hassle-free downloadable links from various file-sharing websites. Say goodbye to multiple clicks and pesky ads, ensuring a seamless and efficient downloading process.

license npm latest package npm downloads github forks github stars

Live Demo

Warning: This package is native ESM and no longer provides a CommonJS export. If your project uses CommonJS, you will have to convert to ESM or use the dynamic import() function. Please don't open issues for questions regarding CommonJS / ESM.

Installation

npm install nurlresolver

Usage: ES6 usage

import nUrlResolver from 'nurlresolver';
const results = await nUrlResolver.resolve(linkToResolve);

const linkToResolve = 'https://cloud.mail.ru/public/abcd/sAmPlE';
const results = await nUrlResolver.resolve(linkToResolve);

Output

[  
  {
    link: 'https://cloclo3.cldmail.ru/public/get/generatedlink/no/FileName.extension',
    title: 'FileName.extension',
    isPlayable: true,
    parent: 'https://cloud.mail.ru/public/abcd/sAmPlE',
    speedRank: 65 //0-100 better speed means higher rank
  }
]

Resolve link recursively:

const results = await nUrlResolver.resolveRecursive(link);
/*
This is going to resolve the final playback links.
Schema representation is same as above result.
The only difference is it recursively resolve all the links as they get found.
*/

Headers Support

In some of the sharing sites, it's required to send some header information back. e.g. Referer is required in some sites or if a link generated from an ip which is only accessible from that ip (in this case the xforward header is added in the result output so that same header can be sent to the same site later on.)

Advance Options

options

Name Type Description
extractMetaInformation boolean instruct the resolver to extract contenttype, lastmodifieddate and size of the file.
timeout number timeout in seconds
googleDrive.apiKey string optional api key to avoid anonymous access. Defaults to empty to allow anonymous access.
customResolvers array custom resolvers you can inject for resolving urls. Refer to app.tests for implementation samples
ignoreResolvers array regex array you can inject to ignore executing specific resolvers. Refer to app.tests for implementation samples 
const results = await nUrlResolver.resolve(linkToResolve, {
    extractMetaInformation: true,
    timeout: 30 //returns the results at maximum after 30 seconds.
});

Output

[
  {
    "link": "http://www5d.filecdn.pw/dkske911881kkk?download_token=SOME_TOKEN_VALUE",
    "title": "FILE.EXTENSION",
    "isPlayable": true,
    "headers": {
      "X-Real-IP": "XX.YY.ZZ.AA"
    },
    "parent": "https://dlfiles.online/dkske911881kkk",
    "speedRank": 55,
    "size": "900163682",
    "lastModified": "Wed, 21 Sep 2019 12:09:06 GMT",
    "contentType": "application/octet-stream"
  }
]

Supported sites

Try it Online https://repl.it/repls/HandsomeLightgraySmalltalk

Testing

npm run test

License

MIT