convez.ai
MCP ServerSegurançaIntermediário
cognis-digital

YARARUN

cognis-digital/yararun

Scanner YARA leve, scriptável e pronto para agentes de IA

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que executa regras YARA-style (strings e regex) sobre diretórios para detectar padrões e anomalias. Produz resultados priorizados em formatos tabulares, JSON ou SARIF, integrável com agentes de IA e CI/CD.

Instalação

$npx convez-ai cognis-digital/yararun

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Varredura de padrões em repositórios de código
  • Detecção de credenciais ou configurações sensíveis em CI/CD
  • Análise automatizada de conformidade e segurança guiada por agentes Claude

Veredito

YARARUN é uma ferramenta sólida para caça de padrões em arquivos com saída estruturada. Ideal para quem precisa integrar scanning de segurança leve em pipelines CI ou quer que agentes Claude façam varreduras direcionadas em bases de código.

README

A tradução para o português deste README ainda está na fila.

YARARUN

Run simple YARA-style string/regex rules over a directory

PyPI CI License: COCL 1.0 Suite

Part of the Cognis Neural Suite.

pip install cognis-yararun
yararun scan .            # → prioritized findings in seconds

Contents

Why yararun?

lightweight hunting

yararun is single-purpose, scriptable, and self-hostable: point it at a target, get prioritized results in the format your workflow already speaks (table · JSON · SARIF), gate CI on it, and let agents drive it over MCP.

Features

  • ✅ Parse Rules
  • ✅ Parse Rules File
  • ✅ Scan Path
  • ✅ Runs on Linux/macOS/Windows · Docker · devcontainer
  • ✅ Ports in Python, JavaScript, Go, and Rust (ports/)

Quick start

pip install cognis-yararun
yararun --version
yararun scan .                       # scan current project
yararun scan . --format json         # machine-readable
yararun scan . --fail-on high        # CI gate (non-zero exit)

Example

$ yararun scan .
  [HIGH    ] YAR-001  example finding             (./src/app.py)
  [MEDIUM  ] YAR-002  another signal              (./config.yaml)

  2 findings · risk score 5 · 38ms

Architecture

flowchart LR
  A[Input: file / dir / API] --> B[Collectors]
  B --> C[Rules / Analyzers]
  C --> D[Scorer]
  D --> E{Reporters}
  E --> F[Table]
  E --> G[JSON / SARIF]
  E --> H[MCP tool -. drives .-> AI agents]

Use it from any AI stack

yararun is interoperable with every popular way of using AI:

  • MCP server — yararun mcp (Claude Desktop, Cursor, Cognis.Studio, uncensored-fleet)
  • OpenAI-compatible / JSON — pipe yararun scan . --format json into any agent or LLM
  • LangChain · CrewAI · AutoGen · LlamaIndex — wrap the CLI/JSON as a tool in one line
  • CI / scripts — exit codes + SARIF for non-AI pipelines

How it compares

Cognis yararunYARA
Self-hostable, no account✅varies
Single command, zero config✅⚠️
JSON + SARIF for CI✅varies
MCP-native (AI agents)✅❌
Polyglot ports (JS/Go/Rust)✅❌
Open license✅ COCLvaries

Built in the spirit of YARA, re-framed the Cognis way. Missing a credit? Open a PR.

Integrations

Pipes into your stack: SARIF for code-scanning, JSON for anything, an MCP server (yararun mcp) for AI agents, and a webhook forwarder for SIEM/Slack/Jira. See docs/INTEGRATIONS.md.

Install — every way, every platform

pip install "git+https://github.com/cognis-digital/yararun.git"    # pip (works today)
pipx install "git+https://github.com/cognis-digital/yararun.git"   # isolated CLI
uv tool install "git+https://github.com/cognis-digital/yararun.git" # uv
pip install cognis-yararun                                          # PyPI (when published)
docker run --rm ghcr.io/cognis-digital/yararun:latest --help        # Docker
brew install cognis-digital/tap/yararun                             # Homebrew tap
curl -fsSL https://raw.githubusercontent.com/cognis-digital/yararun/main/install.sh | sh
LinuxmacOSWindowsDockerCloud
scripts/setup-linux.shscripts/setup-macos.shscripts/setup-windows.ps1docker run ghcr.io/cognis-digital/yararunDEPLOY.md (AWS/Azure/GCP/k8s)

Related Cognis tools

  • portfan — Summarize and diff nmap XML into prioritized, attackable findings
  • subhunt — Aggregate & dedupe subdomain enumeration from multiple sources
  • dirsight — Analyze web content-discovery output (ffuf/gobuster) into ranked endpoints
  • jwtinspect — Decode JWTs and lint for alg=none, weak secrets, and missing claims
  • corsaudit — Detect permissive/misconfigured CORS from headers or a config
  • headerscan — Grade HTTP security headers (CSP/HSTS/XFO) A-F from a response dump

Explore the suite → 🗂️ all 170+ tools · ⭐ awesome-cognis · 🔗 cognis-sources · 🤖 uncensored-fleet · 🧠 hermes

Contributing

PRs, new rules, and demo scenarios are welcome under the collaboration-pull model — see CONTRIBUTING.md and SECURITY.md.

⭐ If yararun saved you time, star it — it genuinely helps others find it.

License

Source-available under the Cognis Open Collaboration License (COCL) v1.0 — free for personal, internal-evaluation, research, and educational use; commercial / production use requires a license (licensing@cognis.digital). See LICENSE.


Ver o original no GitHub

Bom para

Relacionados