tor-onion-research: skill pack for Hermes Agent

Hermes Skill for OSINT collection from public Tor hidden services, with a crawler and LLM-ready output

What tor-onion-research does

tor-onion-research is a Hermes Skill, with a Russian-language README, for collecting information from publicly accessible Tor hidden services (.onion). It connects to Tor, fetches pages, parses HTML, extracts structured data, stores results and prepares documents for LLM analysis. Its stated purposes are OSINT, analysis of open sources, technical research and monitoring of available resources.

The README says it does not implement authorization bypass, vulnerability exploitation, attacks, hacking or deanonymization of users, and works only with content any ordinary Tor user can see. The Python backend includes a Tor manager, a SOCKS5 HTTP client with retries, a bounded crawler with depth, page and delay limits, an HTML parser, an extractor for LLM documents, SQLite storage and an optional Selenium-driven Tor Browser fallback for JavaScript sites. Hermes commands include status, fetch, crawl, parse and report. It needs Python 3.10 or later and a running Tor.

Key features

Tor connection checks over SOCKS5 and ControlPort
Page fetching through Tor with retries
Bounded crawling with depth, page count and delay limits
HTML parsing and conversion into LLM-ready documents
SQLite storage and a report template
Hermes commands status, fetch, crawl, parse and report

When to use it

Collect public .onion pages for OSINT research
Monitor the availability of publicly reachable hidden services
Turn crawled pages into structured documents for LLM analysis

Who it is for: Researchers and analysts doing lawful OSINT on publicly accessible Tor content who read Russian documentation.

How it fits with Hermes Agent

It is built as a Hermes Skill with a SKILL.md that holds the instructions for Hermes, plus a Python backend for the Tor work.

How to install tor-onion-research

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

cd tor_onion_research
bash scripts/setup_environment.sh
pip install -r requirements.txt
python scripts/check_tor.py --socks-port 9150 --control-port 9151 --json

Requirements: Python 3.10 or later and a running Tor, either Tor Browser or the system tor service

Note: The README says it is intended only for lawful research of publicly accessible content, with the user responsible for legal compliance.

FAQ

What is tor-onion-research?

tor-onion-research is a Hermes Skill for research collection from public Tor hidden services. It fetches, crawls and parses pages and prepares them for LLM analysis.

What do I need to run tor-onion-research?

You need Python 3.10 or later and a running Tor, either Tor Browser or the system tor service. A check script tests the SOCKS5 and ControlPort connection.

Does tor-onion-research bypass logins or identify users?

No. The README says it does not implement authorization bypass, exploitation, attacks, hacking or deanonymization, and only handles content any ordinary Tor user can access.