ARGUS - Research Orchestrator
Not a search engine, not a scraper, not a wrapper. A research orchestration skill and CLI that routes any AI agent through existing open-source tools using a 5-wave methodology with cross-verification.
Philosophy: do not reinvent the wheel. Compose existing tools (yt-dlp, Firecrawl, Crawl4AI, TEx, Telerecon) into one coherent research workflow.
Quick start
ARGUS: <query>
ARGUS: compare Notion vs Obsidian
ARGUS: platform AI agents on Twitter
ARGUS: timebox EU AI Act 2024-2026
ARGUS: region AI market in Africa
ARGUS: narrow pricing model of Stripe
ARGUS: deep quantum computing startups in Europe
ARGUS: quick who is the CEO of X
Local CLI (standard library only, no install required):
python argus_search.py plan "ARGUS: compare Notion vs Obsidian"
python argus_search.py report "ARGUS: deep AI in Africa" --output ./output
python argus_search.py preview durov --limit 5
python argus_search.py verify ./output/argus-report-<slug>-<date>.md # mandatory gate before delivery
python argus_search.py modes
Install as a package with MCP server (for agents):
pip install . # CLI: argus
pip install .[mcp] # MCP server: argus-mcp
MCP deployment: run the MCP server on stdio or localhost only. Never bind it to a network socket without authentication, TLS, and a path allowlist, because
generate_reportandverify_reportperform filesystem I/O.
Contents
| File | Role |
|---|---|
SKILL.md |
Orchestrator spec: modes, filters, routing, consent workflows, evidence pipeline |
MODES.md |
The 7 research modes in detail |
FILTERS.md |
The 10 filters and language presets |
TOOLS.md |
Routing matrix and tool notes |
USER_GUIDE.md |
Install, 5-step flow, consents, troubleshooting |
DECISIONS.md |
Architecture decision records |
CHANGELOG.md |
Release history |
argus_search.py |
CLI: plan bank, consent gates, report skeleton, Telegram preview, verify gate |
argus_mcp.py |
MCP server: list_modes, plan_research, generate_report, telegram_preview, verify_report |
pyproject.toml |
Packaging: argus-search CLI and argus-mcp server |
Golden rule
No scraping, no forums or Telegram deep search, no dark web, no restricted sources - without asking the user first and getting an explicit
[Y]. Silence means SKIP, always.
Status
- Phase 1 (build) done. Phase 2 (verify) done. Phase 3 (publish prep) done.
- Verified 2026-10-07: 7/7 modes, 7/7 routing entries, 4/4 consents, 5/5 verification checks.
- Full Telegram collection requires the user's own
TELEGRAM_API_IDandTELEGRAM_API_HASH.
Metadata
Release files for emo-argus 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| emo_argus-1.1.0.tar.gz | 18.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| emo_argus-1.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 35.3 kB
Release files / emo_argus-1.1.0.tar.gz
| Download URL | emo_argus-1.1.0.tar.gz |
|---|---|
| Size | 18.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f5393ec6fc8cea0a8d38bde9bbfdebeadd6cee28dad7b3c20246705498054fa0
|
|
BLAKE2b-256 checksum How to use checksums |
6e1790501f368ca07423a29f3b7a0fc63f07bf6b0a1a0463e22c350084255ce5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.5
|
Release files / emo_argus-1.1.0-py3-none-any.whl
| Download URL | emo_argus-1.1.0-py3-none-any.whl |
|---|---|
| Size | 16.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
61468b620fd0a158cb7b95b1fe045a76686bfb6b54f3c1d5c5f926d1a9e99e59
|
|
BLAKE2b-256 checksum How to use checksums |
09649adbe483c0954ec23d16f9beb31574f45c49d296daacbcc3c1cefb5f0798
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.5
|