hermes-monid-websearch

Hermes Agent plugin for Monid/TinyFish — free web search & fetch via Monid's agent infrastructure.

🇮🇩 Bahasa Indonesia | 🇨🇳 中文

What is this?

A Hermes Agent plugin that routes web_search and web_extract tool calls through Monid's API, powered by TinyFish.

TinyFish is 100% free — both search and fetch cost $0/call. No subscriptions, no API key required for the search itself (just a free Monid account for the API key).

Why use this?

| Provider | Search cost | Extract cost | |----------|-------------|--------------| | SerpAPI | $25/1K calls | — | | Tavily | $8/1K calls | $0.008/credit | | Exa | $7/1K calls | $1/1K pages | | Brave | $5/1K calls | — | | TinyFish (this plugin) | $0 | $0 |

• Free search — browser-rendered results from the live web, never cached
• Free fetch — render any URL in a real browser, get clean Markdown
• No LLM in the loop — TinyFish is deterministic, returns actual web content
• Fresh results — scope searches to a freshness window down to 60 minutes

Installation

1. Get a Monid API key

1. Create a free account at app.monid.ai
2. Go to API Keys and generate a key
3. Copy the key (shown only once)

2. Install the plugin

Option A: npm (recommended)

npm install -g hermes-monid-websearch
cp -r node_modules/hermes-monid-websearch ~/.hermes/plugins/web/monid

Option B: manual

git clone https://github.com/ashafizullah/hermes-monid-websearch.git
cp -r hermes-monid-websearch ~/.hermes/plugins/web/monid

3. Configure Hermes

# Add your Monid API key
echo "MONID_API_KEY=monid_live_..." >> ~/.hermes/.env

# Enable the plugin
hermes plugins enable web/monid

# Set as default backend
hermes config set web.search_backend monid
hermes config set web.extract_backend monid
hermes config set web.backend monid

4. Restart gateway

hermes gateway restart

Usage

Once configured, all web_search and web_extract calls in Hermes will automatically route through TinyFish:

You: Cari informasi tentang AI agent terbaru
Hermes: [uses web_search via TinyFish — free]

You: Ambil konten dari https://example.com
Hermes: [uses web_extract via TinyFish — free]

Configuration

Optional settings in ~/.hermes/config.yaml:

web:
  monid:
    base_url: "https://api.monid.ai"  # Monid API endpoint
    timeout: 60                       # Request timeout in seconds
    max_fetch_urls: 5                 # Max URLs per extract call (1-10)

Trust model

TinyFish returns real web content — URLs are real, titles and snippets are extracted from actual pages. Unlike LLM-backed search providers (DeepSeek, xAI), there's no model generating summaries or picking URLs. Safer for untrusted input.

API costs

• TinyFish /search: $0/call
• TinyFish /fetch: $0/call
• Monid account: free

You only need a Monid account to get an API key. The key itself is free, and TinyFish calls are not billed.

Troubleshooting

"MONID_API_KEY environment variable not set"

Add your key to ~/.hermes/.env:

MONID_API_KEY=monid_live_...

"Monid web search returned HTTP 401"

Your API key is invalid or expired. Generate a new one at app.monid.ai/access/api-keys.

Plugin not loading

1. Check plugin files exist: ~/.hermes/plugins/web/monid/
2. Check enabled: hermes plugins list | grep monid
3. Clear cache: rm -rf ~/.hermes/plugins/web/monid/__pycache__
4. Restart gateway from a separate shell: hermes gateway restart

Related

• hermes-tinyfish-websearch — Direct TinyFish plugin (no Monid middleman). Same free search & fetch, connects directly to api.search.tinyfish.ai and api.fetch.tinyfish.ai.

License

MIT © Adam Suchi Hafizullah