Browse Page

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