← Все проекты
Проект / Python

zr0n/zcpf-finder: zCpf-finder — восстанавлитель скрытых цифр CPF по маске

Узнай полный CPF, если знаешь только часть цифр — автоматический перебор и проверка через официальный портал

zCpf-finder — утилита на Python, которая по частично известному CPF (маске) восстанавливает полный номер и проверяет его существование через бразильский государственный портал прозрачности. Проект использует математику контрольных цифр CPF и автоматизирует...

★ 13 Python Форки 5 Issue 0 Оценка 5/10 Карточка проверена

Для кого это

Подойдёт разработчикам на Python, интересующимся бразильскими документами, а также для образовательных экспериментов с генерацией и проверкой CPF.

Проблема / задача

Бразильский CPF состоит из 11 цифр, две последние — контрольные. Если часть цифр утеряна или скрыта, восстановить номер вручную сложно: нужно перебрать миллионы комбинаций и для каждой вычислить контрольные цифры, а потом проверить, существует ли такой номер. Проект автоматизирует это, перебирая варианты и запрашивая...

Как это работает

zCpf-finder — утилита на Python, которая по частично известному CPF (маске) восстанавливает полный номер и проверяет его существование через бразильский государственный портал прозрачности. Проект использует математику контрольных цифр CPF и автоматизирует перебор. Разработан для образовательных целей, лицензия MIT. На GitHub около 13 звёзд, активность низкая.

Что видно по README

zCpf-finder — утилита на Python, которая по частично известному CPF (маске) восстанавливает полный номер и проверяет его существование через бразильский государственный портал прозрачности. Проект использует математику контрольных цифр CPF и автоматизирует перебор. Разработан для образовательных целей, лицензия MIT. На GitHub около 13 звёзд, активность низкая.

Ключевые возможности

Восстановление CPF по маске с неизвестными символами (X)Автоматический расчёт контрольных цифрДва режима работы: прямой API и Playwright (браузер)Параллельные запросы для ускоренияСохранение результатов в текстовый файл

Технологии

PythonPlaywrightBeautifulSoupaiohttpasyncio

Интересный факт

Проект может сгенерировать около 998 комбинаций всего из трёх неизвестных цифр — это позволяет быстро находить почти полные CPF, если известны 6 цифр из 9 базовых.

С чего начать

  • Клонировать репозиторий и установить зависимости: pip install -r requirements.txt
  • Запустить скрипт, передав маску CPF с неизвестными цифрами как X: python cpf_finder.py "XXX.452.217-XX"

Оценка GitRadar

Удобство
6/10
Свежесть
6/10
Перспектива
4/10
Монетизация
2/10
Общая оценка
5/10

Вердикт GitRadar

Инструмент интересен для изучения алгоритма CPF или автоматизации работы с бразильскими данными, но его практическое применение ограничено образовательными целями и регионом. Для широкой аудитории малополезен.

Наблюдения по обновлениям

Последний коммит недавний (сентябрь 2024), проект поддерживается автором, но звёзд немного — ниша узкая.

Что мы проверили

Карточка собрана по данным GitHub, README и структуре репозитория. Это не официальная документация проекта.

Исходный репозиторий
https://github.com/zr0n/zcpf-finder
Лицензия
MIT
Создан на GitHub
18 апреля 2026 г.
Последнее обновление репо
18 апреля 2026 г.
Последняя проверка GitRadar
18 апреля 2026 г.
Изученные файлы
README.md, requirements.txt, cpf_finder.py

FAQ

Что это такое?

Скрипт на Python, который перебирает возможные комбинации частично известного CPF, вычисляет контрольные цифры и проверяет их через государственный портал Бразилии.

Для кого подходит?

Разработчикам, изучающим алгоритмы CPF, автоматизацию с Playwright, а также бразильским специалистам, работающим с публичными данными.

Источники

  • GitHub исходный код и активность
  • README описание, ссылки, стартовые материалы

Нужна помощь с zr0n/zcpf-finder?

Если проект подходит под ваш сценарий, можем помочь с установкой, интеграцией, доработкой или аккуратным форком под вашу инфраструктуру.