# Veedur-IA & Maloca Analytics — AI Agent Knowledge Protocol (llms.txt)

> Plataforma Cívica y B2B de Inteligencia en Contratación Pública, Detección de Colusión y Gestión BPM en el Edge.
> Powered by SWAL (System for Web3 & Autonomous Logic) and Xavier Cognitive Core.

## Endpoints de API Disponibles para Agentes Autónomos (Agent-Friendly)

- **GET /api/agent/v1/query**: Endpoint de datos estructurados optimizado para scrapers y LLMs. Soporta negociación de contenido (`Accept: text/markdown` o `application/json`).
- **GET /api/search?q={query}&sector={sector}**: Búsqueda en lenguaje natural sobre contratos públicos de SECOP II. Devuelve JSON formateado y análisis estadístico de Benford.
- **GET /api/risk/{contract_id}**: Auditoría de riesgo predictivo, concentración de oferentes y sobrecostos.
- **GET /api/stats**: Resumen consolidado del Data Lake (volumen, distribución de riesgo, histogramas de cuantía).
- **GET /api/red-flags**: Listado de contratos con banderas rojas y atipicidades estadísticas.
- **GET /api/secop1/search?q={query}**: Histórico indexado de SECOP I.
- **GET /api/benchmark/price?q={item}**: Catálogo de precios de referencia Colombia Compra Eficiente (CCE).

## Model Context Protocol (MCP) Tools para Agentes

El servidor MCP local y remoto (`mcp-veeduria`) expone herramientas directas para agentes CLI (Hermes, Codex, Claude, Cursor):
1. `search_contracts`: Búsqueda de contratos SECOP II y análisis Benford.
2. `get_stats`: Métricas consolidadas, distribución de riesgo e histograma.
3. `get_red_flags`: Banderas rojas y señales de colusión/anomalía.
4. `get_contract`: Detalle por ID de contrato con scores de riesgo compuesto.
5. `benford_analysis`: Auditoría de primer dígito (Ley de Benford).
6. `validate_invite`: Verificación de tokens de invitación para veedores.

## Política de Uso y Peaje / Monetización de Scrapers

- **Tier Gratuito (Civic Preview)**: Hasta 10 registros completos por petición sin autenticación ni tarjeta de crédito.
- **Tier Comercial / Agentes Pro**: Para extracción masiva (>100.000 filas/día) o pipelines automatizados, consultar:
  - Header HTTP: `Link: <https://colombia-analytics.swal.network/api/pricing/agent>; rel="monetization"`
  - Endpoint de Tarificación: `GET /api/pricing/agent`
  - Licencia de datos: `X-Data-License: Open-Preview-Commercial-Paid`

## Repositorios y Data Lake

- **Datalake Hugging Face**: `https://huggingface.co/datasets/iberi22/secop-datalake` (Apache Parquet particionado)
- **GitHub Open Data**: `https://github.com/iberi22/VeedurIA-DataDrops`
- **Código Fuente**: `https://github.com/iberi22/VeedurIA`