Metadata-Version: 2.1
Name: captcha9kw
Version: 0.1.0
Summary: A simple package for interacting with the 9kw.eu anti-captcha service.
Home-page: https://github.com/WereCatf/captcha9kw/
License: MIT
Author: WereCatf
Author-email: werecatf@outlook.com
Maintainer: WereCatf
Maintainer-email: werecatf@outlook.com
Requires-Python: >=3.7,<4.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: filetype (>=1.0.8,<2.0.0)
Requires-Dist: importlib-metadata (>=1.0,<2.0); python_version < "3.8"
Requires-Dist: requests (>=2.26.0,<3.0.0)
Requires-Dist: validators (>=0.18.2,<0.19.0)
Project-URL: Documentation, https://captcha9kw.readthedocs.io/
Project-URL: Repository, https://github.com/WereCatf/captcha9kw/
Description-Content-Type: text/x-rst


Welcome to captcha9kw’s documentation!
**************************************

captcha9kw is a smallish Python package for making use of the
`9kw.eu`_ services, including solving of interactive captchas like
Google’s reCaptcha or image-based captchas used by a lot of different
services out there.

Important: This package is under construction and functionality may change.


Installation
============

You can install captcha9kw from PyPI using pip:

.. code:: shell

   $ pip install captcha9kw


Getting started
===============

Solving a simple image-based captcha is pretty easy:

   .. image:: docs/source/_static/captcha.gif

   The captcha used here.

image-captcha

.. code:: python

   from captcha9kw import api9kw

   conn = api9kw()
   conn.api_key = "myapikeyhere"
   print(f"Current account balance: {conn.balance} credits.")
   captcha_id = conn.submit_image_captcha("mycaptcha.gif")
   answer = conn.get_answer(captcha_id, wait=1)
   if(answer == "spring water"):
       conn.captcha_feedback_correct(captcha_id)
   else:
       conn.captcha_feedback_incorrect(captcha_id)

Similarly, for e.g. a reCaptcha:

interactive captcha

.. code:: python

   from captcha9kw import api9kw

   conn = api9kw()
   conn.api_key = "myapikeyhere"
   print(f"Current account balance: {conn.balance} credits.")
   website_url = "https://www.some.web.site"
   website_key = obtain_site_key() # Supply your own code here
   captcha_id = conn.submit_interactive_captcha(website_key, website_url)
   answer = conn.get_answer(captcha_id, wait=1)
   if(test_answer_on_site(answer)):
       conn.captcha_feedback_correct(captcha_id)
   else:
       conn.captcha_feedback_incorrect(captcha_id)

For more information, check the `API Reference
<api_reference.rst#api-reference>`_.


9kw.eu
======

9kw.eu is a German captcha-solving service, providing a quick and easy
API over HTTP GET/POST. Users can buy credits that will be deducted
from based on the type of captcha in question and related settings. As
a nice bonus, users can also earn credits for themselves by solving
other people’s captchas, either through the website directly or
through their custom client.

You can sign up for their service at: https://www.9kw.eu/register.html

Or, if you really wish to grant me a couple of free credits, sign up
using my referral link: https://www.9kw.eu/register.html?r=210326

Note: Do not feel any pressure to use the referral link! I know a lot of
   people feel iffy about such and I do not feel offended, if you
   prefer to not add me as your referrer.

Also, maybe take a look at `their API <https://www.9kw.eu/api.html>`_.

