Nimbleway

WebRouter

Community Nimbleway
Updated

WebRouter is an open source standard that connects your agent to the web

WebRouter

The open source standard for agent web access. One typed interface for search, extract, answer, research, live data and browsers, across two dozen providers.

Documentation · Quickstart · Providers · Examples · Discord

Developer preview: the API may change before 1.0. Share feedback on Discord.

Every web API for agents has its own SDK, parameter names and response shape.WebRouter puts one interface in front of all of them, so switching provider isone argument, a failing provider falls back to the next, and your agent codenever changes.

from web_router import WebRouter

with WebRouter() as router:  # no API key needed to start
    results = router.search("what is retrieval augmented generation", max_results=5, timeout=10)
    pages = router.extract(results.urls[:3], timeout=30)  # markdown, whichever backend serves it

print(results.provider, [doc.url for doc in pages.documents])

Why WebRouter

  • One call shape, every provider. The same request and the same typedresponse from Tavily, Exa, Brave, Perplexity, Firecrawl, Nimble and the rest.Nothing is lost: unmapped fields stay in extra and the raw payload in raw.
  • Never silently weaker. An option a provider cannot honour raisesUnsupportedParameterError instead of being dropped, so a call never runsunder looser constraints than you asked for.
  • Routing based on published benchmarks. auto tries the providers you hold keys for in theorder committed benchmark results rank them, and falls back on an error or anempty answer. response.provider always says who answered.
  • Cost control. Every response says what it cost and how long it took. Capa call or a whole session in dollars and seconds, try the free backendsfirst, and keep a log of what you spent (budgets).
  • Keyless to start. Search, extract and a local browser work with no APIkey. Every key you add unlocks more providers and fallbacks.
  • Built for agents. An MCP server, plus ready-made tools for LangChain,Claude and OpenAI agents.
  • Measure, don't guess. benchmark() and evaluate() compare providers onyour own queries and score their accuracy against known answers.
  • Yours to run. Apache 2.0, runs in your process with your own keys, andsends each key only to its own provider.

Install

pip install "webrouter[all]"     # or: uv add "webrouter[all]"

Python 3.11 or later. Extras per method (search, extract, research,answer, browser, mcp, ...) keep the install small; see theQuickstart.

Keys are read from the environment. Copy .env.example, whichnames every variable and where to get it, and fill in the ones you hold.

Methods

Method What it does Keyless
search Web results for a query Yes
extract Page contents for URLs, in markdown, html or text Yes
answer A written answer with its sources, in one call No
research A multi-step research run, as prose or a schema you give No
live_data A vendor's ready-made scraper for one site, returning records No
open_browser A browser session you drive, local or in the cloud Yes (local)
browse A task handed to a hosted browser agent No
call_vendor A vendor's own API (Google Ads, Datadog, ...) with your credentials No
with WebRouter() as router:
    router.answer("who won the 2022 world cup final")  # .answer, .citations
    router.research("how did nvidia's datacenter mix shift in 2025", output_schema=MySchema)
    router.live_data("amazon_products", {"url": product_url}, provider="brightdata")

    with router.open_browser() as browser:  # a local Chromium, no key
        browser.goto("https://example.com")

Every method has an async twin on AsyncWebRouter.

Providers

Method Providers
Search Nimble, Tavily, Exa, Brave, Perplexity, Parallel, Linkup, You.com, WebIQ, Keenable, DeepSeek, AWS AgentCore, Valyu, Seltz, Octen, Keirolabs, plus the keyless You.com, Exa and Parallel MCP endpoints
Extract Nimble, Tavily, Firecrawl, Exa, Linkup, Oxylabs, Bright Data, Jina Reader, WebIQ, Keenable, DeepSeek, Browserbase
Answer Perplexity, You.com, Linkup, Parallel, Exa, Brave
Research Nimble, Parallel, Perplexity, Linkup, You.com
Live data Nimble, Apify, Bright Data, Oxylabs
Browser sessions Local Chromium, Browserbase, Steel, Hyperbrowser, Anchor, Kernel
Browser agents Browserbase, Browser Use, Skyvern

Providers has each provider's key, theoptions it maps and how it was verified. Adding one is two methods: seeAdding a provider.

Routing and fallback

For search, extract, answer, research and the browser methods, name noprovider and auto serves the call: every provider you hold a key for, in theorder committed benchmark results rank them,then the free tiers. A member that fails, is rate-limited or answers emptypasses the call to the next. A member that cannot honour an option you set isskipped for that call, and if none can, the call raises rather than runningwithout it. Live data has no fallback, since a source belongs to one vendor:live_data_sources() with no provider searches every vendor you hold a keyfor, and each source it returns names its own, which live_data() runs it on.Vendor calls always name their vendor, since an account belongs to one.

from web_router import Provider, WebRouter

WebRouter(Provider.TAVILY).search("...")  # one provider, by name
WebRouter().search("...", provider="exa")  # or per call

router = WebRouter(provider_config={"auto": {"chain": {"extract": ["nimble", "firecrawl"]}}})
router.extract(url)  # Nimble, then Firecrawl if Nimble fails

A named provider is never quietly swapped for another: a missing key raises anerror naming the variable to set. In a service, share one router per process,set timeout= on each call and turn on the web_router logger: seeRunning in production. The auto orderlists each method's order and how it is generated.

Budgets and cost control

from web_router import Budget, WebRouter, prices

router = WebRouter(router="cheapest_first")  # free backends first, then the cheapest paid ones
log = router.log_spend("spend.jsonl")  # from here on, every answered call is logged
response = router.answer("...", budget=Budget(max_cost_usd=0.01, time_limit_s=10))
response.provider, response.cost_usd, response.cost_source, response.elapsed_s

with router.budget(Budget(max_cost_usd=3.0, time_limit_s=600)) as b:
    b.search("...")
    b.research("...")
    b.status()  # spent, reserved, remaining, time left

log.report()  # what you spent, by day, backend and method
prices.estimate("tavily", "search")  # 0.008: list price of one request

Every response carries cost_usd: the backend's own figure where it statesone (cost_source="reported"), else an estimate. Unless a router ranks thebackends itself (the default rules router does not), a cost cap makes autotry the cheaper of the backends that score alike first.

Each attempt is checked against what is left before it starts, so parallelcalls never overspend together, and a backend that does not fit is skippedwith the reason recorded. Estimates come from the list prices shipped inweb_router.prices, not your bill. Only search (its keyless backends) andopen_browser (local) have a $0 backend; Cost and budgetshas the table per method, a fall-back for a batch that runs out, and the spend log. Anexperimental router can also pick the method and provider for each prompt, andurl_policy="public_only" keeps a planned call off private and cloud-metadatahosts. See Smart routing.

Use it from an agent

MCP server. Every method as a tool, running on your machine with your keys:

claude mcp add web-router -- uvx --from "webrouter[mcp]" web-router-mcp

The MCP guide covers Claude Desktop, Cursor and other clients,credentials, tool costs and browser guards.

Agent frameworks. Ready-made web_search and web_extract tools, with acompact rendering for the model and the full response kept for you:

from web_router import WebRouter
from web_router.integrations.langchain import web_router_tools

tools = web_router_tools(WebRouter(), max_results=5)  # LangChain

web_router.integrations.anthropic and web_router.integrations.openai giveClaude and OpenAI agents the same tools as plain tool definitions. SeeAgent integrations.

Compare providers on your own queries

report = router.benchmark("nvidia q3 earnings", providers=["nimble", "tavily", "you-mcp"])
for run in report.runs:
    print(run.provider, run.latency, run.count if run.ok else run.error)

benchmark_extract() does the same for extract, and evaluate() scores eachprovider's accuracy on a question set with known answers (SimpleQA, FRAMES,SealQA or your own CSV) with an LLM judge. SeeBenchmarks and evaluation, andbenchmarks/ for the published runs behind the default order.

WebRouter or calling each provider directly

Each provider's SDK WebRouter
Switching provider Rewrite the call, options and parsing One argument
Response shape Different per provider One typed model, raw payload kept
An unsupported option Varies by provider Raises, naming who can serve it
A provider fails Your retry code Falls back to the next you hold a key for
Which provider to use Guesswork Order from published benchmarks, benchmark() on your queries
Spend Per-vendor dashboards Per-call and per-session caps, list prices in the package
Agent tools One integration per provider One MCP server and one set of tools

Documentation

Contributing

Contributions are welcome, and the most useful one is small: map one more of aprovider's options, or add a provider.

make install  # every extra, dev tools and pre-commit hooks
make check    # lint, typecheck and the offline unit tests; no keys needed

CONTRIBUTING.md has the workflow and the provider checklist,STYLE_GUIDE.md the review standards, andAGENTS.md the rules for AI coding agents working on this repo.

Community

  • Discord: questions in #help, and what you built in #showcase.
  • GitHub Issues: bugs and gaps in a provider's support.
  • GitHub Discussions: proposals and design ideas.
  • SECURITY.md: vulnerabilities. Never in a public channel.

Useful? Star the repo so more agent developers can find it. ⭐

License

Apache License 2.0. The SimpleQA grader prompt vendored atsrc/web_router/evals/prompts/ keeps its own MIT license, inLICENSE-simple-evals beside it.

MCP Server · Populars

MCP Server · New

    Nimbleway

    WebRouter

    WebRouter is an open source standard that connects your agent to the web

    Community Nimbleway
    frontman-ai

    frontman

    The AI agent that lives in your framework/browser

    Community frontman-ai
    Laksh-star

    Screenward

    Movie and TV discovery, watch planning, and streaming availability—for browsers and MCP clients.

    Community Laksh-star
    codescene-oss

    CodeHealth MCP Server

    The CodeScene MCP Server exposes CodeScene’s Code Health analysis as local AI-friendly tools.

    Community codescene-oss
    Poptin-LTD

    poptin-mcp

    Official Poptin MCP server. Connect your AI agent to create email campaigns, analyze popup and form performance, and build targeted audience segments.

    Community Poptin-LTD