Skip to main content

Python wrapper for cleanweb API of Yandex to fight spam.

Project description

https://travis-ci.org/coagulant/cleanweb.png?branch=master https://coveralls.io/repos/coagulant/cleanweb/badge.png?branch=master

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

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'}
http://habrastorage.org/storage2/1a3/fda/5f4/1a3fda5f431fe7be4ed116220d383d40.png
  • check captcha:

    >> client.check_captcha(captcha='20_iC0ZHRYtEllRhgEAngpsenpKGCIyi', value='48151632')
    True
  • complain on spam detector:

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

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page