Cleanweb

Python wrapper for cleanweb API of Yandex to fight spam.

Yandex.Clean Web helps against spam in text message in comments, on forums, etc. It detects spam messages based on their content and offers API for graphic CAPTCHA. Technlogies that power Yandex.Mail spam defence are behind Yandex.Clean Web.

Install

Install via pip:
```
pip install cleanweb
```
If you understand and accept licence agreement you need to Obtain mandatory API key (yandex login is required)

API is provided as is

Usage

Examples show basic usage of cleanweb api, for details check sources and docs:

>> from cleanweb import Cleanweb
>> client = Cleanweb(key='cw.1.1.fc4c0c5c3be05adb04c9400214T193305Z')

check if message contains spam:

>> client.check_spam(body='This might be some spam message')
{'id': '036151771200000F', 'links': [], 'spam_flag': False}

get captcha to show bots:

>> client.get_captcha()
{'captcha': '20_iC0ZHRYtEllRhgEAngpsenpKGCIyi',
 'url': 'http://i.captcha.yandex.net/image?key=20_iC0ZHRYtEllRhgEAngpsenpKGCIyi'}

check captcha:

>> client.check_captcha(captcha='20_iC0ZHRYtEllRhgEAngpsenpKGCIyi', value='48151632')
True

complain on spam detector:

>> client.complain(id='036151771200000F', is_spam=False)
True

Добавлена возможность указывать тип каптчи

Теперь при получении каптчи можно указать вид изображения каптчи

>> client.get_captcha(captcha_type='std')
#std — цифры, русскоязычный логотип;
#estd — цифры, англоязычный логотип;
#lite — простые для чтения цифры, русскоязычный логотип;
#elite — простые для чтения цифры, англоязычный логотип;
#rus — русские буквы, русскоязычный логотип;
#latl — латинские строчные буквы , русскоязычный логотип;
#elatl — латинские строчные буквы, англоязычный логотип;
#latu — латинские прописные буквы, русскоязычный логотип;
#elatu — латинские прописные буквы, англоязычный логотип;
#latm — латинские буквы смешанного регистра, русскоязычный логотип;
#elatm — латинские буквы смешанного регистра, англоязычный логотип.
#По умолчанию type=std.

simon-db/cleanweb

Cleanweb

Install

Usage

Добавлена возможность указывать тип каптчи