Proxy RSS

Description
Change Log
Namespace declaration
Primary Elements
Optional Elements
Examples
Best Practices

Proxy RSS Specification

Proxy RSS enables proxy content publishers to syndicate their proxy content into valid RSS 2.0 feeds.

Since sharing proxy lists via RSS feeds is becoming more and more popular among proxy list publishers there is a need for standardization.

This specification is believed to be fairly 'clean' and simple. Any comments and suggestions are welcome.


Description

"Proxy RSS" is a new RSS module that adds a capability of syndicating proxy lists in RSS 2.0 feeds. RSS protocol allows publishers to syndicate different types of information. Proxy RSS extends this protocol to handle proxy lists including mandatory information about proxy i.e. IP address and port number Also it is possible to specify proxy country, connection latency, proxy reliability, last check date, etc.

Change Log

17/6/2006 - <prx:ssl> tag added

2/3/2006 - Created

Namespace declaration

The namespace for Proxy RSS is defined to be: http://www.proxyrss.com/specification.html

For example:
<rss version="2.0" xmlns:prx="http://www.proxyrss.com/specification.html">

Primary Elements

<prx:proxy> <prx:proxy> is a sub-element of <item>. The sequence of these items implies the order of proxylist presentation. It can contain several tags, only 2 of which are mandatory.

<prx:ip> <prx:ip> is a mandatory sub-element of <prx:proxy>. This tag specifies proxy IP address.

<prx:port> <prx:port> is a mandatory sub-element of <prx:proxy>. This tag specifies proxy port number.

Optional Elements

<prx:type> <prx:type> is an optional sub-element of <prx:proxy>. This tag set a value of proxy type. While there is an unfinished discussion what are the proxy types, we suggest using the following definitions.

question mark Help, what proxy types are suggested for use.

<prx:ssl> <prx:ssl> is an optional sub-element of <prx:proxy>. This tag specify whether a proxy support Secure Socket Layer protocol or not. This parameter takes either TRUE or FALSE as a value.

question mark Help, what is Secure Socket Layer (SSL).

<prx:check_timestamp> <prx:check_timestamp> is an optional sub-element of <prx:proxy>. It allows to specify the time when particular proxy was checked last time. Timestamp can be UNIX time or any other form of time representation.

question mark Help, what is UNIX time.

<prx:country_code> <prx:country_code> is an optional sub-element of <prx:proxy>. Country code tag let you specify proxy's country of origin. The value should satisfy ISO 3166-1 Alpha-2.

question mark Help, what is ISO 3166-1 Alpha-2.

<prx:country> <prx:country> is an optional sub-element of <prx:proxy>. The value of this tag can be a long, maybe inofficial name of the proxy's country.

<prx:latency> <prx:latency> is an optional sub-element of <prx:proxy>. Latency tag characterizes the period of time (in milliseconds) needed to pass a small (1kB of size) document through this proxy.

<prx:reliability> <prx:reliability> is an optional sub-element of <prx:proxy>. Reliability tag can contain a value of proxy reliability. This value can be calculated according on the special formula:

question mark Help, what is the formula for calculating reliability value.

Examples

Below is the sample <prx:proxy> record under <item> tag of the RSS feed.

<item>
	<title>Open Anonymous Proxy List</title>
	<description>Newly checked anonymous proxies</description>
	<prx:proxy>
		<prx:ip>129.242.19.197</prx:ip>
		<prx:port>3128</prx:port>
		<prx:type>Anonymous</prx:type>
		<prx:check_timestamp>2006-02-08 12:47:07</prx:check_timestamp>
		<prx:country_code>PL</prx:country_code>
		<prx:country>Poland</prx:country>
		<prx:latency>2008</prx:latency>
		<prx:reliability>9824</prx:reliability>	
	</prx:proxy>
	...
</item>

Best Practices

While there are many proxy RSS feeds out there that meets the specification, I'll mention here only several of them. They are not better than others, they just proved to be compatible with this specification.


© 2006 proxyRSS.com
proxyRSS.com    Valid XHTML 1.0 Transitional Valid CSS!