SpamCop Denouncer, computer aided spam reporting
SpamCop Denouncer is a tool to automate the confirmation process of reports generated by SpamCop.
SpamCop is a service to parse spam emails, analyse their headers and find out who are the people responsible, either spam sources or carriers (eg, open proxies).
After you have sent your spam to SpamCop, it will send back an email with a special link that points to the analysis. From that page you can also send detailed reports to ISPs, server owners, and various carriers.
Analysing many spam emails can be long and painful, because you must navigate through many pages and send many confirmations. How much is the time you waste:
* finding the links, clicking,
* waiting for a new window or tab to open and to load the URL,
* then moving through these pages to read the report,
* eventually confirm and wait for the reports to be sent?
So SpamCop Denouncer speed up the find-click-load-send part of that procedure. The analysis cannot be skipped: at least you must check you are not denouncing your self or improbable organisations.
It works like that:
1a) Use -f option to download messages from a POP3 account (using fetchmail), and save them to input file.
1b) Use -r <path> to read form a different input file, without fetching anything.
1c) Use -m <path> to read emails from a mailbox and report them via the spamcop web form.
(see the help for more options, spamcop -h)
2 ) Get all spamcop reporting URLS from the input file/web form
3 ) Download all spamcop analysis pages and parse them. No interaction required.
4 ) For each spam-id, present a dialog screen where you can see and select which recipients your report will have. That process is very quick as all information is already locally available. If you are not sure of what you are doing, you can see the full analysis, which was saved to a temporary file in (3) so you have not to download it again. Then, you might pick off some recipients, then Cancel the report or accept it.
5 ) That done, all accepted reports will be sent in one shoot to the selected recipients. No interaction needed
After you download spamcop.py.txt, open it with a text editor and modify the initial settings. Put in your spamcop ID and password, and edit the "Special paths" at your preference.
less (or another text viewer, configure it in browser=)
-h --help Print this help
SPAM SOURCE OPTIONS:
-i <id,id...> --id=<id,id...> Process comma-separed SpamCop IDs
-q --queue Process all your unreported spam at spamcop.net queue (very slow)
-f --fetch Download new email to a file and get SpamCop IDs from it.
-r <path> --read=<path> Read from file <path> instead of downloading/pasting
-p --paste Read file is standard input
-m <mbox> --mbox <mbox> Read an mbox of spam messages and report them via the spamcop web interface.
-n <msg> --notes=<msg> Send <msg> within each report
-s --safe Safe reporting (default)
-u --unsafe VERY DANGEROUS - Automated reporting
--no-keep --nk -d Don't keep mail/read file/mbox
-k --keep Keep downloaded mail/read file/mbox after reporting (default)
-c --clear Clear the SpamCop ID and hash cache (forget about already processed IDs)
-S<d[,t]> --stats=<d[,t]> Print statistics collected since the first run date, then exit.
It will print some global stats, the reporting activity by <d>-days periods, the top <t=10> report recipent's domains.
The most significant data are the SHI cost estimations. They mean "Seconds of Human Interaction", calculated
from the _response_ to the first spam analysis prompt (dialog) till the end of the analysis.
SHI values resume the time wasted due to the reporting activity.
MUTUALLY EXCLUSIVE OPTIONS:
These options cannot be set at the same time:
fetch, read, idmode / f, r, i
fetch, mbox, idmode / f, m, i
fetch, read, paste / f, r, p
keep, id / k, i
keep, paste / k, p
Using: --paste --mbox. , you can paste your spam message to stdin and report it as you would do with the web form.
If any <var>=. the defaults will be used. Example: spamcop -r. , will use the read file option
hardcoded in the program header.
In v0.2 I added some statistics, those are mine ;)
STATISTICS since 05/27/08 (1 day period):
Reporting quality: 1.687h of mean spam age
Total time cost: 927.9shi, efficiency: 0.9s/spam
Processed: 1137, 162.4/period - Reported: 1041, 148.7/period
Reporting activity (1 day period):
day processed reported sessions cost quality
05/27/08 16 16 2 0.00 0.00
05/28/08 179 178 13 106.82 0.00
05/29/08 292 250 14 245.41 0.00
05/30/08 185 183 13 189.44 2.01
05/31/08 142 138 9 223.98 1.91
06/02/08 141 96 1 21.42 5.41
06/03/08 182 180 5 140.83 3.36
Overall top 10 report destinations
You can download SpamCop Denouncer from the following links: