FrankenSurf MCP server

<!-- mcp-name: io.github.yail259/frankensurf -->

Frankensurf

One read() call for AI agents, stitched from 28 web tools. Cheapest tool first, every page checked, a receipt for every attempt.

Website · Docs · Quick start · Benchmark · Why I built it

Every web tool breaks somewhere, and they break on different sites. Frankensurf sits in front of all of them and gives your agent one call. It tries the cheapest tool first, checks the page is real, moves to a stronger tool only when a site pushes back, and returns clean page data with a receipt of how it got there.

Cheapest firstPlain HTTP, Jina Reader, a local browser, free stealth browsers, hosted browsers, then paid APIs only if you allow them. Every page checkedA challenge page, a login wall or a search page whose results never loaded counts as a failure, not a success. Shows its workEvery result says which tools ran, how long each took, what it cost, and why it stopped.

Quick start

Python 3.12+, on Linux, macOS, or Windows through WSL. No account or key needed.

pip install "frankensurf[mcp]"
frankensurf install        # every free tool: browsers, stealth browsers, local search, Crawl4AI
frankensurf read "https://www.walmart.com/search?q=air+fryer" --explain

The read climbs until it gets the real page:

https://www.walmart.com/search?q=air+fryer
  ✗ http                   CAPTCHA                0.4s
  ✗ local                  CAPTCHA                1.5s
  ✓ camoufox               got the page           15.6s

air fryer - Walmart.com
24,192 characters via camoufox, complete (107 results), free

Shortened. The full README is on GitHub.