Browse Page with PageMap
Use the PageMap MCP server to browse, read, and interact with web pages. PageMap compresses ~100K-token HTML into a 2-5K-token structured map while preserving every actionable element.
Core Workflow
1. Read a page
Call get_page_map with a URL. The response contains:
- Actions — Interactive elements with numbered
[ref] identifiers and affordances (click, type, select, hover)
- Info — Compressed HTML with prices, titles, ratings, and key content
- Images — Product/content image URLs
- Metadata — Structured data from JSON-LD and Open Graph
2. Interact with elements
Use execute_action with a ref number from the Actions section:
execute_action(ref=3, action="click") — Click a button or link
execute_action(ref=5, action="type", value="search query") — Type into an input
execute_action(ref=7, action="select", value="Large") — Select a dropdown option
execute_action(ref=2, action="hover") — Hover to reveal menus
3. Fill forms
Use fill_form to batch-fill multiple fields in one call:
fill_form(fields=[
{"ref": 3, "value": "John Doe"},
{"ref": 4, "value": "john@example.com"},
{"ref": 5, "value": "Large"}
])
Tips
- Refs expire after page changes. If you get a "refs expired" error, call
get_page_map again to refresh.
- Scroll with
scroll_page(direction="down") to reveal more content, then call get_page_map to see newly loaded elements.
- Wait for dynamic content with
wait_for(text="Add to Cart") before interacting.
- Compare pages with
batch_get_page_map(urls=[...]) to read multiple URLs in parallel.
- Check state with
get_page_state for a lightweight URL/title check without rebuilding the full map.
- Screenshot with
take_screenshot when you need visual confirmation.
- Go back with
navigate_back to return to the previous page.
Available Tools
| Tool |
Purpose |
get_page_map |
Navigate to URL, return structured map with ref numbers |
execute_action |
Click, type, select, hover by ref number |
fill_form |
Batch-fill multiple form fields |
get_page_state |
Lightweight state check (URL, title) |
scroll_page |
Scroll up/down/to position |
wait_for |
Wait for text to appear/disappear |
take_screenshot |
Capture viewport or full page |
navigate_back |
Go back in browser history |
batch_get_page_map |
Read multiple URLs in parallel |
1---2name: browse-page3description: "Browse, read, and interact with web pages using PageMap MCP tools. Covers navigation, element interaction, form filling, and page state management."4metadata:5 source: https://skillmd.com/skills/retio-ai/browse-page6---78# Browse Page with PageMap910Use the PageMap MCP server to browse, read, and interact with web pages. PageMap compresses ~100K-token HTML into a 2-5K-token structured map while preserving every actionable element.1112## Core Workflow1314### 1. Read a page1516Call `get_page_map` with a URL. The response contains:1718- **Actions** — Interactive elements with numbered `[ref]` identifiers and affordances (click, type, select, hover)19- **Info** — Compressed HTML with prices, titles, ratings, and key content20- **Images** — Product/content image URLs21- **Metadata** — Structured data from JSON-LD and Open Graph2223### 2. Interact with elements2425Use `execute_action` with a ref number from the Actions section:2627- `execute_action(ref=3, action="click")` — Click a button or link28- `execute_action(ref=5, action="type", value="search query")` — Type into an input29- `execute_action(ref=7, action="select", value="Large")` — Select a dropdown option30- `execute_action(ref=2, action="hover")` — Hover to reveal menus3132### 3. Fill forms3334Use `fill_form` to batch-fill multiple fields in one call:3536```37fill_form(fields=[38 {"ref": 3, "value": "John Doe"},39 {"ref": 4, "value": "john@example.com"},40 {"ref": 5, "value": "Large"}41])42```4344## Tips4546- **Refs expire** after page changes. If you get a "refs expired" error, call `get_page_map` again to refresh.47- **Scroll** with `scroll_page(direction="down")` to reveal more content, then call `get_page_map` to see newly loaded elements.48- **Wait** for dynamic content with `wait_for(text="Add to Cart")` before interacting.49- **Compare pages** with `batch_get_page_map(urls=[...])` to read multiple URLs in parallel.50- **Check state** with `get_page_state` for a lightweight URL/title check without rebuilding the full map.51- **Screenshot** with `take_screenshot` when you need visual confirmation.52- **Go back** with `navigate_back` to return to the previous page.5354## Available Tools5556| Tool | Purpose |57|------|---------|58| `get_page_map` | Navigate to URL, return structured map with ref numbers |59| `execute_action` | Click, type, select, hover by ref number |60| `fill_form` | Batch-fill multiple form fields |61| `get_page_state` | Lightweight state check (URL, title) |62| `scroll_page` | Scroll up/down/to position |63| `wait_for` | Wait for text to appear/disappear |64| `take_screenshot` | Capture viewport or full page |65| `navigate_back` | Go back in browser history |66| `batch_get_page_map` | Read multiple URLs in parallel |