images-search
Ce skill fait partie du repository officiel brave/brave-search-skills, qui regroupe l'ensemble des skills Brave Search API destinés aux agents de développement IA (Claude Code, Cursor, GitHub Copilot, Codex, etc.). Il documente et expose l'endpoint Images Search de l'API Brave Search, permettant à un agent d'effectuer des recherches d'images à partir d'une requête textuelle.
Ce que fait ce skill
Le skill permet à l'agent d'interroger https://api.search.brave.com/res/v1/images/search pour obtenir jusqu'à 200 résultats d'images par requête. Chaque résultat inclut le titre de l'image, l'URL de la page source, un thumbnail proxifié par Brave (pour la confidentialité), l'URL de l'image originale en pleine résolution, les dimensions, et un score de confiance (low, medium, high). Le filtre SafeSearch est disponible en deux modes : off ou strict (valeur par défaut).
Paramètres principaux
La requête s'articule autour du paramètre obligatoire q (texte de recherche, 1–400 caractères), complété par des options de localisation (country, search_lang), un contrôle du volume de résultats (count, jusqu'à 200), et la correction orthographique automatique (spellcheck). Cette combinaison permet de cibler précisément une audience géographique ou linguistique.
Prérequis et installation
L'utilisation de ce skill nécessite une clé API Brave Search (à obtenir sur https://api.search.brave.com), configurée dans la variable d'environnement BRAVE_SEARCH_API_KEY. L'installation suit le standard Agent Skills : copier le dossier skills/images-search/ dans le répertoire skills de l'agent concerné (.claude/skills/, .cursor/skills/, .github/skills/, etc.), selon les instructions du README du repository parent.
Cas d'usage typiques
Ce skill est particulièrement adapté à la découverte visuelle en volume (galeries, mood boards, pipelines d'analyse d'images), à l'enrichissement de contenu généré avec des illustrations pertinentes, et à toute application nécessitant des résultats strictement filtrés par défaut. Sa capacité à retourner 200 images par requête le distingue des autres skills du repository (web, vidéo, actualités) qui sont limités à 20 ou 50 résultats.