https://github.com/gotlium/antigate

Wrapper for online service which provides real-time captcha-to-text decodings. http://anti-captcha.com/
https://github.com/gotlium/antigate

Last synced: about 2 months ago
JSON representation

Wrapper for online service which provides real-time captcha-to-text decodings. http://anti-captcha.com/

• Host: GitHub
• URL: https://github.com/gotlium/antigate
• Owner: gotlium
• License: gpl-3.0
• Created: 2013-04-11T11:35:27.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2023-05-23T07:19:26.000Z (over 1 year ago)
• Last Synced: 2024-07-22T15:42:38.734Z (2 months ago)
• Language: Python
• Homepage: http://antigate.com/
• Size: 74.2 KB
• Stars: 91
• Watchers: 8
• Forks: 21
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • Contributing: docs/contributing.rst
  • License: LICENSE
  • Authors: AUTHORS.rst

Awesome Lists containing this project

README

        
Real-time captcha-to-text decodings

===================================

.. image:: https://api.travis-ci.org/gotlium/antigate.png?branch=master

    :alt: Build Status

    :target: https://travis-ci.org/gotlium/antigate

.. image:: https://coveralls.io/repos/gotlium/antigate/badge.png?branch=master

    :target: https://coveralls.io/r/gotlium/antigate?branch=master

.. image:: https://img.shields.io/badge/python-2.6,2.7,3.3,3.4,3.5-blue.svg

    :alt: Python 2.6, 2.7, 3.3, 3.4, 3.5

    :target: https://pypi.python.org/pypi/antigate/

.. image:: https://img.shields.io/pypi/v/antigate.svg

    :alt: Current version on PyPi

    :target:https://pypi.python.org/pypi/antigate/

.. image:: https://img.shields.io/pypi/dm/antigate.svg

    :alt: Downloads from PyPi

    :target:https://pypi.python.org/pypi/antigate/

.. image:: https://img.shields.io/badge/license-GPLv2-green.svg

    :target: https://pypi.python.org/pypi/antigate/

    :alt: License

Documentation available `here `_.

Installation

------------

From source:

.. code-block:: bash

    $ git clone https://github.com/gotlium/antigate.git

    $ cd antigate && python setup.py install

From PyPi:

.. code-block:: bash

    $  pip install antigate

**Requirements:**

You can use grab/requests/urllib as http backends.

`Grab` installation:

.. code-block:: bash

    pip install grab pycurl

`Requests` installation:

.. code-block:: bash

    pip install requests

`UrlLib` used by default.

Usage

-----

.. code-block:: python

    >>> from antigate import AntiGate            # AntiCaptcha

    # per line example

    >>> print AntiGate('API-KEY', 'captcha.jpg') # AntiCaptcha('API-KEY', filename or base64 or bytes)

    # or like this

    >>> gate = AntiGate('API-KEY')               # AntiCaptcha('API-KEY')

    >>> captcha_id = gate.send('captcha.jpg')

    >>> print gate.get(captcha_id)

If you wish to complain about a mismatch results, use ``abuse`` method:

.. code-block:: python

    >>> from antigate import AntiGate

    >>> gate = AntiGate('API-KEY', 'captcha.jpg')

    >>> if str(gate) != 'qwerty':

    >>>     gate.abuse()

After all manipulations, you can get your account balance:

.. code-block:: python

    >>> print gate.balance()

Or get your statistics data:

.. code-block:: python

    >>> print gate.stats()

System load info:

.. code-block:: python

    >>> print gate.load()

Customizing requests to API

---------------------------

Customize grab-lib preferences:

.. code-block:: python

    >>> from antigate import AntiGate

    >>> config = {'connect_timeout': 5, 'timeout': 60}

    >>> gate = AntiGate('API-KEY', 'captcha.jpg', grab_config=config)

    >>> print gate

Additional options for sending Captcha:

.. code-block:: python

    >>> from antigate import AntiGate

    >>> config = {'min_len': '3', 'max_len': '5', 'phrase': '2'}

    >>> gate = AntiGate('API-KEY', 'captcha.jpg', send_config=config)

    >>> print gate

Use all methods manually:

.. code-block:: python

    >>> from antigate import AntiGate

    >>> gate = AntiGate('API-KEY')

    >>> captcha_id1 = gate.send('captcha1.jpg')

    >>> captcha_id2 = gate.send('captcha2.jpg')

    >>> print gate.get(captcha_id1)

    >>> print gate.get(captcha_id2)

Get results for multiple ids:

.. code-block:: python

    >>> gate = AntiGate('API-KEY')

    >>> captcha_id1 = gate.send('captcha1.jpg')

    >>> captcha_id2 = gate.send('captcha2.jpg')

    >>> print gate.get_multi([captcha_id1, captcha_id2])

If you want use bytes or base64:

.. code-block:: python

    # Per line binary example

    >>> print AntiGate('API-KEY', fp.read())

    # Per line base64 example

    >>> print AntiGate('API-KEY', b64encode(fp.read()))

    # Custom requests

    >>> gate = AntiGate('API-KEY')

    # base64

    >>> captcha_id = gate.send(b64encode(fp.read()))

    # or stream

    >>> captcha_id = gate.send(fp.read())

    >>> print gate.get(captcha_id)

Api documentation

-----------------

https://anti-captcha.com/apidoc / http://antigate.com/?action=api#algo

Compatibility

-------------

* Python: 2.6, 2.7, 3.3, 3.4, 3.5

.. image:: https://d2weczhvl823v0.cloudfront.net/gotlium/antigate/trend.png

   :alt: Bitdeli badge

   :target: https://bitdeli.com/free