hermes-monid-websearch

What hermes-monid-websearch does

hermes-monid-websearch is a Hermes Agent plugin that routes the web_search and web_extract tool calls through Monid's API, which is powered by TinyFish. Search returns browser-rendered results from the live web rather than cached ones, and fetch renders any URL in a real browser and returns clean Markdown. Searches can be scoped to a freshness window as short as 60 minutes.

The README states that both TinyFish search and fetch cost $0 per call and that the only thing needed is a free Monid account to obtain an API key. TinyFish is described as deterministic, with no LLM generating summaries or choosing URLs, which the README presents as safer for untrusted input than LLM-backed search providers. After you copy the plugin into ~/.hermes/plugins/web/monid, enable it and set the search, extract and default web backends to monid, every web_search and web_extract call in Hermes uses it. Optional settings in config.yaml cover the API base URL, the request timeout and the maximum URLs per extract call, from 1 to 10. The README is also available in Indonesian and Chinese.

Key features

• Routes web_search and web_extract through Monid's TinyFish API
• Browser-rendered live results that are not cached
• URL fetch returned as clean Markdown
• Freshness window down to 60 minutes
• Configurable base URL, timeout and maximum URLs per extract call
• Install through npm or a manual clone

When to use it

• Replacing a paid search backend in Hermes with the Monid and TinyFish route
• Letting a Hermes agent read JavaScript-rendered pages as clean Markdown
• Running research tasks that need fresh results from the last hour

Who it is for: Hermes Agent users who want a no-cost web search and page fetch backend.

How it fits with Hermes Agent

A plugin for Hermes Agent that replaces its web search and extract backend with Monid.

How to install hermes-monid-websearch

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npm install -g hermes-monid-websearch
cp -r node_modules/hermes-monid-websearch ~/.hermes/plugins/web/monid
echo "MONID_API_KEY=monid_live_..." >> ~/.hermes/.env
hermes plugins enable web/monid

Requirements: Hermes Agent, a Monid account to generate an API key stored as MONID_API_KEY in ~/.hermes/.env, and npm for the recommended install route

Note: It requires a Monid account to generate an API key, and the zero-cost pricing is as stated in the README.

FAQ