Python CLI client for interactsh — detects out-of-band (OOB) interactions (DNS, HTTP, SMTP, etc.) via ProjectDiscovery's public servers.
pip install .
# For development (edits take effect without reinstalling)
pip install -e .Poll continuously. Deregisters on exit.
interactsh-cli live
interactsh-cli live -s oast.pro -v
interactsh-cli live --json -p 10Press Ctrl+C to stop.
Create a URL, trigger interactions on your own time, then fetch results.
# Create URL and save session
interactsh-cli new
# cnebi4k107h4p1kqftd0yb7xmjmhw6bke.oast.pro
# Poll once (drains the queue)
interactsh-cli poll cnebi4k107h4p1kqftd0yb7xmjmhw6bke.oast.pro
# #1 [DNS] from 1.2.3.4 (type: A) at 2026-04-11T...
# #2 [HTTP] from 1.2.3.4 at 2026-04-11T...
# Show full details of a specific interaction
interactsh-cli show cnebi4k107h4p1kqftd0yb7xmjmhw6bke.oast.pro 2| Flag | Commands | Description |
|---|---|---|
-s |
live, new |
Server (default: auto-select) |
-t |
live, new |
Auth token |
-p |
live |
Poll interval in seconds (default: 5) |
-v |
live |
Show raw request/response |
--json |
live, poll, show |
JSON output |
An agent skill file is available at agent-skill/interactsh-client/SKILL.md.
pip install pytest
# Unit tests (mocked, no network)
pytest tests/ --ignore=tests/test_e2e.py
# End-to-end tests (hits live interactsh servers)
pytest tests/test_e2e.py
# All tests
pytest tests/