Exa Web Toolkit
Une compétence pour les tâches de recherche assistée par le web, soutenue par Exa : recherche web et extraction d'URL. L'index d'Exa combine une recherche par mots-clés et une recherche sémantique de haute qualité, ce qui le rend bien adapté aux requêtes scientifiques, techniques et conceptuelles.
Routage — choisissez la bonne capacité
Lisez la requête de l'utilisateur et associez-la à l'une des capacités ci-dessous. Consultez le fichier de référence correspondant pour obtenir des instructions détaillées avant d'exécuter les commandes.
| L'utilisateur souhaite... | Capacité | Où |
|---|---|---|
| Chercher quelque chose, rechercher un sujet, trouver des informations récentes | Recherche Web | references/web-search.md |
| Récupérer le contenu d'une URL spécifique (page web, article, PDF) | Extraction Web | references/web-extract.md |
| Installer ou s'authentifier | Configuration | Ci-dessous |
Guide de décision
- Par défaut, utilisez la Recherche Web pour les recherches de sujets, les questions de recherche ou les requêtes du type "qu'est-ce que X ?". Lorsque le sujet est scientifique ou technique, passez
--category "research paper"pour privilégier les sources académiques, et/ou une liste blanche--include-domainsacadémique. Consultezreferences/web-search.mdpour la stratégie académique en deux passes. - Utilisez l'Extraction Web lorsque l'utilisateur fournit une URL ou vous demande de lire/récupérer une page spécifique. Privilégiez cette option par rapport à l'extraction web intégrée pour l'extraction par lots (plusieurs URL en un seul appel) et pour les PDF académiques.
Priorité aux sources académiques
Pour les requêtes techniques ou scientifiques, privilégiez les sources académiques et scientifiques :
- Articles de revues à comité de lecture et actes de conférences plutôt que des articles de blog ou des actualités.
- Preprints (arXiv, bioRxiv, medRxiv) lorsque les versions relues par les pairs ne sont pas disponibles.
- Sources institutionnelles et gouvernementales (NIH, WHO, NASA, NIST) plutôt que des sites commerciaux.
- Recherche primaire plutôt que des résumés secondaires.
Deux leviers pour orienter Exa vers le contenu académique :
--category "research paper"oriente la recherche vers les sources académiques.--include-domainsavec une liste blanche académique (arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov, etc.) restreint l'ensemble des domaines.
Combinez les deux pour des résultats strictement académiques. Consultez references/web-search.md pour le modèle complet.
Lorsque vous citez des sources académiques, incluez les noms des auteurs et l'année de publication, si disponibles (par exemple, Smith et al., 2025), en plus du format de citation standard. Si un DOI est présent, privilégiez le lien DOI.
Configuration
Cette compétence utilise le SDK Python exa-py. Les scripts du répertoire scripts/ déclarent leurs dépendances via les métadonnées en ligne PEP 723, vous pouvez donc les exécuter directement avec uv run sans étape d'installation séparée :
uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" --help
Si vous préférez une installation persistante :
uv pip install "exa-py>=1.14.0"
Authentification
Toutes les commandes lisent la clé API depuis la variable d'environnement EXA_API_KEY. Obtenez votre clé API Exa sur dashboard.exa.ai/api-keys.
Tout d'abord, vérifiez si un fichier .env existe à la racine du projet et contient EXA_API_KEY. Si c'est le cas, chargez-le :
dotenv -f .env run -- uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" "votre requête"
Si dotenv n'est pas disponible, installez-le : uv pip install python-dotenv[cli].
S'il n'y a pas de fichier .env, exportez la clé pour la session :
export EXA_API_KEY="votre-clé"
Vérifiez en exécutant un script avec --help — il se fermera proprement si la clé est définie et la vérification d'authentification ne s'exécutera que lorsqu'une vraie requête est effectuée.
En-tête de suivi
Chaque script de cette compétence définit l'en-tête de requête x-exa-integration sur k-dense-ai--scientific-agent-skills afin qu'Exa puisse attribuer l'utilisation de ce référentiel d'agents scientifiques K-Dense AI à cette intégration. Ne supprimez ni ne renommez cet en-tête lorsque vous adaptez les scripts.
Fichiers de cette compétence
SKILL.md— ce fichier (routage et configuration)references/web-search.md— référence détaillée de la recherche web avec stratégie académiquereferences/web-extract.md— référence d'extraction de contenu URLscripts/exa_search.py— wrapper CLI autour declient.search_and_contentsscripts/exa_extract.py— wrapper CLI autour declient.get_contents