OpenOSINT/OpenOSINT

OpenOSINT – AI驱动的OSINT助手

是什么 – OpenOSINT是一个自托管的、MIT许可的Python包，将21个公开来源情报（OSINT）实用程序封装在自然语言界面之后。LLM（Claude、Ollama或任何OpenAI兼容模型）充当“代理”，决定运行哪个工具，运行它们，并将结果链接成一份简洁的调查报道。同一工具集可通过以下方式访问：

• 交互式REPL（openosint），
• CLI（openosint email …），
• 基于浏览器的聊天UI（openosint web），或
• 任何MCP兼容客户端都可以调用的**模型上下文协议（MCP）**服务器。

关键功能

功能	详情
AI驱动的工具链	用简单的英语描述目标；LLM选择相关的OSINT工具，运行它们，并将调查结果拼合在一起。
21个模块化工具	电子邮件、用户名、泄露、WHOIS、IP、子域、DNS、dork、实时dork搜索、paste-bin、电话、Shodan、VirusTotal、Censys、IP2Location、AbuseIPDB、GitHub、RDAP、GDELT地理新闻、URL抓取、足迹提取。
三个AI后端	Anthropic Claude（默认）、本地Ollama或任何OpenAI兼容端点（LiteLLM、vLLM、LM Studio等）。
MCP服务器	通过开源模型上下文协议暴露被动工具（默认20个）；可以通过openosint-mcp启动。
默认被动模式	仅提供查询第三方API或本地计算的工具。接触目标基础设施的“活跃”工具被隐藏，除非您通过--allow-active启用它们。
并行执行	--parallel使用asyncio.gather()并发运行独立工具。
自动报告	每次调查后，Markdown（以及可选的PDF）报告保存在reports/下。
会话历史	REPL会话存储在~/.openosint/history/中，可以用openosint history列出。
网页UI	基于浏览器的聊天，支持流式LLM输出、工具卡片和浅色/深色主题。
云选项	相同的工具作为按使用付费的Apify Actors提供；实时演示可在https://demo.openosint.tech获得。

如何开始

# 安装包（Python 3.9+）
pip install openosint

# 启动默认AI REPL（如果您有Anthropic密钥，将使用Claude）
openosint

# 或启动网页UI
openosint web

# 不使用AI运行单个工具
openosint email target@example.com

您需要为打算使用的服务（例如HaveIBeenPwned、Shodan、VirusTotal、IP2Location、Bright Data等）提供API密钥。密钥通过环境变量传递，如各工具的文档所述。

工具级概述（摘录）

• search_email – 使用holehe列出与电子邮件关联的社交账户（噪声大，默认关闭）。
• search_username – 使用sherlock探测400多个网站的用户名（噪声大，默认关闭）。
• search_breach – 查询HaveIBeenPwned以了解泄露暴露情况。
• search_whois – 通过python-whois获取WHOIS数据。
• search_ip – 通过ipinfo.io进行IP地理位置。
• search_dns – 使用dnspython进行DNS记录查找；DKIM探测仅在主动模式下启用。
• search_shodan、search_virustotal、search_censys、search_abuseipdb – 对其各自API的只读查询。
• search_dorks_live / search_footprint – 通过Bright Data进行Google SERP查询（被动，但目标的查询会发送到Bright Data）。
• scrape_url – 通过Bright Data的Web Unlocker获取URL（涉及目标，默认禁用）。

安全与限制

• 被动模式保护您不会意外接触目标的服务器；主动工具必须明确启用。
• 每次调查最多15次工具调用（investigate_multi为30次），以避免失控的使用。
• 所有第三方API调用对各自的提供商可见；README强调“被动并不私密”。
• 法律免责声明：仅对您获得授权调查的目标使用。

安装与许可

• 可通过PyPI安装（pip install openosint）。
• MIT许可证（参见LICENSE）。
• 项目还发布了MCP服务器二进制文件（openosint-mcp），可通过uvx运行，无需单独安装。

---

底线 – OpenOSINT是一个真正的开源AI增强型OSINT平台，让安全分析师能够通过自然语言驱动一套公开来源工具。它结合了基于LLM的编排、灵活的MCP API以及自托管和云托管执行路径，使其成为自动化情报工作流程的有用构建块。