Booking.com Extranet Manager

Automate Booking.com property management through a Python CLI tool. Uses your locally installed Google Chrome (not a headless browser) to interact with the Booking.com partner extranet, avoiding bot detection.

Security Notes

• - Credentials are stored locally in a .env file in the bot directory — never transmitted elsewhere.
• Browser session is persisted in .chrome-data/ so login + SMS 2FA only happens once. Delete this directory to clear the session.
• Chrome remote debugging runs on localhost:9222 only — not exposed to the network.
• The bot connects exclusively to admin.booking.com and account.booking.com.

Prerequisites

The CLI tool must be installed and configured on the host machine:

CODEBLOCK0

Then create a .env file with your credentials:

CODEBLOCK1

Google Chrome must be installed on the host machine.

Environment

• - BOT_DIR: Absolute path to the booking-extranet-bot directory
• Python venv at INLINECODE7
• CLI entry point: INLINECODE8

All commands output JSON to stdout. Logs go to stderr.

Available Commands

List Properties

Get all properties with hotel IDs and unread message counts.

CODEBLOCK2

Returns:
CODEBLOCK3

Download Reservations

Download reservations for a date range. Use --json to get data directly, or omit it to save an Excel file.

CODEBLOCK4

Options:

• - --start YYYY-MM-DD (required): Start date
• INLINECODE11 (required): End date
• INLINECODE12: arrival (default), departure, or INLINECODE15
• INLINECODE16: Return data as JSON instead of Excel
• INLINECODE17: Directory for Excel file (default: ./downloads)

List Messages

List guest messages for a property. Defaults to unanswered.

CODEBLOCK5

Options:

• - --hotel-id (required): Property hotel ID from list-properties
• INLINECODE20: unanswered (default), sent, or INLINECODE23

Read Message

Open and read a specific conversation with reservation details.

CODEBLOCK6

Options:

• - --hotel-id (required): Property hotel ID
• INLINECODE25 (required): Message index from list-messages (0-based)

Send Message

Reply to a guest conversation. Always use list-messages first to get the correct index.

CODEBLOCK7

Options:

• - --hotel-id (required): Property hotel ID
• INLINECODE27 (required): Message index from list-messages (0-based)
• INLINECODE28 (required): Reply text

Update Rates

Update room rates from the CSV pricing file.

CODEBLOCK8

Typical Workflow

1. 1. List properties to get hotel IDs and see which have unread messages
2. List messages for properties with unread messages
3. Read each conversation to understand the guest's request
4. Send replies as appropriate
5. Download reservations periodically to track bookings

First Run

On first run, Chrome opens and you must complete the login (including SMS 2FA). Subsequent runs reuse the session — no login needed until the session expires.