holehe模块开发模板快速创建新网站检测插件的标准化流程【免费下载链接】holeheholehe allows you to check if the mail is used on different sites like twitter, instagram and will retrieve information on sites with the forgotten password function.项目地址: https://gitcode.com/GitHub_Trending/ho/holehe你是否在为holehe项目开发新网站检测插件时常常因重复编写相似代码而效率低下是否因不熟悉模块规范导致集成困难本文将通过分析现有模块结构提供一套标准化开发流程帮助你15分钟内完成新插件开发。模块结构解析holehe的网站检测模块采用统一的文件组织方式所有模块位于holehe/modules/目录下按网站类型分为cms/、social_media/等子目录。每个模块文件如instagram.py包含一个异步函数实现特定网站的邮箱检测逻辑。核心组件对比组件Instagram模块(instagram.py)HubSpot模块(hubspot.py)函数定义async def instagram(email, client, out)async def hubspot(email, client, out)方法类型注册页面检测(methodregister)登录页面检测(methodlogin)限流标记frequent_rate_limitTruefrequent_rate_limitFalse响应处理解析注册接口JSON响应检查登录状态码标准化开发流程1. 文件创建与基础结构在对应分类目录下创建新文件如social_media/tiktok.py导入必要模块from holehe.core import * from holehe.localuseragent import *2. 函数定义与元数据定义异步函数并设置元数据async def tiktok(email, client, out): name tiktok domain tiktok.com method register # 可选register/login/other frequent_rate_limit False # 是否频繁限流3. 请求头与参数配置使用随机User-Agent构建请求头示例headers { User-Agent: random.choice(ua[browsers][chrome]), Accept: application/json, text/plain, */*, Origin: https://www.tiktok.com, }4. 核心检测逻辑根据目标网站特性选择合适的检测方式注册页面检测如Instagram发送注册请求检查邮箱已存在提示登录页面检测如HubSpot提交空密码根据错误信息判断特殊接口检测调用网站提供的用户查询API关键代码示例注册页面检测data {email: email, username: testuser, password: testpass} response await client.post(https://www.tiktok.com/api/register/, datadata, headersheaders) if email already registered in response.text: out.append({name: name, domain: domain, exists: True, ...})5. 结果输出格式化严格按照core.py定义的格式返回结果out.append({ name: name, domain: domain, method: method, frequent_rate_limit: frequent_rate_limit, rateLimit: False, exists: True/False, emailrecovery: None, # 可选部分隐藏的恢复邮箱 phoneNumber: None, # 可选部分隐藏的手机号 others: None # 可选其他额外信息 })测试与集成本地测试使用README.md中提供的Python示例进行测试import trio import httpx from holehe.modules.social_media.tiktok import tiktok async def test(): out [] async with httpx.AsyncClient() as client: await tiktok(testexample.com, client, out) print(out) trio.run(test)模块注册无需手动注册core.py通过import_submodules()自动发现新模块。只需确保文件命名符合*.py格式函数名与文件名保持一致放置在正确的分类目录常见问题解决方案反爬机制应对动态User-Agent使用localuseragent.py提供的随机浏览器标识CSRF令牌处理参考Instagram模块的令牌提取逻辑token freq.text.split(csrf_token\\:\\)[1].split(\\)[0] headers[x-csrftoken] token请求延迟对高频限流网站添加随机延迟需谨慎使用错误处理模板try: response await client.post(url, datadata, headersheaders) response.raise_for_status() except httpx.HTTPError as e: out.append({name: name, domain: domain, rateLimit: True, ...}) return开发工具链核心框架基于trio异步框架配合httpx发送HTTP请求代码规范遵循PEP8标准函数注释需包含参数说明测试环境使用Docker容器(Dockerfile)确保环境一致性通过本文档提供的标准化流程你可以快速开发符合holehe项目规范的检测模块。如需添加复杂功能可参考core.py中的工具函数或在README.md的模块列表中查找类似实现。【免费下载链接】holeheholehe allows you to check if the mail is used on different sites like twitter, instagram and will retrieve information on sites with the forgotten password function.项目地址: https://gitcode.com/GitHub_Trending/ho/holehe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考