Browse Page

1---
2name: browse-page
3description: "Browse, read, and interact with web pages using PageMap MCP tools. Covers navigation, element interaction, form filling, and page state management."
4---
5 
6# Browse Page with PageMap
7 
8Use 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.
9 
10## Core Workflow
11 
12### 1. Read a page
13 
14Call `get_page_map` with a URL. The response contains:
15 
16- **Actions** — Interactive elements with numbered `[ref]` identifiers and affordances (click, type, select, hover)
17- **Info** — Compressed HTML with prices, titles, ratings, and key content
18- **Images** — Product/content image URLs
19- **Metadata** — Structured data from JSON-LD and Open Graph
20 
21### 2. Interact with elements
22 
23Use `execute_action` with a ref number from the Actions section:
24 
25- `execute_action(ref=3, action="click")` — Click a button or link
26- `execute_action(ref=5, action="type", value="search query")` — Type into an input
27- `execute_action(ref=7, action="select", value="Large")` — Select a dropdown option
28- `execute_action(ref=2, action="hover")` — Hover to reveal menus
29 
30### 3. Fill forms
31 
32Use `fill_form` to batch-fill multiple fields in one call:
33 
34```
35fill_form(fields=[
36  {"ref": 3, "value": "John Doe"},
37  {"ref": 4, "value": "john@example.com"},
38  {"ref": 5, "value": "Large"}
39])
40```
41 
42## Tips
43 
44- **Refs expire** after page changes. If you get a "refs expired" error, call `get_page_map` again to refresh.
45- **Scroll** with `scroll_page(direction="down")` to reveal more content, then call `get_page_map` to see newly loaded elements.
46- **Wait** for dynamic content with `wait_for(text="Add to Cart")` before interacting.
47- **Compare pages** with `batch_get_page_map(urls=[...])` to read multiple URLs in parallel.
48- **Check state** with `get_page_state` for a lightweight URL/title check without rebuilding the full map.
49- **Screenshot** with `take_screenshot` when you need visual confirmation.
50- **Go back** with `navigate_back` to return to the previous page.
51 
52## Available Tools
53 
54| Tool | Purpose |
55|------|---------|
56| `get_page_map` | Navigate to URL, return structured map with ref numbers |
57| `execute_action` | Click, type, select, hover by ref number |
58| `fill_form` | Batch-fill multiple form fields |
59| `get_page_state` | Lightweight state check (URL, title) |
60| `scroll_page` | Scroll up/down/to position |
61| `wait_for` | Wait for text to appear/disappear |
62| `take_screenshot` | Capture viewport or full page |
63| `navigate_back` | Go back in browser history |
64| `batch_get_page_map` | Read multiple URLs in parallel |
65