Skip to main content

Dark Keeper is open source simple web-parser for podcast-sites

Project description

Build Status Coverage Status

Dark Keeper

Dark Keeper is open source simple web-parser for podcast-sites. Also you can use it for any sites.

Goal idea: parsing full information per each podcast episodes like number, description and download link.


  • [x] simple web-spider walking on site
  • [x] cache for all downloaded pages
  • [x] parse any information from pages
  • [x] export parsed data to MongoDB

Quick start

$ mkvirtualenv keeper

(keeper)$ pip install dark-keeper

(keeper)$ cat

from dark_keeper import BaseParser, DarkKeeper, HttpClient, UrlsStorage, DataStorage, ExportMongo

class PodcastParser(BaseParser):
    def parse_urls(self, content):
        urls = content.parse_urls('.posts-list > .container-fluid .text-left a')

        return urls

    def parse_data(self, content):
        data = []
        for post_item in content.get_block_items('.posts-list .posts-list-item'):
            post_data = dict(
                mp3=post_item.parse_attr('.post-podcast-content audio', 'src'),

            if post_data['title'] and post_data['mp3']:

        return data

if __name__ == '__main__':
    pk = DarkKeeper(
            user_agent='Mozilla/5.0 (Windows NT 10.0; Win64; x64) '
                       'AppleWebKit/537.36 (KHTML, like Gecko) '
                       'Chrome/81.0.4044.138 Safari/537.36 OPR/68.0.3618.125',

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for dark-keeper, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size dark_keeper-0.3.0-py3-none-any.whl (8.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size dark-keeper-0.3.0.tar.gz (5.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page