pynocaptcha 3.0.7__py3-none-any.whl

pynocaptcha/__init__.py

@@ -0,0 +1,63 @@
+# -*- coding: UTF-8 -*-
+
+
+from .akamai import AkamaiV2Cracker
+from .aws import AwsUniversalCracker
+from .cloudflare import CloudFlareCracker
+from .discord import DiscordCracker
+from .hcaptcha import HcaptchaCracker
+from .incapsula import (IncapsulaRbzidCracker,
+                                 IncapsulaReese84Cracker,
+                                 IncapsulaUtmvcCracker)
+from .recaptcha import (ReCaptchaAppCracker,
+                                 ReCaptchaEnterpriseCracker,
+                                 ReCaptchaSteamCracker,
+                                 ReCaptchaUniversalCracker)
+from .datadome import crack_datadome, async_crack_datadome
+from .kasada import KasadaCdCracker, crack_kasada, async_crack_kasada
+from .perimeterx import PerimeterxCracker, crack_perimeterx, async_crack_perimeterx
+from .shape import crack_shape_v1, async_crack_shape_v1, crack_shape_v2, async_crack_shape_v2
+from .tls import TlsV1Cracker
+
+from .unlocker import Unlocker, AsyncUnlocker, run_unlocker, async_run_unlocker
+from .unlocker import KohlCheckBalanceParams, LululemonCheckBalanceParams, WbiParams, DicksCheckBalanceParams
+from .unlocker import FinishlineCheckBalanceParams, FootlockerCheckBalanceParams, ReiCheckBalanceParams
+from .unlocker import One4AllCheckBalanceParams, SaksCheckBalanceParams, CoachCheckBalanceParams
+from .unlocker import FandangoCheckBalanceParams, ColumbiaCheckBalanceParams, HomeDepotCheckBalanceParams
+from .unlocker import EtsyRegisterParams, PrizepicksLoginParams, FifaLoginParams
+from .unlocker import AuspostTrackParams, NorseSearchFlightsParams, ScootBookingParams
+from .unlocker import MyPrepaidValidateParams, PBandaiCartParams, MicrosoftCreateParams
+from .unlocker import GodaddyLoginParams, UltimateDiningLoginParams, FlightInfo, PassengerInfo
+from .unlocker import AjetAvailabilityParams, AttCheckParams, EasyjetFindParams, AjetPnrLoginParams
+from .unlocker import EurowingsBookingParams, FastPeopleSearchParams, HiltonTokenParams, AjetGetBookingDetailParams
+from .unlocker import HiltonCustomerParams, KoreanAirLoginParams, MaerskTokenParams, MarriottLoginParams
+from .unlocker import MarriottEnrollParams, PokemonLoginParams, PokemonLotteryListParams, PokemonApplyLotteryParams
+from .unlocker import SephoraCheckBalanceParams, TextnowLoginParams, WalmartCheckBalanceParams, WalmartCaCheckBalanceParams
+from .unlocker import WalmartWalletParams, FlightSegment, WizzairSearchParams, HmCheckBalanceParams
+
+
+__all__ = [
+    'pynocaptcha', 'magneto',
+    'CloudFlareCracker', 'IncapsulaReese84Cracker', 'IncapsulaUtmvcCracker', 'IncapsulaRbzidCracker', 'HcaptchaCracker', 
+    'AkamaiV2Cracker', 'ReCaptchaUniversalCracker', 'ReCaptchaEnterpriseCracker', 'ReCaptchaSteamCracker',
+    'TlsV1Cracker', 'DiscordCracker', 'ReCaptchaAppCracker', 'AwsUniversalCracker', 'PerimeterxCracker', 'KasadaCdCracker', 
+    'crack_datadome', 'async_crack_datadome',
+    'crack_kasada', 'async_crack_kasada', 'crack_perimeterx', 'async_crack_perimeterx',
+    'crack_shape_v1', 'async_crack_shape_v1', 'crack_shape_v2', 'async_crack_shape_v2',
+    
+    'Unlocker', 'AsyncUnlocker', 'run_unlocker', 'async_run_unlocker',
+    'KohlCheckBalanceParams', 'LululemonCheckBalanceParams', 'WbiParams', 'DicksCheckBalanceParams', 
+    'FinishlineCheckBalanceParams', 'FootlockerCheckBalanceParams', 'ReiCheckBalanceParams', 
+    'One4AllCheckBalanceParams', 'SaksCheckBalanceParams', 'CoachCheckBalanceParams', 
+    'FandangoCheckBalanceParams', 'ColumbiaCheckBalanceParams', 'HomeDepotCheckBalanceParams', 
+    'EtsyRegisterParams', 'PrizepicksLoginParams', 'FifaLoginParams', 'AuspostTrackParams', 
+    'NorseSearchFlightsParams', 'ScootBookingParams', 'MyPrepaidValidateParams', 'PBandaiCartParams', 
+    'MicrosoftCreateParams', 'GodaddyLoginParams', 'UltimateDiningLoginParams', 'FlightInfo', 
+    'PassengerInfo', 'AjetAvailabilityParams', 'AttCheckParams', 'EasyjetFindParams', 
+    'EurowingsBookingParams', 'FastPeopleSearchParams', 'HiltonTokenParams', 'HiltonCustomerParams', 
+    'KoreanAirLoginParams', 'MaerskTokenParams', 'MarriottLoginParams', 'MarriottEnrollParams', 
+    'PokemonLoginParams', 'PokemonLotteryListParams', 'PokemonApplyLotteryParams', 'AjetPnrLoginParams',
+    'SephoraCheckBalanceParams', 'TextnowLoginParams', 'WalmartCheckBalanceParams', 'AjetGetBookingDetailParams',
+    'WalmartCaCheckBalanceParams', 'WalmartWalletParams', 'FlightSegment', 'WizzairSearchParams', 
+    'HmCheckBalanceParams'
+]

pynocaptcha/akamai.py

@@ -0,0 +1,45 @@
+# -*- coding: UTF-8 -*-
+
+from .base import BaseCracker, get_ipinfo
+
+
+class AkamaiV2Cracker(BaseCracker):
+
+    cracker_name = "akamai"
+    cracker_version = "v2"
+
+    """
+    akamai v2 cracker
+    :param href: 触发验证的页面地址
+    :param proxy: 业务代理, 服务使用该代理完成验证
+    :param user_agent: 自定义 user_agent
+    :param country/ip/timezone/geolocation: 出口属地信息, 不传时自动请求 ipinfo.io/json
+    调用示例:
+    cookies = AkamaiV2Cracker(
+        user_token="xxx",
+        href="xxx",
+        proxy="user:pass@ip:port",
+    ).crack()
+    # cookies = {"_abck": "...", "bm_sz": "...", ...}
+    """
+
+    # 必传参数
+    must_check_params = ["href"]
+    # 默认可选参数
+    option_params = {
+        "branch": "Master",
+        "proxy": None,
+        "country": None,
+        "ip": None,
+        "timezone": None,
+        "geolocation": None,
+        "user_agent": None,
+    }
+
+    def request(self):
+        # 未显式传入的属地信息, 走 proxy 请求 ipinfo.io/json 补齐后再提交
+        for k, v in get_ipinfo(self.proxy).items():
+            self.wanda_args.setdefault(k, v)
+
+    def response(self, result):
+        return result or {}

pynocaptcha/aws.py

@@ -0,0 +1,35 @@
+# -*- coding: UTF-8 -*-
+
+
+from .base import BaseCracker
+
+
+class AwsUniversalCracker(BaseCracker):
+    cracker_name = "aws"
+    cracker_version = "universal"
+
+    """
+    aws universal cracker
+    :param href: 触发验证的页面地址
+    :param user_agent: 请求头
+    调用示例:
+    cracker = AwsUniversalCracker(
+        user_token="xxx",
+        href="xxx",
+
+        # debug=True,
+        # proxy=proxy,
+    )
+    ret = cracker.crack()
+    """
+
+    # 必传参数
+    must_check_params = ["href"]
+    # 默认可选参数
+    option_params = {
+        "user_agent": "",
+        "only_sense" : False,
+        "challenge_url": "",
+        "api_key": "",
+        "html": ""
+    }

pynocaptcha/base.py

@@ -0,0 +1,262 @@
+# -*- coding: UTF-8 -*-
+
+from typing import Any
+
+from curl_cffi import requests
+from loguru import logger
+
+
+IPINFO_URL = "https://ipinfo.io/json"
+
+
+def _proxy_url(proxy):
+    if proxy and isinstance(proxy, str) and "://" not in proxy:
+        return "http://" + proxy
+    return proxy
+
+
+def _parse_ipinfo(resp: dict) -> dict:
+    return {
+        k: v for k, v in {
+            "country": (resp.get("country") or "").lower() or None,
+            "ip": resp.get("ip"),
+            "timezone": resp.get("timezone"),
+            "geolocation": resp.get("loc"),
+        }.items() if v
+    }
+
+
+def get_ipinfo(proxy: str = None, timeout: int = 5) -> dict:
+    """请求 ipinfo.io/json 获取出口 ip 的 country/ip/timezone/geolocation。
+
+    走业务代理请求, 保证属地信息与实际出口一致; 失败返回空 dict, 不阻断验证。
+    """
+    try:
+        resp = requests.get(
+            IPINFO_URL, proxy=_proxy_url(proxy), timeout=timeout,
+        ).json()
+        return _parse_ipinfo(resp)
+    except Exception as e:
+        logger.debug(f"获取 ipinfo 失败: {e}")
+        return {}
+
+
+async def async_get_ipinfo(proxy: str = None, timeout: int = 5) -> dict:
+    """get_ipinfo 的异步版本。"""
+    try:
+        async with requests.AsyncSession() as session:
+            resp = (await session.get(
+                IPINFO_URL, proxy=_proxy_url(proxy), timeout=timeout,
+            )).json()
+        return _parse_ipinfo(resp)
+    except Exception as e:
+        logger.debug(f"获取 ipinfo 失败: {e}")
+        return {}
+
+
+def resolve_ipinfo(proxy: str = None, country: str = None, ip: str = None,
+                   timezone: str = None, geolocation: str = None) -> dict:
+    """显式传入的属地信息优先, 缺项时请求 ipinfo.io/json 补齐。"""
+    explicit = {
+        k: v for k, v in {
+            "country": country,
+            "ip": ip,
+            "timezone": timezone,
+            "geolocation": geolocation,
+        }.items() if v
+    }
+    if len(explicit) == 4:
+        return explicit
+    info = get_ipinfo(proxy)
+    info.update(explicit)
+    return info
+
+
+async def async_resolve_ipinfo(proxy: str = None, country: str = None, ip: str = None,
+                               timezone: str = None, geolocation: str = None) -> dict:
+    """resolve_ipinfo 的异步版本。"""
+    explicit = {
+        k: v for k, v in {
+            "country": country,
+            "ip": ip,
+            "timezone": timezone,
+            "geolocation": geolocation,
+        }.items() if v
+    }
+    if len(explicit) == 4:
+        return explicit
+    info = await async_get_ipinfo(proxy)
+    info.update(explicit)
+    return info
+
+
+
+class BaseCracker:
+    
+    # 破解器
+    cracker_name = "base"
+    
+    # 破解版本
+    cracker_version = "universal"
+    
+    # 必须参数列表
+    must_check_params = []
+    
+    # 可选参数
+    option_params = {}
+    
+    # 需要删除的多余参数
+    delete_params = []
+    
+    _extra_data = None
+    
+    def __init__(
+        self,   
+        show_ad=True, 
+        user_token: str = None,
+        developer_id: str = None,   
+        internal_host: bool = False,
+        # user_agent: str = None,
+        # cookies: dict = {},
+        # proxy: str = None, 
+        # timeout: int = 30,
+        # debug: bool = False,
+        # check_useful: bool = False,
+        # max_retry_times: int = 3,
+        # internal=True,
+        # auth=False,
+        **kwargs
+    ) -> None:
+        """
+        :param user_token: nocaptcha.io 用户 token
+        :param developer_id: nocaptcha.io 用户上级代理 token
+        :param user_agent: 请求流程使用 ua
+        :param proxy: 请求流程代理, 不传默认使用系统代理, 某些强制要求代理一致或者特定区域的站点请传代理, 支持协议 http/https/socks5, 代理格式: {protocol}://{ip}:{port}（如有账号验证：{protocol}://{user}:{password}@{ip}:{port}）
+        :param timeout: 破解接口超时时间(秒)
+        :param debug: 是否开启 debug 模式
+        :param check_useful: 检查破解是否成功
+        :param max_retry_times: 最大重试次数
+        :param internal: 是否使用国内代理
+        :param auth: 是否大户通道验证模式
+        :param internal_host: 是否使用国内域名 api.nocaptcha.cn, 默认 api.nocaptcha.io
+        """
+        if show_ad:
+            logger.debug("感谢选择 nocaptcha, 我们只做别人做不到的(手动狗头)~")
+            logger.debug("欢迎推荐注册, 官网地址: https://www.nocaptcha.io/")
+        self.user_token = user_token
+        if not self.user_token:
+            raise Exception("缺少用户凭证")
+        self.developer_id = developer_id
+        self.cookies = kwargs.get("cookies") or {}
+        self.user_agent = kwargs.get("user_agent")
+        self.proxy = kwargs.get("proxy")
+        self.timeout = kwargs.get("timeout") or 30
+        self.debug = kwargs.get("debug", False)
+        self.check_useful = kwargs.get("check_useful", False)
+        self.max_retry_times = kwargs.get("max_retry_times", 3)
+        self.api_host = 'api.nocaptcha.cn' if internal_host else 'api.nocaptcha.io'
+        self.wanda_args = {
+            "internal": kwargs.get('internal', True),
+            "is_auth": kwargs.get('auth', False),
+            "timeout": self.timeout
+        }
+        for k in self.must_check_params:
+            _v = kwargs.get(k)
+            if not hasattr(self, k) or getattr(self, k) is None:
+                setattr(self, k, _v)
+            if _v is not None:
+                self.wanda_args.update({ k: _v })
+        for k, v in self.option_params.items():
+            _v = kwargs.get(k, v)
+            if not hasattr(self, k) or getattr(self, k) is None:
+                setattr(self, k, _v)
+            if _v is not None:
+                self.wanda_args.update({ k: _v })
+        
+        for k in self.delete_params:
+            if k in self.wanda_args:
+                del self.wanda_args[k]
+
+        for k in self.must_check_params:
+            if getattr(self, k) is None:
+                raise AttributeError(f"缺少参数 {k}, 请检查")
+
+        if self.user_agent:
+            self.wanda_args["user_agent"] = self.user_agent
+        if self.cookies:
+            self.wanda_args["cookies"] = self.cookies
+        if self.proxy:
+            self.wanda_args["proxy"] = self.proxy
+
+        self.request()
+        
+    def request(self):
+        pass
+    
+    def response(self, result: Any):
+        return result
+        
+    def check(self, ret):
+        return True
+
+    def extra(self):
+        return self._extra_data
+    
+    def fix_headers(self, headers: dict):
+        for k, _ in headers.items():
+            k = k.lower()
+            if k in [
+                "sec-ch-ua", 
+                "accept-language",
+                'sec-ch-ua-arch',
+                'sec-ch-ua-bitness',
+                'sec-ch-ua-full-version',
+                'sec-ch-ua-full-version-list',
+                'sec-ch-ua-mobile',
+                'sec-ch-ua-model',
+                'sec-ch-ua-platform',
+                'sec-ch-ua-platform-version',
+                "user-agent",
+            ] and self._extra_data.get(k):
+                headers[k] = self._extra_data[k]            
+
+    def crack(self):
+        headers = {
+            "User-Token": self.user_token
+        }
+        if self.developer_id:
+            headers["Developer-Id"] = self.developer_id
+        
+        retry_times = 0        
+        resp = {}
+        while retry_times < self.max_retry_times:
+            try:
+                resp = requests.post(
+                    f"http://{self.api_host}/api/wanda/{self.cracker_name}/{self.cracker_version}", 
+                    headers=headers, json=self.wanda_args, timeout=self.timeout
+                ).json()
+                if self.debug:
+                    logger.info(resp)
+                break
+            except Exception as e:
+                if self.debug:
+                    logger.error(e)
+                retry_times += 1
+        wanda_ret = resp.get("data")
+        self._extra_data = resp.get("extra")
+        if not wanda_ret:
+            if self.debug:
+                logger.error(resp.get("msg"))
+            return
+        ret = self.response(wanda_ret)
+        if self.check_useful:
+            if self.check(wanda_ret):
+                if self.debug:
+                    logger.success("crack success")
+            else:
+                retry_times += 1
+                if retry_times < self.max_retry_times:
+                    return self.crack()
+                else:
+                    logger.error("crack fail")
+        return ret

pynocaptcha/cloudflare.py

@@ -0,0 +1,42 @@
+# -*- coding: UTF-8 -*-
+
+from .base import BaseCracker
+
+
+class CloudFlareCracker(BaseCracker):
+    
+    cracker_name = "cloudflare"
+    cracker_version = "universal"    
+
+    """
+    cloudflare cracker
+    :param href: 触发 cloudfalre 验证的首页地址
+    :param user_agent: 请求流程使用 ua, 不传
+    :param headers: 触发验证必须的 headers, 默认 {} 
+    :param cookies: 触发验证必须的 cookies, 默认 {} 
+    :param html: 是否需要返回 html
+    :param alpha: 是否 alpha 模式, true 会更快
+    :param timeout: 最大破解超时时间
+    调用示例:
+    cracker = CloudFlareCracker(
+        href=href,
+        user_token="xxx",
+    )
+    ret = cracker.crack()
+    """
+    
+    # 必传参数
+    must_check_params = ["href"]
+    # 默认可选参数
+    option_params = {
+        "branch": "Master",
+        "user_agent": None,
+        "headers": {},
+        "cookies": {},
+        "html": False,
+        "sitekey": "",
+        "alpha": False,
+        "action": None,
+        "cdata": None,
+        "timeout": 30
+    }

pynocaptcha/datadome.py

@@ -0,0 +1,93 @@
+# -*- coding: UTF-8 -*-
+
+from loguru import logger
+from curl_cffi import requests
+
+from .base import async_resolve_ipinfo, resolve_ipinfo
+
+
+def _dd_payload(href, proxy=None, user_agent=None, interstitial=False,
+                cookies=None, ipinfo=None):
+    payload = {"href": href}
+    if proxy:
+        payload["proxy"] = proxy
+    if user_agent:
+        payload["user_agent"] = user_agent if isinstance(user_agent, str) else str(user_agent)
+    if interstitial:
+        payload["interstitial"] = True
+    if cookies:
+        payload["cookies"] = cookies
+    if ipinfo:
+        payload.update(ipinfo)
+    return payload
+
+
+def _dd_request(user_token, payload, internal_host, developer_id, timeout):
+    host = "api.nocaptcha.cn" if internal_host else "api.nocaptcha.io"
+    headers = {"User-Token": user_token}
+    if developer_id:
+        headers["Developer-Id"] = developer_id
+    return requests.post(
+        f"http://{host}/api/wanda/datadome/universal",
+        headers=headers,
+        json=payload,
+        timeout=timeout,
+    ).json()
+
+
+def _dd_result(resp, debug):
+    if debug:
+        logger.info(resp)
+    if not resp.get("status"):
+        raise Warning(resp.get("msg") or "验证失败")
+    return resp.get("data") or {}, resp.get("extra")
+
+
+def crack_datadome(
+    user_token: str, href: str, proxy: str = None,
+    user_agent: str = None, interstitial: bool = False, cookies: dict = None,
+    internal_host: bool = True, developer_id: str = None,
+    timeout: int = 120, debug: bool = False,
+    country: str = None, ip: str = None, timezone: str = None, geolocation: str = None,
+):
+    """datadome 薄封装: 只上传 href/proxy 和出口属地信息, 计算全部在服务端完成。
+
+    country/ip/timezone/geolocation 未传时, 会走 proxy 请求 https://ipinfo.io/json 自动补齐。
+    :return: (cookies, extra), cookies 含可用的 datadome cookie
+    """
+    resp = _dd_request(
+        user_token,
+        _dd_payload(
+            href, proxy=proxy, user_agent=user_agent, interstitial=interstitial,
+            cookies=cookies,
+            ipinfo=resolve_ipinfo(proxy, country, ip, timezone, geolocation),
+        ),
+        internal_host, developer_id, timeout,
+    )
+    return _dd_result(resp, debug)
+
+
+async def async_crack_datadome(
+    user_token: str, href: str, proxy: str = None,
+    user_agent: str = None, interstitial: bool = False, cookies: dict = None,
+    internal_host: bool = True, developer_id: str = None,
+    timeout: int = 120, debug: bool = False,
+    country: str = None, ip: str = None, timezone: str = None, geolocation: str = None,
+):
+    """crack_datadome 的异步版本, 返回值与同步版本一致。"""
+    ipinfo = await async_resolve_ipinfo(proxy, country, ip, timezone, geolocation)
+    host = "api.nocaptcha.cn" if internal_host else "api.nocaptcha.io"
+    headers = {"User-Token": user_token}
+    if developer_id:
+        headers["Developer-Id"] = developer_id
+    async with requests.AsyncSession() as session:
+        resp = (await session.post(
+            f"http://{host}/api/wanda/datadome/universal",
+            headers=headers,
+            json=_dd_payload(
+                href, proxy=proxy, user_agent=user_agent, interstitial=interstitial,
+                cookies=cookies, ipinfo=ipinfo,
+            ),
+            timeout=timeout,
+        )).json()
+    return _dd_result(resp, debug)

pynocaptcha/discord.py

@@ -0,0 +1,33 @@
+# -*- coding: UTF-8 -*-
+
+from .base import BaseCracker
+
+
+class DiscordCracker(BaseCracker):
+    
+    cracker_name = "discord"
+    cracker_version = "guild"    
+
+    """
+    discord cracker
+    :param authorization: discord 账号登录凭证
+    :param guild_id: 群 id
+    :param cookies: 
+    调用示例:
+    cracker = DiscordCracker(
+        user_token="xxx",
+        authorization="MTExNzI1NDQ3NzA2NjU0MzE5NQ.xxx",
+        guild_id='645607528297922560',
+        # guild_name='fusionlist'
+        # debug=True,
+    )
+    ret = cracker.crack()
+    """
+    
+    # 必传参数
+    must_check_params = ["authorization"]
+    # 可选参数
+    option_params = {
+        "guild_id": "",
+        "guild_name": ""
+    }

pynocaptcha/hcaptcha.py

@@ -0,0 +1,80 @@
+# -*- coding: UTF-8 -*-
+
+
+from .base import BaseCracker
+
+
+class HcaptchaCracker(BaseCracker):
+    
+    cracker_name = "hcaptcha"
+    cracker_version = "universal"    
+
+    """
+    hcaptcha cracker
+    :param sitekey: hcaptcha 对接网站的 key
+    :param rqtoken: 验证码配置接口有返回 captcha_rqdata、captcha_rqtoken 的请携带该值(如 discord 加频道)
+    :param user_agent: 请求流程使用 ua, 必须使用 MacOS Firefox User-Agent, 否则可能破解失败
+    :param referer: 触发 hcaptcha 验证的页面地址
+    :param mode: 验证模式, 默认 picture 图片验证模式, 可选 question 题库模式
+    调用示例:
+    cracker = HcaptchaCracker(
+        user_token="xxx",
+        sitekey='f5561ba9-8f1e-40ca-9b5b-a0b3f719ef34',
+        rqdata="",
+        referer="https://discord.com/login",
+
+        # debug=True,
+    )
+    ret = cracker.crack()
+    """
+    
+    # 必传参数
+    must_check_params = ["sitekey", "referer"]
+    # 默认可选参数
+    option_params = {
+        "mode": "picture",   # 验证模式, 默认图片验证, 可选 question 题库验证
+        "rqdata": "",
+        "need_ekey": False,
+        "region": None,
+        "domain": "hcaptcha.com",
+    }
+
+
+class HcaptchaV2Cracker(BaseCracker):
+    
+    cracker_name = "hcaptcha"
+    cracker_version = "v2"    
+
+    """
+    hcaptcha cracker
+    :param sitekey: hcaptcha 对接网站的 key
+    :param rqtoken: 验证码配置接口有返回 captcha_rqdata、captcha_rqtoken 的请携带该值(如 discord 加频道)
+    :param user_agent: 请求流程使用 ua, 必须使用 MacOS Firefox User-Agent, 否则可能破解失败
+    :param referer: 触发 hcaptcha 验证的页面地址
+    :param mode: 验证模式, 默认 picture 图片验证模式, 可选 question 题库模式
+    调用示例:
+    cracker = HcaptchaCracker(
+        user_token="xxx",
+        sitekey='f5561ba9-8f1e-40ca-9b5b-a0b3f719ef34',
+        rqdata="",
+        referer="https://discord.com/login",
+
+        # debug=True,
+    )
+    ret = cracker.crack()
+    """
+    
+    # 必传参数
+    must_check_params = ["sitekey", "referer"]
+    # 默认可选参数
+    option_params = {
+        "action": None,
+        "rqdata": "",
+        "need_ekey": False,
+        "title": None,
+        "extra": {},
+        "region": None,
+        "ip": None,
+        "timezone": None,
+        "geolocation": None,
+    }