Search1API
Integrations

Hermes

Give Hermes Agent live web search, news, page retrieval, sitemap discovery, and trending topics with the native hermes-search1api plugin.

hermes-search1api is a native Hermes Agent plugin that gives Hermes live web access through Search1API — web search, news search, readable page retrieval, sitemap discovery, and trending topics.

It registers these as first-class Hermes tools (search1api_*), not as a swap-in for Hermes's built-in web_search backend and not as an MCP bridge.

A bundled skill (plugin:search1api) teaches the agent when to search, when to read a URL, and which filters fit a quick lookup versus deep research. Load it with skill_view("plugin:search1api").

Install

hermes plugins install superagents-lab/hermes-search1api --enable
export SEARCH1API_KEY="your-key"

SEARCH1API_API_KEY is also accepted. Put the key in ~/.hermes/.env or the shell environment.

The official search1api Python SDK is vendored into the plugin. Its only runtime dependency (httpx) is already part of Hermes.

What the agent can do

ToolWhat it does
search1api_searchLive web search, with time_range, include_sites / exclude_sites, search_service, and optional crawl_results
search1api_newsNews search with the same filters
search1api_crawlRead one public URL as clean Markdown
search1api_sitemapEnumerate a site's URLs
search1api_trendingTrending GitHub repos or Hacker News stories

All tools return JSON. Errors come back as {"success": false, "error": {"type", "message", "status_code?"}}.

Credentials

  1. Create a key in the Search1API dashboard.
  2. Export it as SEARCH1API_KEY (or SEARCH1API_API_KEY).

Credits

Search and news requests cost one credit each; crawling a page costs one additional credit per successfully crawled page. New accounts receive 100 credits without a credit card. See Credits and limits for current rates.

Source

github.com/superagents-lab/hermes-search1api

On this page