Automatically migrated from Gitolite

Sven Slootweg 2f8d3dcca2 1.0.2 4 years ago
lib 8b0e29ae08 td.country contains countryname itself 4 years ago
.gitignore 13fcb0a7cc v1.0.0 5 years ago
README.md 8716784011 v1.0.1: README update (safety warning) 5 years ago
gulpfile.js 13fcb0a7cc v1.0.0 5 years ago
index.coffee 13fcb0a7cc v1.0.0 5 years ago
index.js 13fcb0a7cc v1.0.0 5 years ago
package.json 2f8d3dcca2 1.0.2 4 years ago
test.coffee 13fcb0a7cc v1.0.0 5 years ago

README.md

hma-proxy-parse

Good game, HideMyAss, but I win :)

This module extracts (parses) proxy details including the IP address from http://proxylist.hidemyass.com/ and anything else using the same system, despite their (rather heavy) CSS-based obfuscation.

Note that this module only does the parsing; you're responsible for fetching the source HTML yourself.

Caution!

Public proxies are not safe to use. They can see your IP address and the traffic you send. You are effectively giving the proxy operator full control and knowledge over your browsing, and they may even inject malware in the responses.

If you need to browse the internet privately, consider using Tor instead - however, please make sure to read the caveats that you need to keep in mind. Even with these caveats, Tor is vastly more secure than a public proxy.

License

WTFPL or CC0, whichever you prefer. A donation and/or attribution are appreciated, but not required.

Donate

My income consists entirely of donations for my projects. If this module is useful to you, consider making a donation!

You can donate using Bitcoin, PayPal, Gratipay, Flattr, cash-in-mail, SEPA transfers, and pretty much anything else.

Bitcoins can also be sent to 1KafMHn6YEDFkUSoHK6pKkqqmfJUF5Wd1C directly :)

Contributing

Pull requests welcome. Please make sure your modifications are in line with the overall code style, and ensure that you're editing the .coffee files, not the .js files.

Build tool of choice is gulp; simply run gulp while developing, and it will watch for changes.

Be aware that by making a pull request, you agree to release your modifications under the licenses stated above.

Usage

You can input HTML from any source, but this example uses bhttp in Promises mode.

var hmaProxyParse = require("hma-proxy-parse");
var bhttp = require("bhttp");
var Promise = require("bluebird");

Promise.try(function(){
	return bhttp.get("http://proxylist.hidemyass.com/");
}).then(function(response){
	console.log(hmaProxyParse(response.body.toString()));
});

API

hmaProxyParse(html)

Parses the specified html, and returns an array of objects with proxy information. The objects look something like this:

{
	updateTimestamp: '1422645602',
	ip: '187.108.223.204',
	port: '8080',
	country: 'br',
	speed: '2441',
	connectionTime: '235',
	protocol: 'HTTP',
	anonymity: 'Low'
}

It doesn't attempt to parse the actual data provided - all data is directly as specified in the list, and you'll have to figure out what to do with it. I have no idea, for example, what the bounds on speed or connectionTime are, or what the possible options for anonymity are.

If this helped you, don't forget to donate ;)