aio-anyrun

Asynchronous python client of ANY.RUN using unofficial API.

Requirement

• python >= 3.6

Usage

Basic Usage

connect with contextmanager

from aio_anyrun.client import AnyRunClient

async with AnyRunClient.connect() as client:
    if client.login('<YOUR_EMAIL_ADDRESS>', '<YOUR_PASSWORD>'):
        tasks = await client.get_public_tasks()
        for task in tasks:
            if task.is_downloadable:
                saved_path = client.dowload_file(task)

Search

Search malicious MS Executable files.

from aio_anyrun.client import AnyRunClient

async with AnyRunClient.connect() as client:
    tasks = await client.search(
        run_type='file',
        verdict='malicious',
        extensions=['exe', 'dll']
    )

Search any Office document file with macros tag.

from aio_anyrun.client import AnyRunClient

async with AnyRunClient.connect() as client:
    tasks = await client.search(
        run_type='file',
        extensions='office',
        tag='macros'
    )

Search any URL with opendir tag.

from aio_anyrun.client import AnyRunClient

async with AnyRunClient.connect() as client:
    tasks = await client.search(
        run_type='url',
        tag='opendir'
    )

Commandline

aio-anyrun provides CLI interface. see --help for details.

$ python -m aio_anyrun --help
Usage: __main__.py [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  download-file  Download file
  download-pcap  Download pcap
  get-ioc        Get IoC information
  search         Search tasks