pybots 2.1.3

Devkit for quickly creating client robots for remote communications

PyBots

Create your robot clients with Python.

This library aims to quickly write client bots for communicating with remote hosts in a standardized way using context managers. It implements a few bots for some common protocols (HTTP, JSON, IRC, ...) and for communicating with specific applications (Shodan, Censys, HaveIBeenPwned?, RootMe, RingZer0, ...).

pip install pybots

Usage

Each bot class is implemented as a context manager and has a logger attached. It can thus be instantiated in a clear and straightforward way. Here is an example:

from pybots import TCPBot

with TCPBot("remote_host", 1234) as bot:
    data = bot.send_receive("Hello!")
    # do something with data

Note that, if a bot is used behind a proxy, it will use system's proxy settings. This can be bypassed by using no_proxy=True while instantiating the bot.

with TCPBot("LAN_host", 1234, no_proxy=True) as bot:
    # ...

Supported Bots

Generic Purpose

All the following bots use the same interface providing uniformized logging.

Name	Description
HTTP	For browsing and parsing a Web page with BeautifulSoup
IRC	For connecting to an IRC server on a given channel with a given nickname
JSON	For dealing with a JSON API
TCP	For opening a TCP socket

CTF Platforms

Each of these bots is aimed to parse inputs from a challenge and to send the answer computed in the context of the bot to the target website for retrieving the flag.

Name	Description
RingZer0	Web bot for all kinds of challenges
RootMe	IRC bot for programming challenges
ZSIS	Web bot for progrmming challenges

Security Services

These bots are built upon an API layer that defines corresponding interfaces to the online services' functionalities as described in their documentation. The bots implement common operations that may involve multiple calls to the online services' API.

Name	Description
Censys	JSON bot that checks for IP's and domains
Ghost Project	Web bot that checks for emails
HaveIBeenPwned?	JSON bot that checks for emails and passwords
HaveIBeenSold?	JSON bot that checks for emails
Nuclear Leaks	Web bot that checks for emails and domains
Shodan	JSON bot that checks for IP's

Utility Services

Name	Description
Git	Web bot that can retrieve a Git repository
PostBin	Web bot that can perform Bin operations

Examples

Real-Life Projects

• Bots Scheduler (uses ShodanBot, HaveIBeenPwnedBot, GhostProjectBot and a few others)

CTF

• Hacky Easter 2017 (22 & 24)
• Hackvent 2017 (Day 06 & 10)
• RingZer0 / Coding (13 & 17)
• Root-Me / Programming