Model Context Protocol
Using the MCP server for Hyperbrowser integration.
Last updated
Using the MCP server for Hyperbrowser integration.
Last updated
The MCP server provides a standardized interface for AI models to access Hyperbrowser's web automation capabilities. This server implementation supports key functions like web scraping, structured data extraction, and web crawling.
You can see the MCP server code at https://github.com/hyperbrowserai/mcp
Node.js (v14 or later)
npm or yarn package manager
Install the MCP server for Hyperbrowser
Configure your MCP client to connect to the Hyperbrowser MCP server:
For clients that don't support the env
field (like Cursor):
Edit run_server.sh
to include your API key:
Retrieves content from a specified URL in various formats.
Method: scrape_webpage
Parameters:
url
: string - The URL to scrape
outputFormat
: string[] - Desired output formats (markdown
, html
, links
, screenshot
)
apiKey
: string (optional) - API key for authentication
sessionOptions
: object (optional) - Browser session configuration
Example:
Extracts data from webpages according to a specified schema.
Method: extract_structured_data
Parameters:
urls
: string[] - List of URLs to extract data from (supports wildcards)
prompt
: string - Instructions for extraction
schema
: object (optional) - JSON schema for the extracted data
apiKey
: string (optional) - API key for authentication
sessionOptions
: object (optional) - Browser session configuration
Example:
Navigates through multiple pages on a website, optionally following links.
Method: crawl_webpages
Parameters:
url
: string - Starting URL for crawling
outputFormat
: string[] - Desired output formats
followLinks
: boolean - Whether to follow page links
maxPages
: number (default: 10) - Maximum pages to crawl
ignoreSitemap
: boolean (optional) - Skip using site's sitemap
apiKey
: string (optional) - API key for authentication
sessionOptions
: object (optional) - Browser session configuration
Example:
All tools support these common session configuration options:
useStealth
: boolean - Makes browser detection more difficult
useProxy
: boolean - Routes traffic through proxy servers
solveCaptchas
: boolean - Automatically solves CAPTCHA challenges
acceptCookies
: boolean - Automatically handles cookie consent popups