web-agent-protocol

Overview

Web Agent Protocol (WAP) is a standardized framework that enables recording and replaying browser actions. It collects user interaction data through a Chrome extension, converts it into exact or smart replay lists, and transforms these actions into MCP servers for reuse by any agent. The protocol separates action recording and execution concerns, allowing for efficient automation and reusability of web workflows.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• generate_mcp_server

  Converts recorded browser actions into MCP servers for reuse

  Try:Convert my recorded session to an MCP serverTry:Generate an MCP server from task id em3h6UBDZykz0gnH
• run_replay

  Replays recorded browser actions using specified model provider

  Try:Replay the exact replay list on AmazonTry:Run smart replay with OpenAI model
• generate_exact_replay_list

  Generates exact replay lists from raw browser interaction data

  Try:Create an exact replay list from my dataTry:Generate exact replay for task id MkCAhQsHgXn7YgaK
• generate_smart_replay_list

  Generates smart replay lists with condensed goal-oriented steps

  Try:Create a smart replay list from my dataTry:Generate smart replay for finding products on Amazon
• start_data_collection_server

  Starts server to collect browser interaction data from Chrome extension

  Try:Start the data collection serverTry:Begin collecting browser actions

Note: Tool names extracted from documented commands and conversion process in README

Comparable tools

Installation

# Install dependencies
conda create -n WAP python=3.11
conda activate WAP
pip install -r requirements.txt

# Set environment variables
set PYTHONPATH=/path/to/webagentprotocol  # Windows
export PYTHONPATH=/path/to/webagentprotocol  # Linux

# Create .env file with API keys
OPENAI_API_KEY=sk-proj-...
DEEPSEEK_API_KEY=sk-...

# Install Chrome extension
# See https://github.com/OTA-Tech-AI/webagentprotocol/tree/main/chrome-extension

{
  "mcpServers": {
    "wap": {
      "command": "python",
      "args": ["/path/to/webagentprotocol/wap_service.py"]
    }
  }
}```

FAQ

How do I convert recorded browser actions to an MCP server?

Use the command: `python wap_replay\generate_mcp_server.py --task_id <task_id>`. The converted MCP servers will be located in the `mcp_servers` folder.

What's the difference between exact replay and smart replay?

Exact replay reproduces every recorded action exactly as it happened, while smart replay creates condensed, goal-oriented steps that achieve the same result with fewer actions.

Compare web-agent-protocol with