SOsintOps/claudii-exploratores

### OSINT Suite for Claude — Agent Skill + MCP Server
"The scouts of Claudius" — a nod to the Roman reconnaissance units (exploratores)
and to Claude. OSINT reconnaissance, ported for AI agents.
> [!WARNING]
> This is ALPHA software. Do not use it in production before testing.
> Claudii Exploratores is an early (alpha), community-maintained port of the Exploratores
> toolkit. It is covered by an automated test suite, but it has not been hardened or
> validated for production or operational use. Search URLs, validators and the tool
> catalog may contain errors inherited from upstream or introduced by the port.
> Verify every output independently, test thoroughly in a safe environment, and
> validate results against trusted sources before relying on them. Use at your own
> risk — see Disclaimer.
## Table of Contents
About
Features
How it works
Repository layout
Requirements
Installation
Usage
Available MCP tools
Access warnings: VPN, Tor, accounts
Keeping in sync with Exploratores
Project status
Roadmap
FAQ and version history
Contributing
Security & responsible use
Disclaimer
License
Acknowledgements
## 🔎 About
Claudii Exploratores turns the Exploratores OSINT Toolkit
— a static web application of curated OSINT search links — into two AI-native
distributions:
1. An Agent Skill (skill/) — a drop-in skill for Claude in Claude Code, Cowork
or the Agent SDK. It teaches the model professional OSINT tradecraft (analytic
standards, the 5W1H method, OPSEC) and gives it a CLI that turns any indicator
into a curated set of search links.
2. An MCP server (mcp/) — a Model Context Protocol
server (Python) exposing the same engine as callable tools for Claude Desktop,
Claude Code or any MCP-compatible client.
Both share one language-neutral core: a catalog of 909 OSINT tools across 26
categories (synced with Exploratores 3.10.5), an indicator classifier, per-source
access requirements (VPN country, Tor, account), an offline IBAN verifier and a
reversible PII redactor — all ported from the original toolkit.
> [!IMPORTANT]
> These tools build OSINT search URLs; they never open pages by themselves.
> Opening and reading stays with the operator (or an explicitly-invoked browser
> agent), so OPSEC — VPN, sterile browser profile — remains under human control.
## ✨ Features
909 curated OSINT tools across 26 categories (people, usernames, email,
domains, IP, phones, companies, crypto, IBAN, maps, media, social platforms,
Telegram, Italian and EU legal sources…).
Indicator classifier — auto-detects whether a value is a domain, email, IP,
username, person name, phone, coordinates, IBAN, crypto address, VIN, hashtag,
Normattiva URN, EU case number, EU VAT number, and more.
Curated URL builder — fills and URL-encodes only the tools that fit the
indicator, so you get a relevant, scoped set instead of 900 raw links.
Access warnings — every link to a source that is geo-locked (needs a VPN exit
in a given country), Tor-only or behind a login is flagged before you open it.
Cross-platform pivoting — one username fans out to the right search across
every social/community platform that supports it.
Offline IBAN verifier — ISO 13616 mod-97 check against a 71-country table.