wib-osint


Namewib-osint JSON
Version 0.1.4 PyPI version JSON
download
home_pageNone
SummaryPassive OSINT lookups for IPs and domains with a clean terminal UI
upload_time2025-10-21 12:32:28
maintainerNone
docs_urlNone
authortspry
requires_python>=3.10
licenseMIT
keywords osint cli security whois rdap ip domain
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # wib

Passive OSINT lookups for IPs and domains with a clean terminal UI.

- Free by default: IPWhois (ipwho.is) for IPs; RDAP for domains (fallback to Port 43 WHOIS).
- Optional enrichments when API keys provided (VirusTotal, IP2Whois, IPinfo, etc.).
- Pretty Rich panels or machine-readable JSON/YAML/Markdown output.

## Installing `wib`

```sh
pip install wib-osint
```
## Usage

```sh
wib 1.1.1.1
wib google.com
wib --dns google.com
wib api[.]google[.]com -A
python -m wib.main google.com --output json
```

## Install (dev)

Windows-friendly steps (PowerShell or zsh on Windows):

```sh
python -m venv .venv
. .venv/Scripts/activate
pip install -U pip
pip install -e ".[dev]"
```

Note for zsh: square brackets are glob characters. Always quote extras (".[dev]") or escape them (\.\[dev\]) to avoid "no matches found".

##
Global flags:

- -A/--all: enable all optional enrichments for which keys are configured
- --geo-service [ipwhois|ip2location|ipinfo]
- --max-resolutions N (for VT)
- --one-column, --no-color
- --timeout <seconds>
- --no-virustotal
- --dns (resolve and show DNS records for domains)
- --output [rich|json|yaml|md], --out-file <path>

Environment:

- WIB_DEFAULTS: space-separated default flags merged before argv
- Optional env file: ~/.env.wib (process env wins)
- Keys (all optional, read from global OS env):
  - VT_API_KEY
  - IP2WHOIS_API_KEY (enables paid IP2WHOIS fallback for domains)
  - IP2LOCATION_API_KEY, IPINFO_API_KEY, SHODAN_API_KEY, GREYNOISE_API_KEY, ABUSEIPDB_API_KEY, URLHAUS_API_KEY
- GEOLOCATION_SERVICE mirrors --geo-service

Fallback order for domain whois:

1. RDAP (free)
2. Port 43 WHOIS (free)
3. IP2WHOIS (optional, if IP2WHOIS_API_KEY is set)

Set env variables on Windows:

- Current session (PowerShell):
  $env:IP2WHOIS_API_KEY = "your_key"
- Persistent (User, restart terminal after):
  setx IP2WHOIS_API_KEY "your_key"

## Tests

```sh
python -m pytest -q
```

## Dev tasks

```sh
ruff check .
black .
mypy .
pytest -q
bandit -r wib
```

License: MIT

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "wib-osint",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "osint, cli, security, whois, rdap, ip, domain",
    "author": "tspry",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/e8/09/f8811f7b2a49a0eb5add34d239fe1b8bb8c15010505efaee8389f1d095af/wib_osint-0.1.4.tar.gz",
    "platform": null,
    "description": "# wib\n\nPassive OSINT lookups for IPs and domains with a clean terminal UI.\n\n- Free by default: IPWhois (ipwho.is) for IPs; RDAP for domains (fallback to Port 43 WHOIS).\n- Optional enrichments when API keys provided (VirusTotal, IP2Whois, IPinfo, etc.).\n- Pretty Rich panels or machine-readable JSON/YAML/Markdown output.\n\n## Installing `wib`\n\n```sh\npip install wib-osint\n```\n## Usage\n\n```sh\nwib 1.1.1.1\nwib google.com\nwib --dns google.com\nwib api[.]google[.]com -A\npython -m wib.main google.com --output json\n```\n\n## Install (dev)\n\nWindows-friendly steps (PowerShell or zsh on Windows):\n\n```sh\npython -m venv .venv\n. .venv/Scripts/activate\npip install -U pip\npip install -e \".[dev]\"\n```\n\nNote for zsh: square brackets are glob characters. Always quote extras (\".[dev]\") or escape them (\\.\\[dev\\]) to avoid \"no matches found\".\n\n##\nGlobal flags:\n\n- -A/--all: enable all optional enrichments for which keys are configured\n- --geo-service [ipwhois|ip2location|ipinfo]\n- --max-resolutions N (for VT)\n- --one-column, --no-color\n- --timeout <seconds>\n- --no-virustotal\n- --dns (resolve and show DNS records for domains)\n- --output [rich|json|yaml|md], --out-file <path>\n\nEnvironment:\n\n- WIB_DEFAULTS: space-separated default flags merged before argv\n- Optional env file: ~/.env.wib (process env wins)\n- Keys (all optional, read from global OS env):\n  - VT_API_KEY\n  - IP2WHOIS_API_KEY (enables paid IP2WHOIS fallback for domains)\n  - IP2LOCATION_API_KEY, IPINFO_API_KEY, SHODAN_API_KEY, GREYNOISE_API_KEY, ABUSEIPDB_API_KEY, URLHAUS_API_KEY\n- GEOLOCATION_SERVICE mirrors --geo-service\n\nFallback order for domain whois:\n\n1. RDAP (free)\n2. Port 43 WHOIS (free)\n3. IP2WHOIS (optional, if IP2WHOIS_API_KEY is set)\n\nSet env variables on Windows:\n\n- Current session (PowerShell):\n  $env:IP2WHOIS_API_KEY = \"your_key\"\n- Persistent (User, restart terminal after):\n  setx IP2WHOIS_API_KEY \"your_key\"\n\n## Tests\n\n```sh\npython -m pytest -q\n```\n\n## Dev tasks\n\n```sh\nruff check .\nblack .\nmypy .\npytest -q\nbandit -r wib\n```\n\nLicense: MIT\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Passive OSINT lookups for IPs and domains with a clean terminal UI",
    "version": "0.1.4",
    "project_urls": {
        "Homepage": "https://github.com/tspry/wib",
        "Repository": "https://github.com/tspry/wib"
    },
    "split_keywords": [
        "osint",
        " cli",
        " security",
        " whois",
        " rdap",
        " ip",
        " domain"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0430b0b6a9a65cdbc3f64567f29e250d8f100ebe0e50653b14657063b7761a0d",
                "md5": "661c9487454e1f87250beaea072ac7b5",
                "sha256": "f7b0ab0a8f4d25e75819ffe3257d5038fb4955cc291a14353ebdbbb082652af0"
            },
            "downloads": -1,
            "filename": "wib_osint-0.1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "661c9487454e1f87250beaea072ac7b5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 20353,
            "upload_time": "2025-10-21T12:32:26",
            "upload_time_iso_8601": "2025-10-21T12:32:26.874635Z",
            "url": "https://files.pythonhosted.org/packages/04/30/b0b6a9a65cdbc3f64567f29e250d8f100ebe0e50653b14657063b7761a0d/wib_osint-0.1.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "e809f8811f7b2a49a0eb5add34d239fe1b8bb8c15010505efaee8389f1d095af",
                "md5": "96fdf56cadf13b3ab959ef8bd5b14c49",
                "sha256": "a6cc1d925a332d983ae52e18bf01bc4fe62c284c8a336501b48223accc77af75"
            },
            "downloads": -1,
            "filename": "wib_osint-0.1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "96fdf56cadf13b3ab959ef8bd5b14c49",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 17068,
            "upload_time": "2025-10-21T12:32:28",
            "upload_time_iso_8601": "2025-10-21T12:32:28.015083Z",
            "url": "https://files.pythonhosted.org/packages/e8/09/f8811f7b2a49a0eb5add34d239fe1b8bb8c15010505efaee8389f1d095af/wib_osint-0.1.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-21 12:32:28",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "tspry",
    "github_project": "wib",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "wib-osint"
}
        
Elapsed time: 0.70878s