webular
Search, scrape, crawl, and answer with sources, from your own machine. A CLI and MCP server with one optional key: Jev.
Install / Use
claude mcp add srinitude -- npx -y github:srinitude/webularIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
Our assessment of webular
webular scores 80/100 on our quality scale, 2454th of 2,790 Automation skills we index.
Its MCP Server is 14 KB long, well organised into 15 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 18 days ago, so webular is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (2 minor notes below). An AI review of the same text found nothing harmful.
- noteInstalls by piping a downloaded script into a shellline 53
curl --proto '=https' --tlsv1.2 -fsSL https://webular.dev/install.sh | sh - noteInstalls by piping a downloaded script into a shellline 57
irm https://webular.dev/install.ps1 | iex
AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
webular compared with similar skills
All 4 of these similar skills score higher than webular; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| webular (this skill)by srinitude | 80 | 3 | 18d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install webular?
- Run
claude mcp add srinitude -- npx -y github:srinitude/webular. The install tabs above show the steps for each supported agent. - Which AI agents does webular work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is webular safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (2 minor notes below). An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is webular still maintained?
- The repository was last updated 18 days ago, so webular is actively maintained.
Skill content
View source on GitHubwebular
Search, scrape, crawl, and answer with sources, from your own machine. A CLI and MCP server with one optional key: Jev.
$ webular search "bun javascript runtime" --limit 2
1. Bun: Fast JavaScript runtime, bundler, transpiler and package manager
https://github.com/Jarred-Sumner/bun
https://news.ycombinator.com/item?id=31993622
2. Bun: Fast JavaScript runtime, transpiler, and NPM client written in Zig
https://bun.sh/?launch
https://news.ycombinator.com/item?id=31993429
That search ran with no key. webular is also an MCP server, an agent plugin, and a set of skills. With --json, every command prints the same JSON shape.
Why webular
- No paid API. Every feature runs on open-source parts, on your machine, with no webular server in the middle. It is open source under Apache-2.0.
- One optional key. Jev (
TYPESAFE_API_KEY), reached through the direct TypeSafe endpoint, sharpens the judgment calls. Without it, each decision falls back to its rule-based baseline. - One tool. Search, scrape, crawl, map, extract, summarize, answer, research, and feed share one command set and one JSON contract.
- Polite and repeatable. It respects robots.txt by default (
scrape --ignore-robotsopts out). A date-pinned replay with recorded Jev answers can give the same output again, but live pages still change.
Why webular goes deeper.
How it compares
| Tool | Key needed | Where it runs | In the committed peer run | |---|---|---|---| | webular | None (Jev is optional) | Your machine | Scored | | Exa | Yes | Hosted API with its own search index | Scored | | Firecrawl | Yes | Hosted API | Scored | | Tavily | Yes | Hosted API | No scored calls | | Perplexity | Yes | Hosted API | No scored calls |
<!-- bench:start readme -->- Measured, not claimed. In the peer run from Oct. 22, 2026 at 17:42 UTC, webular search scored 1.000 on 4 search tasks, while exa scored 1.000 on 4 and firecrawl scored 1.000 on 4. A score of 1 means every answer was right. Webular is even with the best rival, exa. Read the benchmark results for every score and the method behind it.
- Agent matrix. 18 of 75 cells scored: webular with Jev off and on, and 23 alternatives, on 3 agent models. A cell is one tool used by one AI agent model; the rest were skipped for lack of a key or an agent adapter. Source: the agent run from Oct. 22, 2026 at 06:24 UTC.
Where others are ahead: Exa, Brave, and Google run their own search indexes, and Exa reports citation precision, which webular does not measure in that run. Peer benchmarks has each rival's row, and the benchmarks guide explains every metric.
Install
macOS and Linux:
curl --proto '=https' --tlsv1.2 -fsSL https://webular.dev/install.sh | sh
Windows (PowerShell):
irm https://webular.dev/install.ps1 | iex
The script picks the build for your OS, CPU, and libc, and the no-AVX2 build on older x64 CPUs. It checks the SHA-256 baked into it before it installs, and installs nothing on a mismatch. With gh on your PATH, it also checks the build's attestation. The install script guide shows how to read it first, pin a release with --version, and uninstall. With Node, npm i -g webular installs it, and npx webular doctor runs it once without installing. Install channels covers npm, npx, bunx, pnpm dlx, Homebrew, Scoop, running from source with Bun, GitHub Packages, release binaries with SHA256SUMS and provenance, upgrade, and shell completions.
Quickstart
-
Check your setup.
doctornames each missing tool (trimmed output):$ webular doctor ok network HTTP 200 ok upgrade https://github.com/srinitude/webular/releases/latest ok jev off (WEBULAR_JEV=off) -
Read a page as clean markdown:
$ webular scrape https://example.com # Example Domain This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes. -
Summarize text with no network and no model:
$ webular summarize --text "Bun is a fast runtime. It runs TypeScript." --sentences 1 --json {"figures":[],"picks":[{"end":22,"index":0,"source_url":null,"start":0,"text":"Bun is a fast runtime."}],"sentences":["Bun is a fast runtime."],"source_url":null,"summary":"Bun is a fast runtime."}
Keys
- No key: every command runs. Each Jev decision uses its built-in baseline.
- Jev key: set
TYPESAFE_API_KEY, from TypeSafe or another provider of Jev. On macOS, webular also reads the Keychain itemtypesafe-ai-api-key.WEBULAR_JEV=offturns Jev off.
security add-generic-password -a "$USER" -s typesafe-ai-api-key -w # macOS Keychain
read -rs TYPESAFE_API_KEY && export TYPESAFE_API_KEY # this shell only
Jev in webular shows the setup for every OS and shell.
Commands
| Command | What it does | Example |
|---|---|---|
| search | Searches the web with no key, or one keyless source | webular search "bun runtime" --source wikipedia |
| scrape | Reads one URL as clean markdown or JSON | webular scrape https://example.com --json |
| crawl | Reads a site page by page on the same host | webular crawl https://example.com |
| map | Finds all URLs for a domain | webular map https://example.com |
| extract | Pulls fields with CSS selectors or a schema | webular extract --help |
| summarize | Picks the key sentences (no model) | webular summarize --text "..." --sentences 1 |
| answer | Answers from sources | webular answer --help |
| research | Runs a multi-step research loop → cited markdown report | webular research "web scraping in 2026" --depth 3 -o report.md |
| parse | Turns local docs into markdown | webular parse --help |
| media | Downloads media; takes a screenshot or PDF in a real browser | webular media --help |
| monitor | Tracks changes to a URL over time | webular monitor --help |
| batch | Scrapes many URLs at once | webular batch --help |
| doctor | Checks your setup and toolchain | webular doctor --json |
| tasks | Lists the mise task graph that defines the commands | webular tasks |
| mcp | Serves webular's features as an MCP server | webular mcp |
| diagram | Lists the XState machines that model the CLI flows | webular diagram |
| audit | Reports whether deepsec is there, plus a scan plan | webular audit |
| act | Drives a real browser | webular act --help |
| feed | Reads an RSS 2.0 or Atom 1.0 feed and lists its items | webular feed https://hnrss.org/frontpage --limit 5 |
| upgrade | Prints the upgrade command for your install; --yes runs it | webular upgrade |
| completions | Prints a shell completion script | webular completions zsh |
| jev | Learns from recorded Jev calls, or labels one as an eval case | webular jev --help |
search --source also takes hackernews and arxiv. webular <command> --help lists every flag. Command reference describes each command.
Use it from an agent
Each way runs the same Mastra workflows, and each judgment call inside them goes to Jev, or to a rule-based fallback when no key is set.
-
MCP server.
webular mcpserves every command as a tool over stdio. Most clients read this block undermcpServers; VS Code usesserversinstead:{ "mcpServers": { "webular": { "command": "webular", "args": ["mcp"] } } }In Claude Code, run
claude mcp add webular -- webular mcp. In Codex CLI, runcodex mcp add webular -- webular mcp. Install channels has the setup for Claude Desktop, Cursor, Windsurf, Cline, Gemini CLI, VS Code, and Zed. -
Agent plugin. It bundles the MCP server and four skills: research, interview, plain language, and Markdown. In Claude Code, run
/plugin install webular --marketplace srinitude/webular. -
Skills only. Copy a folder from
plugins/webular/skillsinto your agent's skills folder. Each skill names only real commands and flags.
The plugin's server has 19 command tools: every command but mcp. webular mcp has 24 MCP tools: those 19, machine.next, and four low-level HTML tools (web.fetch, web.links, web.markdown, and web.readability). Each result holds at most 8,000 characters; a longer one comes back with a cursor for the next part. machine.next replays events on one of webular's flow machines (cliDispatch, commandLifecycle, fetch, jevCommand, mcpServe, or scrapeFallback) and returns its state and allowed next events, with no model call. Agent contract lists what each surface promises. The plugin README covers the HTTP server for local work.
How it works
- Jev, TypeSafe's System One decision model, makes the judgment calls inside each command. A System One model gives a fast, typed answer to one narrow question.
- Mastra workflows run each command as a series of steps.
- Effect is the base of all the code, so errors and config are typed values the code must handle.
- XState machines, with the Stately agent, model each CLI flow so it can be tested and replayed.
Bun runs it. Readability, linkedom, Turndown, unpdf, mammoth, and anydoc read pages. agent-browser and Cua drive real browsers and apps. mise's task graph runs the builds and checks. How it works and Architecture have the details. The docs index links every doc.
Output, exit codes, and behavior
Global options: --json, --ndjson, --select <a,b>, -o/--output <file>, --timeout <ms> (per network try), --no-cache, --why, -h/--help, and -V/--version. --json prints JSON with sorted keys and a stable shape. --why: Show how results were picked. Bare webular --why exits 0. --why adds no network calls. The per-command form never changes a command's exit code. Exit codes: 0 success, 1 failure, 2 usage error, 3 some batch items failed, 127 a command could not start, and 128 + n stopped by signal n (130 for SIGINT, 143 for SIGTERM).
- robots.txt.
scrapereturns statusblockedfor a page that robots.txt disallows.--ignore-robotsfetches one URL anyway and marks itdisallowed.crawl,map, andbatchalways honor robots.txt. - Same input, same result. Pages are cached in
~/.cache/webular.WEBULAR_DETERMINISTIC=1makes search wait for every source.WEBULAR_AS_OFpins the run date that answers cite. - Offline.
summarize --text,parse,tasks,diagram, and--helpneed no network. - Settings. All optional:
WEBULAR_CACHE_DIR(default~/.cache/webular),WEBULAR_NO_CACHE=1(same as--no-cache),WEBULAR_MAILTO(an email
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
