google-gather - Leverage the power of Google(tm) to catch abuse complaints


    google-gather [-h] [-v] [-d delimiter] [-c count] [-m max] -s search


One very important source of abuse complaints is the news group News.Admin.Net-Abuse.Sightings or NANAS. At NANAS, many activists place samples of abuse that are captured at remote sites and that, ideally, serve as an indication that corrections are needed.

google-gather fetches complaints from NANAS and produces an output suitable as input to abuso through the Mail::Abuse::Reader::Stdin module.

Do not abuse this script

In general, it is not polite to send large numbers of queries to a host, as this might be interpreted as an attack. This is true, even if said host is Google. Use this scipt judiciously and avoid long and repeated queries.

The following options are recognized:


Outputs this documentation.


Be verbose about progress.

What to search for. Typically, this should be your domain name.

-d delimiter

Text string used to separate reports. See Mail::Abuse::Reader::Stdin for an application of this delimiter. Defaults to ___END_OF_REPORT___.

-c count

How many reports to extract from NANAS. No more than this number of reports will be processed. Defaults to 20.

-m max count

The maximum number of articles that will be spidered by this script. Defaults to 1000.

The complaint should be fed through STDIN, as the output of acat would.


Jan, 2004

First version of this code.


This code and all accompanying software comes with NO WARRANTY. You use it at your own risk.

This code and all accompanying software can be used freely under the same terms as Perl itself.


Luis E. Muñoz <>


perl(1), acat(1), WWW::Mechanize(3)

1 POD Error

The following errors were encountered while parsing the POD:

Around line 177:

Non-ASCII character seen before =encoding in 'Muñoz'. Assuming ISO8859-1