GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - OpenOSINT/OpenOSINT: Open-source OSINT agent: 21 public-source tools behind natural-language chat, an MCP server and a Claude Code plugin. Passive by default, no keys to start.

BranchesTags
Open more actions menu

Latest commit

 

History

536 Commits
536 Commits

Folders and files

NameName
Last commit message
Last commit date
.claude-plugin
.claude-plugin
 
 
.github
.github
 
 
.mcp
.mcp
 
 
actors
actors
 
 
assets
assets
 
 
cloud
cloud
 
 
data/metrics
data/metrics
 
 
db
db
 
 
demo
demo
 
 
docs
docs
 
 
legal
legal
 
 
media
media
 
 
openosint
openosint
 
 
reports
reports
 
 
scripts
scripts
 
 
site
site
 
 
skills
skills
 
 
tests
tests
 
 
.dockerignore
.dockerignore
 
 
.env.example
.env.example
 
 
.gitignore
.gitignore
 
 
.mcp.json
.mcp.json
 
 
.python-version
.python-version
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CLA.md
CLA.md
 
 
CLOUD.md
CLOUD.md
 
 
COMMERCIAL.md
COMMERCIAL.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
DISCLAIMER.md
DISCLAIMER.md
 
 
Dockerfile
Dockerfile
 
 
LICENSE
LICENSE
 
 
MANIFEST.in
MANIFEST.in
 
 
Makefile
Makefile
 
 
Procfile
Procfile
 
 
Procfile.demo
Procfile.demo
 
 
README.md
README.md
 
 
RELEASING.md
RELEASING.md
 
 
SECURITY.md
SECURITY.md
 
 
SPONSORS.md
SPONSORS.md
 
 
SPONSORSHIP.md
SPONSORSHIP.md
 
 
docker-compose.yml
docker-compose.yml
 
 
glama.json
glama.json
 
 
llms.txt
llms.txt
 
 
openosint.tape
openosint.tape
 
 
openosint_demo.py
openosint_demo.py
 
 
pyproject.toml
pyproject.toml
 
 
uv.lock
uv.lock
 
 
web-demo-edit.gif
web-demo-edit.gif
 
 

Repository files navigation

OpenOSINT

OpenOSINT is an open-source OSINT agent for investigators and security researchers: 21 public-source tools behind a natural-language interface, with an MCP server.

Release PyPI downloads License MIT MCP Registry Sponsored by IP2Location Sponsored by TestMu AI

OpenOSINT answering a question about a company in chat: tool calls with their times, then an answer with a source on every claim

Run it yourself: uvx openosint web (one command, no keys)
No terminal? Use OpenOSINT Cloud in your browser, first check free

Docs · Claude Code plugin · MCP server · Live demo

Quickstart

Needs uv. No API keys for these commands.

# Local web app with chat, graph and globe
uvx openosint web

# Or one direct check, no AI involved
uvx openosint exposure example.com
Grade: B  Score: 88/100
Checks: email OK, registration OK (passive)
        tls OK, http_headers OK (these touch the target)
  [LOW] DMARC has no aggregate report address (dmarc_no_rua)
  [LOW] Strict-Transport-Security header missing (hsts_missing)

Real output, trimmed and re-wrapped. More commands: CLI reference · install guide.

What you can do

Moved to Quickstart above and the CLI reference.

Tools

What it can look up. Per-tool docs: openosint.tech/tools. Only passive tools are on by default.

Tool What it finds Key needed
search_dns DNS records, SPF, DMARC No
search_rdap Registrar, dates, name servers (RDAP) No
search_whois WHOIS registration data No
search_ip Hostname, ASN, city for an IP Optional
search_ip2location Geolocation, ISP, proxy/VPN/Tor flags (sponsored) Yes
search_gdelt_geo Geolocated news mentions (GDELT) No
generate_dorks Search-dork URLs for a target No
search_paste Paste-site mentions No
search_github Repos, code and users Optional
search_breach Breaches for an email (HaveIBeenPwned) Yes
search_shodan Open ports and banners Yes
search_censys Hosts and certificates Yes
search_virustotal URL, domain and IP reputation Yes
search_abuseipdb IP abuse reports Yes
search_dorks_live Live dork results via Bright Data SERP API¹ Yes
search_footprint Web footprint via Bright Data SERP API¹ Yes
scrape_url Page content via Bright Data Web Unlocker¹ (touches target) Yes
search_username Username across platforms (sherlock; noisy) No
search_email Accounts tied to an email (holehe; noisy) No
search_domain Subdomains (sublist3r; noisy) No
search_phone Carrier and country (phoneinfoga; unverified) No

Sherlock, holehe, sublist3r and phoneinfoga run as local binaries you install yourself. Setting up the Bright Data tools: Using OpenOSINT with Bright Data.

Why OpenOSINT

Tools run as real Python code and every finding cites the call that produced it. Compared with SpiderFoot, OpenOSINT has far fewer modules and is built to be driven by an agent. See the comparison.

Passive by default

Agents and MCP clients are only offered tools that query third-party sources or compute locally. Anything that touches the target or sends many requests from your IP is off until you opt in (--allow-active) and is not listed in an MCP client's tools/list. Passive is not private: every service you query sees the query. Details: Safety.

Use it from Claude Code or any MCP client

/plugin marketplace add OpenOSINT/OpenOSINT
/plugin install openosint@openosint
/openosint:osint example.com
claude mcp add openosint -- uvx --from openosint openosint-mcp
# Codex, Gemini CLI, Cursor and other Agent Skills clients
npx skills add OpenOSINT/OpenOSINT

OpenOSINT in Claude Code: add the marketplace, install the plugin, run /openosint:osint example.com and get a report where every finding cites its tool call

Other clients: MCP docs · Agent Skill.

Go deeper

  • Web UI: openosint web, streaming chat, a news globe and a graph view. Docs
  • REPL: openosint with no arguments. CLI reference
  • MCP server: uvx --from openosint openosint-mcp. Client configs

Web UI + globe

An agent investigation lands as a point on a 3D globe; click it to pivot. Docs

Entity graph

A FollowTheMoney graph with statement-level provenance and a review queue for same_as candidates. Docs

External exposure report (beta)

openosint exposure example.com grades email authentication, TLS, registration and security headers A to F. Docs

Installation

pip install openosint or uvx openosint web. Python 3.10+. Install guide

MCP Server

Works in Claude Desktop, Claude Code, Cursor and any MCP client. Client configs

Configuration

Keys go in the web UI Settings, ~/.openosint/config.env or the environment. All variables · CLI reference

Docker

docker compose up --build, then open http://localhost:8080. Docker notes

OpenOSINT Cloud

The same engine as a hosted chat for a domain, an IP address or a company, with a source on every claim. First check free, no account. Hosted REST and MCP API by request: [email protected].

Sponsors

Featured Integrations

IP2Location.io logo

IP2Location.io — powers search_ip2location · Integration guide

Enhanced IP geolocation, ISP, VPN/Proxy/Tor, and datacenter detection

TestMu AI logo

TestMu AI

TestMu AI (formerly LambdaTest) is an AI-native testing cloud platform built for modern engineering teams. It covers everything from autonomous test creation and fast execution to testing AI agents, chatbots and voice assistants.

Open: Breach / Compromised-Credential Data · Email / Identity Lookup · Residential Proxies — see SPONSORSHIP.md.

Sponsor on Open Collective · tiers in SPONSORSHIP.md · commercial license and support: COMMERCIAL.md.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md. Maintainer: Tommaso Bertocchi · @openosint_oss. Contributors: @consocio (#6).

Legal Disclaimer

For authorized security research and educational use only. Only investigate targets you own or are permitted to assess. Passive does not mean anonymous. Full text: DISCLAIMER.md.

License

MIT. See LICENSE.

¹ Bright Data links in this README are affiliate/referral links: OpenOSINT earns a commission if you sign up through them, at no extra cost to you.

Star History

Star History Chart

About

Open-source OSINT agent: 21 public-source tools behind natural-language chat, an MCP server and a Claude Code plugin. Passive by default, no keys to start.

openosint.tech

Topics

agent-skillsai-agentattack-surfaceclaudeclaude-codeclaude-code-plugincybersecuritydmarcdomain-securityholehemcpmcp-servermodel-context-protocolosintosint-agentosint-toolspassive-reconnaissancereconnaissancesherlockthreat-intelligence

Resources

Readme
MIT license

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

1.9k stars

Watchers

18 watching

Forks

297 forks
Report repository

Releases

Sponsor this project

Packages

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.