i'm too tired to write a good readme so heres a tutorial:

1. install mtcrackcha using npm or bun or whatever the latest pacakge manager is
2. create a new class

import MTCaptcha from 'mtcrackcha';

const mtc = new MTCaptcha({
    siteKey: 'MTPublic-THISISAKEY',
    testKey: 'MTPrivQA-ThisIsAMuchLongerKeyThatMayNotBeUsedOnSomeWebsites',
    host: 'https://google.com',
    geminiKey: 'AIzaSyGeminiApiKeyGoesHere'
});

you can get the sitekey by typing mtcaptchaConfig.sitekey into the console of the website and copying the output you can get the testkey by typing mtcaptchaConfig.enableTestMode into the console of the website - if it's null, that's normal

the host is the URL beginning (can have subdomain) where you solved the captcha

the gemini key is a gemini api key, wowzers not shocking

there is 1 method: mtc.solve

const solution = await mtc.solve('act_goes_here');
if (solution.success) console.log('got mtcaptcha token', solution.token);
else console.log('whelp, time to try it again');

you can get the act by:

1. going onto the site where there is a captcha
2. open the browser console (before the cap loads)
3. waiting for the captcha to load
4. go to network and filter by getchallenge.json
5. click on it
6. go to payload tab
7. looking at the act value

chances are the act is $, which means there is no act and you can pass nothing as the lib will fill it

if it's an invisible challenge, you don't need a gemini key (but you must make sure to put the testkey) - invisible challenges are solved in <1s