cvc_checker/checker/README.md

Checker - Credit Card Validation Tool

一个功能强大的信用卡检测工具，支持 Stripe 支付网关验证。

✨ 特性

• 🚀 多线程检测 - 支持并发检测，提高效率
• 🔄 代理支持 - 支持代理轮换，避免IP限制
• 📱 Telegram通知 - 实时推送检测结果
• 🎨 美观界面 - 彩色终端输出，清晰易读
• 🔍 BIN查询 - 自动查询卡片BIN信息
• 📦 模块化设计 - 清晰的代码结构，易于维护和扩展

📦 安装

使用 uv（推荐）

# 克隆仓库
git clone https://github.com/yourusername/checker.git
cd checker

# 安装依赖
uv pip install -e .

# 或安装开发依赖
uv pip install -e ".[dev]"

使用 pip

pip install -e .

🚀 使用

命令行使用

# 直接运行
checker

# 或使用 Python 模块方式
python -m checker

配置文件

复制 .env.example 为 .env 并配置：

cp .env.example .env

编辑 .env 文件：

# Telegram 通知（可选）
TELEGRAM_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

# 线程配置
MAX_THREADS=3
DEFAULT_THREADS=1

# 超时配置
TIMEOUT=15

作为库使用

from checker import Card, StripeChecker
import requests

# 创建检测器
checker = StripeChecker(
    timeout=15,
    max_retries=5,
    telegram_token="your_token",  # 可选
    telegram_chat_id="your_chat_id"  # 可选
)

# 解析卡片
card = Card.parse("4111111111111111|12|2025|123")

# 执行检测
session = requests.Session()
result = checker.check(card, session)

print(f"状态: {result.status}")
print(f"消息: {result.message}")
print(f"BIN信息: {result.bin_info}")

📂 项目结构

checker/
├── src/checker/          # 源代码
│   ├── cli/             # 命令行界面
│   ├── core/            # 核心配置
│   ├── models/          # 数据模型
│   ├── cards/           # 卡片处理
│   ├── checkers/        # 检测器实现
│   ├── integrations/    # 外部服务集成
│   └── utils/           # 工具函数
├── tests/               # 测试文件
├── data/                # 数据文件
├── scripts/             # 辅助脚本
└── pyproject.toml       # 项目配置

🧪 测试

# 运行所有测试
pytest

# 运行测试并显示覆盖率
pytest --cov=checker

# 运行特定测试
pytest tests/test_cards/test_parser.py

🛠️ 开发

代码格式化

# 使用 black 格式化代码
black src/checker tests

# 使用 ruff 检查代码
ruff check src/checker tests

类型检查

mypy src/checker

📝 许可证

MIT License

🤝 贡献

欢迎提交 Issue 和 Pull Request！

⚠️ 免责声明

本工具仅供学习和研究使用，请勿用于非法用途。使用本工具产生的一切后果由使用者自行承担。