browse-page

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 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": "[e-mail]"},
  {"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