PageMap

Provides a compressed, interactive PageMap of web pages for AI agents to read, navigate, and act.

python

6

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "retio-ai-retio-pagemap": {
      "command": "uvx",
      "args": [
        "retio-pagemap"
      ]
    }
  }
}

PageMap is an MCP server that delivers a compressed, interactive map of any web page, enabling AI agents to read, navigate, and act with far fewer tokens and real-time interaction capabilities.

How to use

You can run PageMap as an MCP server in your local environment and connect to it from your MCP client. It exposes interactive tools that let you load a URL, perform actions on elements, and inspect the page state within a compact representation.

How to install

Prerequisites you need before installing PageMap:

Python 3.11+
Install Playwright browsers: playwright install chromium

Install and configure the PageMap MCP server

Install the Python package and prepare the MCP configuration that enables the PageMap server.

pip install retio-pagemap
playwright install chromium

{
  "mcpServers": {
    "pagemap": {
      "command": "uvx",
      "args": ["retio-pagemap"]
    }
  }
}

Start the MCP server

Run the MCP server using the configuration shown above. This launches a local stdio-based server that your MCP client can connect to using the specified command and arguments.

Configuration details

The following configuration is used to expose the PageMap MCP server in your project’s MCP setup.

Security

PageMap treats all web content as untrusted input and enforces safeguards to prevent unsafe actions, restricts potentially dangerous interactions, and validates inputs to maintain a secure operating environment.

Multilingual support

PageMap includes built-in support for extracting multilingual price, review, and metadata contexts, and it can adapt to locale changes based on URL domain detection.

Python API

Use the Python API to interact with the PageMap server and retrieve a structured map for a URL, access interactive elements, and obtain compressed page information.

Tools exposed by PageMap

PageMap provides a small set of tools that your MCP client can call to interact with a web page and gather structured data.

Available tools

get_page_map

Navigate to a URL and return a structured PageMap with reference numbers for interactive elements.

execute_action

Perform actions such as click, type, or select on elements identified by their reference numbers.

get_page_state

Fetch lightweight page state information like URL and title to verify the current page.