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