Agent skill · security · aradotso
openosint-ai-osint-framework
AI-powered OSINT agent with interactive REPL, MCP server, and CLI for email/username/domain/IP/phone investigation using 11 integrated tools
Why this skill is useful
Adds a comprehensive suite of executable OSINT investigation tools with integrated AI capabilities that enhance the agent's investigative functions.
What it needs
Requires git, pip installed locally. Requires anthropic, hibp, ipinfo, shodan, virustotal account access. About 8k tokens when loaded. Last updated 2026-08-04. 11 stars on the source repository.
What this skill does
OpenOSINT AI OSINT Framework Skill by ara.so — Security Skills collection. OpenOSINT is an AI-powered Open Source Intelligence framework that combines 11 OSINT tools into a unified interface. It operates as an interactive REPL with natural language investigation, a direct CLI for scripting, and an MCP server for AI client integration. The AI agent intelligently chains tools based on findings and compiles structured reports. All tools run as async subprocess wrappers with hard timeout enforcement. Installation Optional Dependencies Usage Modes Interactive REPL (AI-Powered) In REPL, type natural language queries: REPL commands: <target> - Investigate email/username/domain/IP/phone clear - Reset conversation memory save - Save last report to reports/ tools - List available tools and status config - Show current configuration help - Show all commands exit / Ctrl-D - Exit Direct CLI (No AI) Python API Usage Direct Tool Usage AI Agent Usage Parallel Execution Tool-Specific Examples Email Investigation Username Investigation Domain Investigation IP Investigation Shodan Advanced Queries MCP Server Integration OpenOSINT can run as an MCP server for Claude Desktop or other MCP clients: Then in Claude Desktop, you can use natural language: Configuration Environment Variables Timeouts All tools accept a timeout parameter (seconds): Common Patterns Batch Email Investigation Export Report Error Handling Troubleshooting holehe Not Found sherlock Not Found phoneinfoga Not Found HIBP API Returns 401 Shodan API Returns 401 VirusTotal API Returns 403 Ollama Connection Error Subprocess Timeout Rate Limiting Memory Issues with Large Results Tool Status Check
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/openosint-ai-osint-framework