SIIED · Skill

Skill SIIED API Abierta para tu IA

Una skill que enseña a tu asistente de IA a usar la API abierta del SIIED: qué endpoints existen, cómo descubrir indicadores y conjuntos de datos, y cómo leer microdata correctamente.

Formato Agent Skills

1 archivo SKILL.md

Sin credenciales

Descarga

Archivo de la skill

siied-api-abierta/SKILL.md

Descargar SKILL.md Cómo instalarla

¿Qué es esta skill?

Una skill es un paquete de instrucciones (estándar Agent Skills: un directorio con un SKILL.md en frontmatter YAML + guía en Markdown) que le enseña a un agente de IA cuándo y cómo usar una capacidad concreta. La skill siied-api-abierta contiene:

El mapa completo de endpoints de la API abierta con sus parámetros.
Flujos recomendados: descubrir indicadores → leer ficha → bajar series o filas.
Reglas de oro: nunca inventar IDs, paginar con offset, qué hacer si un indicador no tiene series.

El caso especial de los indicadores enlazados al catálogo de consulta.
Ejemplos curl listos para ejecutar.
Canal de soporte y contacto institucional.

Skill vs MCP: el servidor MCP le da a tu IA herramientas listas que ya hablan con el SIIED. La skill le enseña a manejar la API REST directamente — útil si tu cliente no soporta MCP o prefieres que el agente llame los endpoints por sí mismo (con curl, Python, etc.). Son complementarios: puedes usar ambos.

Cómo instalarla

Descarga el SKILL.md y colócalo en el directorio de skills de tu cliente (cada uno lo lee de una carpeta concreta). Estructura final: una carpeta siied-api-abierta/ que contiene el archivo.

Cliente	Directorio de skills	Ámbito
Claude Code	~/.claude/skills/ · .claude/skills/	usuario / proyecto
Codex CLI	~/.codex/skills/ · .agents/skills/	usuario / proyecto
Cursor	~/.cursor/skills/ · .cursor/skills/	usuario / proyecto
OpenCode	~/.config/opencode/skills/ · .opencode/skills/	usuario / proyecto
Gemini CLI	~/.gemini/skills/ · .agents/skills/	usuario / proyecto
Genérico	.agents/skills/ (estándar) o pegar el contenido como contexto del proyecto	proyecto

Ejemplo de instalación (Claude Code):

mkdir -p ~/.claude/skills/siied-api-abierta
curl -o ~/.claude/skills/siied-api-abierta/SKILL.md \
     https://indicadores.cali.gov.co/static/indicadores/skills/siied-api-abierta/SKILL.md

¿Y el servidor MCP?

Si además de la skill quieres conectar el MCP del SIIED (herramientas nativas en tu asistente), así se instala en cada cliente — más detalle en el instructivo MCP.

Instalación por cliente

Guía rápida para los clientes MCP más usados. En todos los casos el servidor se llama siied; donde se muestra TU_TOKEN reemplázalo por tu token personal u omítelo para la capa pública.

Claude Desktop (app escritorio)

Settings → Developer → Edit Config, o edita claude_desktop_config.json:

macOS ~/Library/Application Support/Claude/ · Windows %APPDATA%\Claude\ · Linux ~/.config/Claude/

{
  "mcpServers": {
    "siied": {
      "command": "/ruta/del/proyecto/.venv/bin/python",
      "args": ["-m", "indicadores.mcp_stdio_entry"],
      "cwd": "/ruta/del/proyecto",
      "env": { "SIIED_MCP_TOKEN": "TU_TOKEN" }
    }
  }
}

Reinicia la app. Para servidor remoto: Settings → Connectors → agregar conector con la URL https://indicadores.cali.gov.co/mcp.

ChatGPT (app escritorio / web)

Se configura por interfaz, sin archivo:

Settings → MCP servers → Add server.
Nombre: siied · elige Streamable HTTP y pega la URL https://indicadores.cali.gov.co/mcp — o STDIO con el comando /ruta/del/proyecto/.venv/bin/python -m indicadores.mcp_stdio_entry (cwd: /ruta/del/proyecto).
Guarda y reinicia.

Con token, añade header Authorization: Bearer TU_TOKEN (HTTP) o la env var SIIED_MCP_TOKEN (stdio). Las acciones de escritura requieren developer mode en planes Business/Enterprise.

Cursor (IDE)

.cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "siied": {
      "url": "https://indicadores.cali.gov.co/mcp",
      "headers": { "Authorization": "Bearer TU_TOKEN" }
    }
  }
}

O local por stdio: "command": "/ruta/del/proyecto/.venv/bin/python", "args": ["-m","indicadores.mcp_stdio_entry"], "cwd": "/ruta/del/proyecto". Soporta ${workspaceFolder} y ${env:VAR}.

VS Code + GitHub Copilot (editor)

.vscode/mcp.json — ojo: la clave es "servers", no mcpServers:

{
  "servers": {
    "siied": {
      "type": "http",
      "url": "https://indicadores.cali.gov.co/mcp",
      "headers": { "Authorization": "Bearer TU_TOKEN" }
    }
  }
}

Alternativa portable para Copilot: .mcp.json en la raíz o ~/.copilot/mcp-config.json con clave "mcpServers". Para stdio usa "type": "stdio" + command/args/cwd. Pulsa Start sobre el bloque del server.

Gemini CLI (terminal)

~/.gemini/settings.json — para HTTP usa httpUrl (url es SSE):

{
  "mcpServers": {
    "siied": {
      "httpUrl": "https://indicadores.cali.gov.co/mcp",
      "headers": { "Authorization": "Bearer TU_TOKEN" }
    }
  }
}

Stdio: "command": "/ruta/del/proyecto/.venv/bin/python", "args": ["-m","indicadores.mcp_stdio_entry"], "cwd": "/ruta/del/proyecto", "env": {"SIIED_MCP_TOKEN":"TU_TOKEN"}. También: gemini mcp add siied -- /ruta/del/proyecto/.venv/bin/python -m indicadores.mcp_stdio_entry. Verifica con /mcp.

Codex CLI (terminal / OpenAI)

~/.codex/config.toml (compartido con ChatGPT desktop):

[mcp_servers.siied]
command = "/ruta/del/proyecto/.venv/bin/python"
args = ["-m", "indicadores.mcp_stdio_entry"]
cwd = "/ruta/del/proyecto"
env = { SIIED_MCP_TOKEN = "TU_TOKEN" }

# o remoto:
# [mcp_servers.siied]
# url = "https://indicadores.cali.gov.co/mcp"
# http_headers = { Authorization = "Bearer TU_TOKEN" }

O vía CLI: codex mcp add siied -- /ruta/del/proyecto/.venv/bin/python -m indicadores.mcp_stdio_entry. Lista con codex mcp list.

OpenCode (terminal)

opencode.json (proyecto) o ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "siied": {
      "type": "remote",
      "url": "https://indicadores.cali.gov.co/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer TU_TOKEN" }
    }
  }
}

Local: "type": "local", "command": ["/ruta/del/proyecto/.venv/bin/python","-m","indicadores.mcp_stdio_entry"], "cwd": "/ruta/del/proyecto", "environment": {"SIIED_MCP_TOKEN":"TU_TOKEN"}.

Windsurf (IDE)

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "siied": {
      "command": "/ruta/del/proyecto/.venv/bin/python",
      "args": ["-m", "indicadores.mcp_stdio_entry"],
      "cwd": "/ruta/del/proyecto",
      "env": { "SIIED_MCP_TOKEN": "TU_TOKEN" }
    }
  }
}

Guarda y haz "Refresh" en el panel MCP de Cascade.

¿Necesitas más acceso?

La skill y la API abierta son públicas — no requieren credenciales. Si eres funcionario y necesitas token MCP para cargar datos o consultar la hoja de vida FICED, escríbenos con tu nombre, organismo, correo institucional y uso previsto.

sistemaestadistico@cali.gov.co

¿Prefieres la burbuja?

También puedes enviar tu requerimiento por la burbuja flotante de chat (esquina inferior derecha del sitio) — llega al mismo correo sistemaestadistico@cali.gov.co.

Sistema Integrado

de Información Estadística Distrital

Resultados IA