How zidansec/cloudpeler works
Project type and purpose
• This is a standalone CLI information-gathering tool written in PHP, called CrimeFlare. Its sole purpose is to discover the real IP address of a domain protected by CloudFlare, along with related metadata (DNS records, geo info, organization, etc.).
File structure
• Top level:
• .github/ (issue & funding templates)
• LICENSE, README.md
• crimeflare.php (the only implementation file)
• There are no “frontend” or “backend” folders—just one script. No databases, no microservices, no build pipelines.
README for additional insights
• The README describes:
• Dependencies (php-curl)
• Two external APIs used:
– https://crimeflare.zidansec.com (custom lookup API)
– http://ipinfo.io/<ip>/json (geo/IP info)
• DNS lookups for NS records and CloudFlare IPs
• How to install and invoke the CLI tool on Linux.
Key advice
• Be exhaustive: even though it’s a single-script tool, capture the runtime environment, all external dependencies, and the data-flow sequence.
• Keep labels concise but specific (e.g., “DNS NS query,” “API: /lookup?domain=”).