Skip to main content

Search tool to find email addresses by abusing search

Project description

https://readthedocs.org/projects/frisbee/badge/?version=latest https://badge.fury.io/py/frisbee.svg https://img.shields.io/badge/License-MIT-yellow.svg

Frisbee is a small utility to collect email addresses from search engines and other free-form text sources. Frisbee makes it simple to find email addresses posted on the web by taking user-fed input and translating it into an automated search query. Users can extend frisbee by adding modules for new search engines or other obscure data sources.

For detailed explanations of the library, please see the wiki.

Quick Start

Install the library:

pip install frisbee or python setup.py install

Run a search

frisbee search -e bing -d bnpparibas.com -l 50 --greedy --save

Sample Code

This sample code shows some of the range of functionality within the module:

from frisbee import Frisbee

# Create an instance
frisbee = Frisbee(save=True)

# Describe your job
jobs = [{'engine': 'bing', 'modifier': 'site:github.com',
         'domain': 'foo.bar', 'limit': 50}]

# Execute the jobs
frisbee.search(jobs)

# Get the results
results = frisbee.get_results()

Example Output

Below is an example job result:

[{
    "engine": "bing",
    "modifier": "site:github.com",
    "domain": "blockade.io",
    "limit": 50,
    "results": {
        "start_time": "2018-12-13 16:54:15",
        "end_time": "2018-12-13 16:54:19",
        "emails": [
            "info@blockade.io"
        ],
        "duration": "4",
        "processed": 44
    },
    "project": "zealous_kirch"
}]

Features

  • Ability to search for email addresses from search engine results
  • Modular design that can be extended easily to include new sources
  • Modifier options that can filter or target search query
  • Limit option to reduce the number of results parsed
  • Greedy option to learn from collected results and fuzzy to find related
  • Save output describing job request and results

Changelog

12-20-18

  • Feature: Added typing to the core code
  • Feature: Added a fuzzy flag to find related domains

12-14-18

  • Feature: Activated greedy option to save and output to screen
  • Bugfix: Wrapped loading of HTML for cases where data is dirty

12-13-18

  • Initial push!

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
frisbee-0.0.4-py3.6.egg (20.7 kB) Copy SHA256 hash SHA256 Egg 3.6
frisbee-0.0.4-py3-none-any.whl (10.8 kB) Copy SHA256 hash SHA256 Wheel py3
frisbee-0.0.4.tar.gz (8.8 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page