Developers

API & MCP Docs

Conecta tus agentes de IA, sistemas o aplicaciones a DataInsumo. Accede a nuestro repositorio global de insumos orgánicos certificados de forma programática.

Quick Start

Conecta tu agente de IA en 30 segundos:

$ npx bioaudita-datainsumo-mcp --api-key TU_API_KEY

Requiere Node.js 18+ y una API Key. Regístrate para obtener tu key.

Configuración MCP

El Model Context Protocol (MCP) permite a herramientas de IA como Claude Code, Cursor o Windsurf conectarse a fuentes de datos externas. DataInsumo expone 5 herramientas via MCP.

Para Claude Code

Agrega en tu archivo ~/.claude/settings.json o en la configuración del proyecto:

{
  "mcpServers": {
    "datainsumo": {
      "command": "npx",
      "args": ["bioaudita-datainsumo-mcp", "--api-key", "TU_API_KEY"]
    }
  }
}

Para Cursor / Windsurf

Agrega en la configuración MCP del IDE:

{
  "mcpServers": {
    "datainsumo": {
      "command": "npx",
      "args": ["bioaudita-datainsumo-mcp", "--api-key", "TU_API_KEY"]
    }
  }
}

Generar config automáticamente

$ npx bioaudita-datainsumo-mcp --api-key TU_KEY --config

Herramientas MCP Disponibles

search_insumos

Busca insumos orgánicos por nombre comercial, sustancia activa, norma o función técnica.

query string

norma string (NOP, UE...)

funcion string

limit int (max 50)

get_insumo

Obtiene el detalle completo de un insumo: documentos, ficha técnica, organización.

slug string (requerido)

list_normas

Lista todas las normas de certificación orgánica activas (NOP, UE, JAS, etc.) con código, nombre, país y URL oficial.

list_funciones

Lista todas las funciones técnicas de insumos activas (Fertilizante, Fungicida, Insecticida, etc.).

verify_document

Verifica la autenticidad e integridad de un certificado por su hash SHA-256.

file_hash string (64 chars hex)

REST API

Todos los endpoints requieren header X-API-Key.

GET

/api/public/v1/insumos/

Buscar insumos. Filtros: q, norma, funcion, certificadora, estado, organizacion_verificada, ordering

GET

/api/public/v1/insumos/{slug}/

Detalle de un insumo con documentos, ficha extendida y organización.

GET

/api/public/v1/normas/

Catálogo de normas de certificación (NOP, UE, JAS, etc.).

GET

/api/public/v1/funciones/

Catálogo de funciones técnicas (Fertilizante, Fungicida, etc.).

POST

/api/public/v1/documentos/verify/

Verificar documento por hash SHA-256. Body: {"file_hash": "abc..."}

Autenticación & Límites

Autenticación

API REST: Header X-API-Key: TU_KEY

MCP (npm): Se configura con --api-key

MCP (SSE directo): Header Authorization: Bearer TU_KEY

Rate Limits

Tier	Requests/día
Free	100
Pro	5,000
Enterprise	50,000

Se aplica doble capa: Nginx (5 req/s por IP) + throttle diario por key.

Crear cuenta y obtener API Key

Plataforma de BioAudita · Tecnología de ago.cl — Ciencia de Datos, Software & Agentes IA