parsedan 0.1.1b3

A shodan parser that given a query will download results and parse them into CSV or JSON files while also scoring them.

Parsedan

-
Report Bug · Request Feature

About The Project

This project was writen to download data from shodan's api, parsing it, and scoring it. In its current state it uses a sqlite database to store objects. Every run of Parsedan will save to this database, so for example, you can run the program once a week and build a database of computers with scores for a given query.

If you simply want to run the script for a one time use, from a fresh database, run with the command --reset-db.

(back to top)

Getting Started

Prerequisites

This pacakge was built for python 3.6+.

• python 3.6+ See https://www.python.org/

Installation

1. Install Parsedan

   pip install parsedan
   

2. Get a shodan API Key at https://developer.shodan.io/api/requirements
3. Initalize parsedan with your key

   parsedan init API_KEY
   

(back to top)

Usage

WIP

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Stephenson Disaster Management Institute at Louisiana State University - [e-mail]

Project Link: https://github.com/SDMI-Developers/parsedan

(back to top)