agent-browser-automation

name	agent_browser_automation
description	Browser automation for Odoo web testing, form filling, screenshots, documentation, and frontend validation. Use when testing Odoo web pages, creating module screenshots, validating forms, or automating browser interactions for Odoo 17/18/19.
version	1.0.0
author	VPCS Team
category	testing_automation
odoo_versions	["17.0","18.0","19.0"]
tags	["browser","automation","testing","screenshot","odoo","web","forms","validation","documentation","playwright"]
allowed-tools	Bash(agent-browser:*)

Browser Automation with agent-browser

Goal

Automate Odoo browser testing, form interactions, screenshot generation for module documentation, and frontend validation across Odoo 17/18/19.

⚠️ Important: Dynamic Port Configuration

Before running any browser automation commands, you must determine your local Odoo server's actual port and URL:

Step 1: Check your Odoo config file

# For your workspace version (17, 18, or 19)
cat /path/to/VERSION_workspace/config/odoo.conf.VERSION

# Look for the 'xmlrpc_port' parameter:
xmlrpc_port = 8017    # Odoo 17
xmlrpc_port = 8018    # Odoo 18  
xmlrpc_port = 8019    # Odoo 19

Step 2: Verify Odoo is running on that port

curl http://localhost:8017/web/health || echo "Odoo not running on 8017"

Step 3: Use the correct URL in your commands

# Examples (replace 8017 with your actual port):
agent-browser open http://localhost:8017/web                    # Login page
agent-browser open http://localhost:8017/web#model=res.partner  # List view
agent-browser open http://localhost:8017/shop                   # Website page

⚠️ Common Mistake: Using hardcoded URLs like http://localhost:8090 when your config has xmlrpc_port = 8017

Step 4: Automatically detect port from config (Recommended for Agents)

Instead of manually checking, agents should automatically extract the port:

#!/bin/bash
# auto_detect_odoo_url.sh - Dynamically determine Odoo URL from config

WORKSPACE_PATH="${1:-.}"  # Default to current directory
VERSION="${2:-19}"         # Default to version 19

# Find the config file
CONFIG_FILE="$WORKSPACE_PATH/config/odoo.conf.$VERSION"

if [ ! -f "$CONFIG_FILE" ]; then
    echo "❌ Config file not found: $CONFIG_FILE"
    echo "Check that WORKSPACE_PATH is correct"
    exit 1
fi

# Extract xmlrpc_port from config
XMLRPC_PORT=$(grep "^xmlrpc_port" "$CONFIG_FILE" | tail -1 | awk '{print $NF}' | tr -d ' ')

if [ -z "$XMLRPC_PORT" ]; then
    echo "❌ xmlrpc_port not found in $CONFIG_FILE"
    echo "Add this to your config: xmlrpc_port = 8017"
    exit 1
fi

# Construct Odoo URL
ODOO_URL="http://localhost:$XMLRPC_PORT"

echo "✅ Detected Odoo URL: $ODOO_URL"
echo "Export for use in scripts:"
echo "export ODOO_URL='$ODOO_URL'"

# Return the URL
echo "$ODOO_URL"

Usage in agent scripts:

# Source the detection script
source auto_detect_odoo_url.sh "${ODOO_WORKSPACES_ROOT:-$HOME/odoo-workspaces}/17_workspace" 17

# Or extract directly:
XMLRPC_PORT=$(grep "^xmlrpc_port" /path/to/config/odoo.conf.17 | awk '{print $NF}')
ODOO_URL="http://localhost:$XMLRPC_PORT"

# Use in browser automation:
agent-browser open "$ODOO_URL/web"
agent-browser open "$ODOO_URL/web#model=res.partner"
agent-browser open "$ODOO_URL/shop"