cloudcheck

What it is and what it does

CloudCheck is a Python library (with Rust bindings) that determines whether a given IP address or hostname belongs to a cloud provider. It maintains a database of cloud provider signatures—domains, CIDR ranges, and ASNs—that is updated daily via CI/CD pipelines. The library fetches domain data from the v2fly community repository and CIDR data from ASNDB, covering 60 cloud providers including major players like AWS, Google Cloud, Azure, and regional providers. It exposes both an async Python API and a REST server interface.

The package is designed for security and reconnaissance workflows, particularly within the BBOT reconnaissance framework ecosystem. It handles IP and hostname lookups asynchronously, supports custom signature sources and retry configuration, and provides structured output identifying the cloud provider and associated metadata (name, tags, descriptions). The library requires Python 3.10+ and has no external runtime dependencies, making it straightforward to integrate into existing Python applications.

Use it for:

• Identify cloud infrastructure during security reconnaissance or penetration testing to filter out cloud-hosted targets
• Validate whether discovered IPs or domains belong to known cloud providers in automated scanning workflows
• Build a REST API service to expose cloud provider lookups to other tools or teams via HTTP
• Enrich security logs or threat intelligence feeds by tagging IPs/domains with their cloud provider affiliation

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Identifies whether an IP address or hostname belongs to a cloud provider by querying a daily-updated database of cloud provider signatures, domains, and CIDR ranges.

Yes, if you need reliable cloud provider identification. The package is actively maintained, has no security vulnerabilities, covers 60 providers with daily-updated signatures, and integrates cleanly into Python workflows. The async API and optional REST server make it flexible for both library and service use cases. Install friction is moderate but manageable for modern Python environments (3.10+).

Install

cloudcheck on PyPI

pip install cloudcheck

uv add cloudcheck

poetry add cloudcheck

Installing cloudcheck

Before you install

Medium install friction due to compiled wheels across multiple architectures and Python versions (cp310, cp311). Package is actively maintained with recent commits and no known vulnerabilities.

Quickstart

pip install cloudcheck

import asyncio
from cloudcheck import CloudCheck

async def main():
    cloudcheck = CloudCheck()
    results = await cloudcheck.lookup("8.8.8.8")
    print(results)

asyncio.run(main())

Requires Python 3.10 or later; async/await pattern requires asyncio event loop.

Verify before relying

• Whether the daily-updated signatures are automatically fetched on first use or require manual refresh
• Performance characteristics for bulk lookups or high-frequency queries
• Accuracy and coverage of the cloud provider database across all major providers

Package facts

Evidence: cloudcheck-11.1.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; cloudcheck-11.1.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl; cloudcheck-11.1.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl; cloudcheck-11.1.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; cloudcheck-11.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; cloudcheck-11.1.0-cp310-cp310-musllinux_1_2_aarch64.whl; cloudcheck-11.1.0-cp310-cp310-musllinux_1_2_armv7l.whl; cloudcheck-11.1.0-cp310-cp310-musllinux_1_2_i686.whl; cloudcheck-11.1.0-cp310-cp310-musllinux_1_2_x86_64.whl; cloudcheck-11.1.0-cp310-cp310-win_amd64.whl; cloudcheck-11.1.0-cp311-cp311-macosx_10_12_x86_64.whl; cloudcheck-11.1.0-cp311-cp311-macosx_11_0_arm64.whl; cloudcheck-11.1.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; cloudcheck-11.1.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl; cloudcheck-11.1.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl; cloudcheck-11.1.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; cloudcheck-11.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; cloudcheck-11.1.0-cp311-cp311-musllinux_1_2_aarch64.whl; cloudcheck-11.1.0-cp311-cp311-musllinux_1_2_armv7l.whl; cloudcheck-11.1.0-cp311-cp311-musllinux_1_2_i686.whl

Tags

More Internet packages