Project

phishtank

0.01
No commit activity in last 3 years
No release in over 3 years
Ruby interface to OpenDNS's PhishTank API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.9.0
~> 2.0.0

Runtime

~> 1.5.2
~> 0.3.3
 Project Readme

PhishTank

This is a Ruby interface to OpenDNS's PhishTank developer API. The PhishTank dataset contains quite a bit of human-verified and classified phishing data, if you're into that sort of thing.

Tested against Ruby 1.9.2 and 1.9.3 w/ Travis-CI. Current Build Status: Build Status

Installation

From the Rubygems CLI:

gem install phishtank

or w/ Bundler, add the following to the Gemfile.

gem 'phishtank'

Usage

require 'phishtank'
PhishTank.configure do |c|
  c.api_key = "YOUR_PHISHTANK_API_KEY" #required
  c.temp_directory = "/path/to/temporary/directory" #optional - default: /tmp
  c.etag = "ETag" #optional
end

PhishTank.update_feed!

data = PhishTank::FeedData.new

data.entries.first 
# => #<OpenStruct:0x1021026f8
#    attr_reader :modifiable = true,
#    attr_reader :table = {
#                      :url => "http://www.grovesgas.co.uk/TAMFidelidade/clientetam.htm",
#                 :phish_id => "1389753",
#         :phish_detail_url => "http://www.phishtank.com/phish_detail.php?phish_id=1389753",
#               :ip_address => "209.235.144.9",
#          :submission_time => "2012-03-13T21:46:39+00:00",
#                 :verified => "yes",
#        :verification_time => "2012-03-13T22:51:43+00:00",
#            :online_status => "yes",
#                   :target => "TAM Fidelidade"
#    }
#>

PhishTank.search("http://www.google.com/") #=> false
PhishTank.search("http://suspiciousurl.com/") #=> OpenStruct w/ PhishTank details

Read specs for more details.

TODO

You can see and contribute to the list of TODO items in issues.