Fetch Browser

by TheSethRose
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Enables executing Google searches and extracting structured results, supporting both web and news results with configurable output formats.

  • Supports conversion of web content to clean, structured Markdown format with proper formatting of lists, bold text, italic text, and links.

  • Provides TypeScript client integration for AI agents to fetch web content and perform Google searches programmatically.

Fetch Browser

A powerful headless browser MCP server that enables AI agents to fetch web content and perform Google searches without requiring any API keys. Built with modern web standards and designed for seamless integration with AI platforms.

Features

  • No API Keys Required: Uses a sophisticated headless browser approach to fetch content directly
  • Smart Google Search:
    • Extract structured results from Google searches
    • Support for both web and news results
    • Configurable number of results (1-100)
    • Full content fetching of search results
    • Automatic retry and error handling
  • Universal Content Fetching:
    • Support for any webpage or API endpoint
    • Multiple output formats (HTML, JSON, Text, Markdown)
    • Automatic content type detection
    • Response size limits and timeout protection
    • Rate limiting protection
  • Format Conversion:
    • Clean HTML to Markdown conversion
    • Pretty-printed JSON responses
    • Structured HTML output
    • Plain text with proper formatting

Tools

Executes Google searches and fetches full content of results:

{ query: "your search query", responseType: "markdown", // or "json", "html", "text" maxResults: 10, // 1-100 results topic: "web" // or "news" }

2. URL Fetcher Tool (fetch_url)

Fetches content from any URL:

{ url: "https://example.com", responseType: "markdown", // or "json", "html", "text" timeout: 30000 // optional, in milliseconds }

Installation

Via Smithery

# For Claude npx -y @smithery/cli install @TheSethRose/fetch-browser --client claude # For Cursor npx -y @smithery/cli install @TheSethRose/fetch-browser --client cursor # For TypeScript npx -y @smithery/cli install @TheSethRose/fetch-browser --client typescript

Manual Installation

# Clone the repository git clone https://github.com/TheSethRose/fetch-browser.git cd fetch-browser # Install dependencies npm install # Build the project npm run build # Start the server npm start

Development

# Watch mode with auto-rebuild npm run watch # Run with inspector npm run inspector # Debug mode npm run debug # Debug with watch mode npm run debug:watch

Response Formats

1. Markdown Format

## [Page Title](https://example.com) Content converted to clean markdown with: - Lists - **Bold text** - *Italic text* - [Links](https://example.com)

2. JSON Format

{ "url": "https://example.com", "content": "Extracted content...", "error": null }

3. HTML Format

<div class="search-result"> <h2><a href="https://example.com">Page Title</a></h2> <div class="content"> Original HTML content </div> </div>

4. Text Format

### https://example.com Plain text content with preserved formatting ==========

Error Handling

  • Automatic retries with exponential backoff
  • Rate limiting protection
  • Timeout handling
  • Detailed error messages
  • Individual result error tracking

Security Features

  • Response size limits
  • Request timeouts
  • Rate limiting protection
  • No API keys or secrets required
  • Proper error handling

Credits

Created by Seth Rose:

License

MIT License - See LICENSE for details

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A headless browser MCP server that allows AI agents to fetch web content and perform Google searches without API keys, supporting various output formats like Markdown, JSON, HTML, and text.

  1. Features
    1. Tools
      1. 1. Google Search Tool (google_search)
        1. 2. URL Fetcher Tool (fetch_url)
        2. Installation
          1. Via Smithery
            1. Manual Installation
            2. Development
              1. Response Formats
                1. 1. Markdown Format
                  1. 2. JSON Format
                    1. 3. HTML Format
                      1. 4. Text Format
                      2. Error Handling
                        1. Security Features
                          1. Credits
                            1. License