| name | browse-page |
| description | Browse, read, and interact with web pages using PageMap MCP tools. Covers navigation, element interaction, form filling, and page state management. |
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 linkexecute_action(ref=5, action="type", value="search query") — Type into an inputexecute_action(ref=7, action="select", value="Large") — Select a dropdown optionexecute_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 |
