Sancho Fetch

Pide a tu IA datos públicos. Obtén archivos reales en tu ordenador.

La forma más rápida: dile a tu IA

Abre el modo Code de tu IA -- aplicación de escritorio de Claude -> pestaña Code, o aplicación de escritorio de ChatGPT -> Codex -- elige cualquier carpeta y pega esto:

Instala Sancho Fetch desde PyPI (uv tool install sancho-fetch) y configúralo en este ordenador. Si uv no está instalado, dímelo y luego instálalo primero. Cuando termines, dime si la instalación se ha realizado correctamente. Luego explícame en un lenguaje sencillo, sin tecnicismos: qué es el archivo .env, cómo usarlo, dónde está en mi ordenador, y ábrelo para que pueda pegar claves de API directamente en él. Dame algunos ejemplos de fuentes de datos que necesitan una clave de API gratuita y algunos ejemplos de fuentes que no necesitan clave. Dime dónde se guardan mis datos descargados y cómo actualizo Sancho más tarde. Luego ejecuta una breve extracción de datos de ejemplo usando el World Bank para que pueda ver dónde se han guardado los datos. Por último, dame algunos ejemplos en lenguaje natural que pueda decirte para obtener datos, para que me haga una idea de cómo usar sancho-fetch, y recuérdame que 1) puedo usarlo en cualquier lugar siempre que esté en la pestaña Code de una aplicación de escritorio de LLM (p. ej., ChatGPT Desktop o Claude Desktop), y 2) que puedo pedir a la IA que añada nuevas fuentes de datos por sí misma, ya que sancho-fetch está construido de forma que sea fácilmente extensible (es decir, puedes añadirle más cosas y la IA hará el trabajo pesado y conectará la nueva fuente de datos).

Esa es toda la instalación.

No necesitas descargar ni clonar este repositorio. Los dos comandos que ejecuta la IA son:

uv tool install sancho-fetch
sancho setup

Instala una vez, úsalo en todas partes. Sancho se instala una vez en tu ordenador y se conecta a las aplicaciones de IA que encuentra (Claude Desktop, ChatGPT/Codex, VS Code, Cursor). Al final de la configuración te dice claramente qué aplicaciones están listas y cuáles solo necesitan un reinicio o un clic.

Para usar Sancho, solo pide datos y menciona "sancho" en lenguaje sencillo, o escribe /sancho en Claude Code para sentirte genial.

Related MCP server: mix_server

Qué hace

• En el modo Code de tu IA preguntas: "obtén las tasas de asma a nivel de condado para Ohio." Puedes estar trabajando en cualquier carpeta -- Sancho siempre sabe dónde está su carpeta de inicio.

• Tu IA usa Sancho para obtener datos de más de 120 fuentes públicas (Census, World Bank, FDA, USGS, FEMA, ...) y te entrega un archivo que se abre en Excel.

• Todo se guarda en tu ordenador.

Antes de empezar

El requisito habitual es uv. uv instala Sancho de forma aislada y puede obtener un Python compatible sin reemplazar el Python del sistema de tu ordenador. La primera configuración necesita una conexión a internet. No se requieren claves de API para la instalación ni para el ejemplo de World Bank; las claves específicas del proveedor se pueden añadir más tarde.

Primeros pasos (unos 2 minutos)

Instala directamente desde PyPI.

1. Abre el modo Code de tu IA.

• Claude: aplicación de escritorio de Claude -> pestaña Code -> nueva sesión -> elige cualquier carpeta donde quieras que vivan tus datos.

• ChatGPT: aplicación de escritorio de ChatGPT -> Codex -> abre esa carpeta.

2. Pega la solicitud de instalación de la parte superior de esta página.

La IA instala todo, te muestra tu primer archivo de datos y te guía por dónde vive todo.

3. Reinicia las aplicaciones que Sancho te pida reiniciar. La configuración termina con un informe breve; si una aplicación necesita un reinicio o un clic adicional, lo dice en palabras claras.

NOTA: Antes de usar, asegúrate de añadir claves de API para las fuentes que quieras usar.

Muchas fuentes no necesitan clave (World Bank, USGS, FEMA, openFDA, ...). Tu IA te dirá cuándo se necesita una clave de API. Puedes:

1. Abre el archivo .env en la carpeta sancho-workspace y pega tu clave allí; o

2. Pide a tu IA que abra el archivo de claves por ti (sancho env open). Pega la clave en el archivo abierto, no pegues tu clave en el chat.

La configuración normalmente crea .env a partir de .env.example. Si .env no existe, sancho env open lo crea y lo abre. Para hacerlo manualmente, copia .env.example en la misma carpeta, conserva la plantilla original y nombra la copia .env.

Ambos archivos pueden estar ocultos:

• macOS Finder: pulsa Cmd+Shift+. (Comando + Shift + punto).

• Windows File Explorer: selecciona Ver -> Mostrar -> Elementos ocultos.

@Developers, para vuestra información, Sancho está diseñado para leer solo los nombres de las claves, no los valores.

Para contribuir, desarrollar módulos personalizados o instalaciones sin conexión, trabaja desde la carpeta del repositorio. Instala GitHub Desktop (gratis) y luego, en la página de este repositorio, haz clic en Code -> Abrir con GitHub Desktop -> Clonar.

Nota: evita colocar la carpeta de Github en una carpeta que esté dentro de iCloud/OneDrive (por ejemplo, la carpeta Documentos en iCloud). Esto causa problemas con la sincronización de archivos y la velocidad.

Luego haz doble clic en installers/Install Sancho.command (macOS) o en installers/Install Sancho.bat (Windows); en Linux ejecuta bash installers/setup.sh.

• macOS bloquea la primera apertura (el instalador no está notarizado): Ajustes del Sistema -> Privacidad y seguridad -> desplázate hasta el mensaje de archivo bloqueado -> Abrir de todos modos -> ábrelo de nuevo.

• Windows: en "Windows protegió tu PC", haz clic en Más información -> Ejecutar de todos modos.

Uso diario

• En Claude Code / Codex, solo pide datos. En Claude Code también puedes escribir /sancho y /sancho-update directamente.

Después de la instalación, usa una sesión de Code. Sancho está instalado en todo el ordenador, así que no necesitas añadir la carpeta sancho-fetch en futuras sesiones. En Claude Desktop, selecciona la pestaña Code. En Codex, inicia un chat de Code. Los chats normales no pueden acceder a tu instalación local de Sancho.

• Hay instrucciones del sistema para que Sancho devuelva detalles no técnicos de cada extracción de datos, así que si quieres que se devuelvan esos detalles técnicos, dile a tu IA:

"activa el modo desarrollador de Sancho."

• ¿Algo no va bien? Pide a tu IA que ejecute sancho ready -- comprueba tu configuración e informa de lo que falla, sin cambiar tu configuración. Para arreglar los problemas de verdad, pide a tu IA que ejecute sancho doctor --fix.

Dónde se guardan tus archivos

your folder/
  sancho-downloads/    # <-- files you have downloaded via chatting with AI
  sancho-workspace/
    source/            # managed data modules
    custom/            # your own modules -- never overwritten when updating Sancho
    playbooks/         # your repeatable workflows
    fetched-data/      # faithful archive of every fetch (don't edit - this is a cache so we don't have to use API calls unnecessarily)
    analysis-data/     # your derived work
    outputs/           # reports, dashboards, exports
    logs/              # what Sancho did, when, and why
    update-backups/    # snapshots before every update
    .env               # your API keys (never logged, never printed)

Cada extracción escribe un archivo de trabajo que puedes abrir -- en sancho-downloads/ dentro de la carpeta en la que estés trabajando -- y una copia fiel de archivo/caché en sancho-workspace/fetched-data/ para que las solicitudes repetidas reutilicen los datos en caché.

Las tablas llegan como Excel .xlsx con códigos como 01003 intactos; los mapas permanecen en GeoJSON/KML; nada se convierte de una manera que pierda información. Los nombres de archivo empiezan por la fecha: 2026-06-08_194211_alabama-population.xlsx.

Añade tus propias fuentes de datos

Dile a tu IA:

Crea un módulo de Sancho para [esa API / los datos de esa agencia / este archivo que recibo cada mes].

Se crea en custom/, funciona como las fuentes integradas y las actualizaciones de Sancho nunca sobrescriben la carpeta.

Un buen ejemplo de esto es que Sancho obtiene datos de los portales de datos abiertos de Washington DC y Nueva York, que usan un formato común de API/portal de datos abiertos. Se puede pedir a la IA que cree un módulo para otras ciudades y comprobará por sí misma de forma inteligente si la nueva ciudad usa el mismo formato o no; si lo usa, reutilizará el mismo formato de código del módulo (y si no, creará uno nuevo). Te sorprendería cuántas ciudades usan el mismo formato, así que pruébalo si trabajas a un nivel geográfico regional que no esté ya cubierto por los módulos integrados de Sancho.

Actualizaciones

Solo dile a tu IA:

Actualiza Sancho.

La IA actualiza el comando sancho desde PyPI (uv tool upgrade sancho-fetch) y luego migra tu espacio de trabajo de forma segura, con una copia de seguridad y un comando de reversión.

¿Trabajas desde el repositorio de GitHub? En GitHub Desktop: Fetch origin -> Pull origin, y luego dile a tu IA "actualiza Sancho."

Al actualizar, tus propios archivos (custom/, playbooks/, fetched-data/, .env, ...) nunca se tocan.

Si quieres que Sancho deje de mencionar nuevas versiones en los chats (lo hará una vez cada 2 semanas), simplemente establece SANCHO_UPDATE_NUDGE=false en .env para desactivarlo.

Desinstalación

Igual que la instalación: pega una solicitud a tu IA en una sesión de Code:

Desinstala Sancho Fetch de este ordenador: ejecuta sancho uninstall y luego uv tool uninstall sancho-fetch. Conserva mis carpetas sancho-workspace y sancho-downloads -- son mis datos y mis claves de API. Dime cuando termine y qué se ha eliminado.

(Esos dos comandos son toda la desinstalación si prefieres ejecutarlos tú mismo).

Sancho solo elimina lo que instaló: sus habilidades y sus entradas en tus aplicaciones de IA. Cualquier cosa que hayas editado o creado tú mismo se deja intacta y se informa de ello.

Tu carpeta sancho-workspace/ (datos obtenidos, módulos personalizados, claves .env) y tus archivos de sancho-downloads/ se conservan siempre. Eliminar datos es un paso aparte y deliberado que pide confirmación primero -- pregunta a tu IA, o ejecuta sancho uninstall --help para ver cómo.

Más documentación

• CHANGELOG.md -- qué cambió en cada versión.

• README_ALL_INSTRUCTIONS.md -- referencia completa de operador/IA.

• project-docs/MCP_SERVER_SETUP_CLAUDE_CHATGPT_WEB.md -- detalles de configuración de MCP para clientes de escritorio y web.

• project-docs/MODULE_CREATION_GUIDE.md -- cómo tu IA crea nuevos módulos de datos.

Alojar tu propia versión de Sancho

Aunque Sancho está diseñado para ejecutarse en tu propio ordenador, también puedes alojarlo en un servidor para que los usuarios puedan acceder a él a través de la web en lugar de necesitar las aplicaciones de escritorio Claude/Codex.

La idea de alojarlo era principalmente apoyar a organizaciones que imparten talleres prácticos para usuarios que quizá no tengan las habilidades técnicas para instalar Sancho en sus propios ordenadores.

• hosting/README.md -- endpoint de demostración alojado para eventos.

Para asistentes de IA

Si eres un asistente de IA, no actúes desde esta guía rápida. Lee README_ALL_INSTRUCTIONS.md y luego sigue CLAUDE.md o AGENTS.md.

Licencia

El código está licenciado bajo Apache 2.0; la documentación bajo CC BY 4.0 salvo que se indique lo contrario. El nombre, el logotipo y los activos de marca de Sancho están protegidos por separado -- consulta LICENSE, NOTICE, LICENSE-DOCS.md e INTENDED_USE.md.