Skip to content

SpiderFoot automates OSINT for threat intelligence and mapping your attack surface.

New module for hunter.io searches.

Steved2261013d471
diff --git a/modules/sfp_hunter.py b/modules/sfp_hunter.py
new file mode 100644
index 00000000..03ebcdf5
--- /dev/null
+++ b/modules/sfp_hunter.py
@@ -0,0 +1,106 @@
+#-------------------------------------------------------------------------------
+# Name: sfp_hunter
+# Purpose: Query hunter.io using their API.
+#
+# Author: Steve Micallef <[email protected]>
+#
+# Created: 22/02/2017
+# Copyright: (c) Steve Micallef
+# Licence: GPL
+#-------------------------------------------------------------------------------
+
+import sys
+import json
+import time
+from sflib import SpiderFoot, SpiderFootPlugin, SpiderFootEvent
+
+class sfp_hunter(SpiderFootPlugin):
+ """Hunter,io:Footprint,Investigate,Passive:Search Engines:apikey:Check for e-mail addresses and names on hunter.io."""
+
+ # Default options
+ opts = {
+ "apikey": ""
+ }
+
+ # Option descriptions
+ optdescs = {
+ "apikey": "Your API key from hunter.io."
+ }
+
+ # Be sure to completely clear any class variables in setup()
+ # or you run the risk of data persisting between scan runs.
+
+ results = dict()
+
+ def setup(self, sfc, userOpts=dict()):
+ self.sf = sfc
+ self.results = dict()
+
+ # Clear / reset any other class member variables here
+ # or you risk them persisting between threads.
+
+ for opt in userOpts.keys():
+ self.opts[opt] = userOpts[opt]
+
+ # What events is this module interested in for input
+ def watchedEvents(self):
+ return [ "DOMAIN_NAME" ]
+
+ # What events this module produces
+ def producedEvents(self):
+ return [ "EMAILADDR", "HUMAN_NAME" ]
+
+ def query(self, t):
+ ret = None
+
+ url = "https://api.hunter.io/v2/domain-search?domain=" + t + "&api_key=" + self.opts['apikey']
+
+ res = self.sf.fetchUrl(url, timeout=self.opts['_fetchtimeout'],
+ useragent="SpiderFoot")
+
+ if res['code'] in [ 404, "404" ]:
+ return None
+
+ try:
+ ret = json.loads(res['content'])['data']
+ except Exception as e:
+ self.sf.error("Error processing JSON response from hunter.io: " + str(e), False)
+ return None
+
+ return ret
+
+ # Handle events sent to this module
+ def handleEvent(self, event):
+ eventName = event.eventType
+ srcModuleName = event.module
+ eventData = event.data
+
+ self.sf.debug("Received event, " + eventName + ", from " + srcModuleName)
+
+ # Don't look up stuff twice
+ if self.results.has_key(eventData):
+ self.sf.debug("Skipping " + eventData + " as already mapped.")
+ return None
+ else:
+ self.results[eventData] = True
+
+ data = self.query(eventData)
+ if data == None:
+ return None
+
+ if 'emails' not in data:
+ return None
+
+ for email in data['emails']:
+ # Notify other modules of what you've found
+ e = SpiderFootEvent("EMAILADDR", email['value'], self.__name__, event)
+ self.notifyListeners(e)
+
+ if 'first_name' in email and 'last_name' in email:
+ if email['first_name'] != None and email['last_name'] != None:
+ n = email['first_name'] + " " + email['last_name']
+ e = SpiderFootEvent("HUMAN_NAME", n, self.__name__, event)
+ self.notifyListeners(e)
+
+
+# End of sfp_hunter class