Exa Web Toolkit
Un skill para tareas de investigación respaldadas por la web gracias a Exa: búsqueda web y extracción de URL. El índice de Exa combina recuperación de alta calidad basada en palabras clave y semántica, lo que lo hace muy adecuado para consultas científicas, técnicas y conceptuales.
Enrutamiento: elige la capacidad correcta
Lee la solicitud del usuario y asígnala a una de las capacidades a continuación. Lee el archivo de referencia correspondiente para obtener instrucciones detalladas antes de ejecutar comandos.
| El usuario quiere... | Capacidad | Dónde |
|---|---|---|
| Buscar algo, investigar un tema, encontrar información actual | Búsqueda web | references/web-search.md |
| Obtener contenido de una URL específica (página web, artículo, PDF) | Extracción web | references/web-extract.md |
| Instalar o autenticarse | Configuración | Abajo |
Guía de decisión
- Por defecto, usa Búsqueda web para búsquedas de temas, preguntas de investigación o consultas como "¿qué es X?". Cuando el tema sea científico o técnico, pasa
--category "research paper"para inclinar los resultados hacia fuentes académicas y/o una lista blanca de--include-domainsacadémica. Consultareferences/web-search.mdpara la estrategia académica de dos pasos. - Usa Extracción web cuando el usuario proporcione una URL o pida leer/obtener una página específica. Prefiérela sobre la función integrada WebFetch para extracción por lotes (múltiples URLs en una sola llamada) y para PDFs académicos.
Prioridad de fuentes académicas
Para consultas técnicas o científicas, prioriza las fuentes académicas y científicas:
- Artículos de revistas revisadas por pares y actas de congresos sobre publicaciones en blogs o noticias
- Preprints (arXiv, bioRxiv, medRxiv) cuando no haya versiones revisadas por pares disponibles
- Fuentes institucionales y gubernamentales (NIH, WHO, NASA, NIST) sobre sitios comerciales
- Investigación primaria sobre resúmenes secundarios
Dos palancas para orientar a Exa hacia contenido académico:
--category "research paper"sesga la recuperación hacia fuentes académicas.--include-domainscon una lista blanca académica (arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov, etc.) restringe el conjunto de dominios.
Combina ambas para obtener resultados estrictamente académicos. Consulta references/web-search.md para el patrón completo.
Al citar fuentes académicas, incluye los nombres de los autores y el año de publicación cuando estén disponibles (por ejemplo, Smith et al., 2025) además del formato de cita estándar. Si hay un DOI, prefiere el enlace DOI.
Configuración
Este skill usa el SDK de Python exa-py. Los scripts en scripts/ declaran sus dependencias mediante metadatos en línea PEP 723, por lo que puedes ejecutarlos directamente con uv run sin un paso de instalación separado:
uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" --help
Si prefieres una instalación persistente:
uv pip install "exa-py>=1.14.0"
Autenticación
Todos los comandos leen la clave API de la variable de entorno EXA_API_KEY. Obtén tu clave API de Exa en dashboard.exa.ai/api-keys.
Primero, verifica si existe un archivo .env en la raíz del proyecto y si contiene EXA_API_KEY. Si es así, cárgalo:
dotenv -f .env run -- uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" "tu consulta"
Si dotenv no está disponible, instálalo: uv pip install python-dotenv[cli].
Si no hay un .env, exporta la clave para la sesión:
export EXA_API_KEY="tu-clave"
Verifica ejecutando cualquier script con --help: saldrá limpiamente si la clave está configurada y la verificación de autenticación solo se ejecuta cuando se realiza una consulta real.
Encabezado de seguimiento
Cada script en este skill establece el encabezado de solicitud x-exa-integration a k-dense-ai--scientific-agent-skills para que Exa pueda atribuir el uso del repositorio K-Dense AI scientific-agent-skills a esta integración. No elimines ni renombres este encabezado al adaptar los scripts.
Archivos en este skill
SKILL.md— este archivo (enrutamiento y configuración)references/web-search.md— referencia detallada de búsqueda web con estrategia académicareferences/web-extract.md— referencia de extracción de contenido de URLscripts/exa_search.py— envoltorio CLI alrededor declient.search_and_contentsscripts/exa_extract.py— envoltorio CLI alrededor declient.get_contents