convez.ai
PluginDevOps & InfraestruturaIntermediário
kimwwk

RepoCrunch

kimwwk/repocrunch

Converta repos GitHub em JSON estruturado, sem IA

Ver no GitHub
BomPluginScore · de 0 a 100

Analisador determinístico que converte repositórios GitHub em JSON estruturado, extraindo tech stack, dependências, arquitetura e métricas de saúde. Funciona como biblioteca Python, CLI, API REST ou servidor MCP — sem LLMs, apenas lógica pura e previsível.

Instalação

$npx convez-ai kimwwk/repocrunch

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
9
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.1
Issues abertas
0
Contribuidores
3

Casos de uso

  • Auditar stack tecnológico e dependências de projetos
  • Automatizar análise de saúde e manutenibilidade de repositórios
  • Integrar em pipelines de CI/CD para métricas de código
  • Investigar segurança e signals de vulnerabilidade antes de contribuir

Veredito

Ferramenta sólida e determinística para quem precisa estruturar dados de repositórios GitHub de forma confiável. Múltiplos formatos de uso (lib, CLI, API, MCP) ampliam aplicabilidade; ausência de IA garante previsibilidade, mas limita análises semânticas profundas.

README

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

RepoCrunch

PyPI Python License: MIT

Analyze any public GitHub repository into structured JSON. No AI, no LLMs — fully deterministic.

Give it a repo, get back tech stack, dependencies, architecture, health metrics, and security signals in clean, consistent JSON. Use it as a Python library, CLI tool, REST API, or MCP server.

Quick Start

Requires Python 3.11+.

pip install repocrunch
repocrunch analyze fastapi/fastapi --pretty

That's it. Also works with uv:

uvx repocrunch analyze astral-sh/uv --pretty

Install from source

git clone https://github.com/kimwwk/repocrunch.git
cd repocrunch
uv venv && uv pip install -e ".[all]"

Install just what you need:

uv pip install -e "."          # Library only (httpx + pydantic)
uv pip install -e ".[cli]"     # + CLI
uv pip install -e ".[api]"     # + REST API
uv pip install -e ".[mcp]"     # + MCP server
uv pip install -e ".[all]"     # Everything

Set a GitHub Token (optional)

Without a token you get 60 API calls/hour. With one, 5,000/hour. A token also lets you analyze private repositories you have access to.

export GITHUB_TOKEN=ghp_...

Usage

CLI

repocrunch analyze fastapi/fastapi --pretty          # Full analysis, pretty JSON
repocrunch analyze facebook/react -f tech_stack       # Single field
repocrunch analyze https://github.com/gin-gonic/gin   # Full URL works too
repocrunch serve                                       # Start REST API on :8000
repocrunch mcp                                         # Start MCP server (STDIO)

Python Library

from repocrunch import analyze, analyze_sync

# Async
result = await analyze("fastapi/fastapi")

# Sync
result = analyze_sync("pallets/flask")

print(result.summary.stars)
print(result.tech_stack.framework)
print(result.model_dump_json(indent=2))

REST API

repocrunch serve

# Then:
curl "http://localhost:8000/analyze?repo=fastapi/fastapi" | python -m json.tool
curl "http://localhost:8000/health"
curl "http://localhost:8000/docs"    # OpenAPI docs

MCP Server (for Claude, Cursor, etc.)

repocrunch mcp    # Starts STDIO transport

Sample Output

$ repocrunch analyze pallets/flask --pretty
{
  "schema_version": "1",
  "repo": "pallets/flask",
  "url": "https://github.com/pallets/flask",
  "analyzed_at": "2026-02-08T19:07:31Z",
  "summary": {
    "stars": 71143,
    "forks": 16697,
    "watchers": 2092,
    "last_commit": "2026-02-06T21:23:01Z",
    "age_days": 5787,
    "license": "BSD-3-Clause",
    "primary_language": "Python",
    "languages": { "Python": 99.9, "HTML": 0.1 }
  },
  "tech_stack": {
    "runtime": "Python",
    "framework": null,
    "package_manager": "pip",
    "dependencies": { "direct": 6, "dev": 0 },
    "key_deps": ["blinker", "click", "itsdangerous", "jinja2", "markupsafe", "werkzeug"]
  },
  "architecture": {
    "monorepo": false,
    "docker": false,
    "ci_cd": ["GitHub Actions"],
    "test_framework": "pytest",
    "has_tests": true
  },
  "health": {
    "open_issues": 2,
    "open_prs": 0,
    "contributors": 862,
    "commit_frequency": "daily",
    "maintenance_status": "actively_maintained"
  },
  "security": {
    "has_env_file": false,
    "dependabot_enabled": false,
    "branch_protection": false,
    "security_policy": false
  },
  "warnings": [
    "Branch protection status unknown (requires admin access or authenticated request)"
  ]
}

Supported Ecosystems

LanguageManifest FilesPackage Manager Detection
JavaScript / TypeScriptpackage.jsonnpm, yarn, pnpm, bun (from lockfiles)
Pythonpyproject.toml, requirements.txtpip, poetry, uv, pdm, pipenv
RustCargo.tomlcargo
Gogo.modgo
Java / Kotlinpom.xml, build.gradle, build.gradle.ktsmaven, gradle
RubyGemfilebundler
C / C++CMakeLists.txtcmake

Framework detection covers 40+ frameworks across all supported ecosystems (FastAPI, Django, React, Next.js, Spring Boot, Rails, Gin, Actix, and many more).

What It Detects

CategorySignals
SummaryStars, forks, watchers, age, license, languages
Tech StackRuntime, framework, package manager, direct/dev dependency count, key deps
ArchitectureMonorepo, Docker, CI/CD platform, test framework
HealthCommit frequency (daily/weekly/monthly/sporadic/inactive), maintenance status, contributors, open issues
Security.env file committed, Dependabot enabled, branch protection, SECURITY.md present

Roadmap

Not yet implemented, but planned:

  • Secrets regex scanning — detect leaked API keys, tokens, passwords in the file tree
  • Architecture type classification — library vs. application vs. framework
  • API rate limiting — per-key throttling for the REST API
  • npm/npx package — npx repocrunch analyze owner/repo
  • Vulnerability scanning — known CVE detection in dependencies
  • Comparison mode — side-by-side analysis of multiple repos
  • Historical tracking — track how a repo's health changes over time
  • Platform deployments — Apify Store, Smithery, mcp.so, RapidAPI

Already shipped: RepoCrunch is published on PyPI — pip install repocrunch.

License

MIT

Ver o original no GitHub

Bom para

Relacionados