Hermes Jina Web Extract

What Hermes Jina Web Extract does

The plugin calls https://r.jina.ai/ with the target URL and supports keyless Reader access, an optional JINA_API_KEY for higher limits, JavaScript-capable browser extraction, JSON transport, selector waiting, configurable user agents and Jina cache headers. It uses Hermes' public WebSearchProvider and plugin registration APIs, so it does not patch Hermes core or change the built-in web tools or cache. It can live as a normal Git repository under ~/.hermes/plugins/web/jina/.

Settings sit under plugins.entries in the profile config, including timeout, browser_engine, wait_for, user_agent_mode, target_selector, remove_selector, with_generated_alt, no_cache and cache_tolerance. The backend is chosen with web.extract_backend set to jina. A proxy can be set with JINA_SOCKS5_PROXY or JINA_HTTP_PROXY, but not both, or the plugin fails closed. The proxy URL is sent to Jina in an X-Proxy-Url header over HTTPS, so Jina can read it. The README advises using dedicated proxy credentials.

Key features

• jina provider for the Hermes web_extract tool
• Keyless access, with an optional JINA_API_KEY for higher limits
• Optional SOCKS5 or HTTP upstream proxy passed to Jina
• Browser-engine, selector and user-agent settings
• Maps the web_extract format argument to markdown or html output
• No Hermes core patches

When to use it

• Reading JavaScript-heavy pages as clean markdown from a Hermes agent
• Extracting only part of a page with a CSS target selector
• Routing Jina fetches through a proxy

Who it is for: Hermes Agent users who want Jina Reader as their web extraction backend.

How it fits with Hermes Agent

A Hermes Agent plugin using the public web-provider plugin API, enabled per profile.

Requirements: Hermes Agent with the web-provider plugin API, httpx in the Hermes runtime, and Python 3.11+ for development and tests; JINA_API_KEY and a proxy URL are optional

Note: It provides URL extraction only, with no search, it does not bypass site access controls, and the version is 0.1.0.

FAQ