Utilise Genspark Tool CLI (`gsk` v1.5.0+) comme sous-agent pour recherche web, crawl de pages, analyse de médias et génération image/vidéo/audio via API. USE WHEN: recherche web avec sources citées, crawl de page spécifique, capture screenshot, génération d'images/vidéos avec modèles IA, analyse de fichiers volumineux (PDF, docs), transcription audio. NO-TRIGGER: tâches de code (→ Claude Code), raisonnement complexe sans web (→ DeepSeek/Hermes), accès chat LLM interactif (→ genspark-chat skill).

Genspark CLI — Sous-agent outil

Architecture

gsk est une Tool CLI, pas un routeur LLM. Elle expose des outils spécialisés via API Genspark (clé dans ~/.genspark-tool-cli/config.json), sans accès direct aux LLMs du chat web (Claude Opus, Gemini, etc.).

Ce que gsk PEUT faire :

Recherche web avec citations (gsk search)
Crawl de pages web (gsk crawl)
Screenshot de page (gsk screenshot)
Analyse de docs volumineux (gsk summarize)
Génération d’images (gsk img)
Génération de vidéos (gsk video)
Génération audio/TTS (gsk audio)
Gestion fichiers AI Drive (gsk drive)
Stockage versionné git (gsk sb-git)

Ce que gsk NE PEUT PAS faire :

Lister des modèles LLM de chat (pas de gsk models list)
Accéder aux modèles Claude/Gemini/Kimi du chat Genspark
Remplacer un LLM pour raisonnement → utiliser genspark-chat skill

Wrapper principal

~/.hermes/agents/route-genspark.sh "requête de recherche"

Le wrapper utilise gsk search (alias web_search) par défaut.

Commandes fréquentes

# Recherche web (outil principal)
gsk search "query exacte"

# Crawl d'une page
gsk crawl "https://example.com"

# Screenshot
gsk screenshot "https://example.com"

# Résumé document lourd (PDF, doc)
gsk summarize "https://url/vers/doc.pdf" --question "question ciblée"

# Génération image
gsk img "description de l'image" --model gpt-image-2

# Info sur un modèle de génération
gsk model-info "gpt-image-2"

# Liste des outils disponibles
gsk list-tools

Modèles de génération disponibles (2026-08)

Images

gpt-image-2 — GPT Image 2 (OpenAI, recommandé qualité)
fal-ai/flux-2-pro — Flux 2 Pro
fal-ai/z-image/turbo — Z-Image Turbo (rapide)

Vidéos

kling/v3 — Kling V3 (supporte audio natif)
vidu/q3 — Vidu Q3 (qualité améliorée)

Gestion des erreurs et failover

Erreur	Action
`gsk: command not found`	`npx -y @genspark/cli <commande>`
`401 Unauthorized`	Vérifier clé: `cat ~/.genspark-tool-cli/config.json`
`429 Rate limit`	Attendre 30s, réessayer
`rc != 0`	Le wrapper renvoie `[AGENT_ERROR]` → Hermes bascule sur DDGS

Distinctions clés

Use case	Outil
Recherche web rapide	`gsk search`
Raisonnement + web	`genspark-chat` skill (navigateur)
Code / refactoring	`route-claude.sh` (Claude Code)
Rédaction / synthèse	`route-chatgpt.sh` (Codex)
Terminal / déploiement	`route-antigravity.sh`
Génération média	`gsk img` / `gsk video` / `gsk audio`
Doc technique fraîche	`route-context7.sh` (Context7)

Intégration Context7

Pour enrichir les recherches gsk avec la documentation officielle du package concerné :

# 1. Récupérer la doc à jour
DOC=$(~/.hermes/agents/route-context7.sh "nom-package" "question technique")

# 2. Injecter dans la recherche gsk
gsk search "$(echo "$DOC" | head -20) — ${QUESTION_ORIGINALE}"

Context7 couvre : frameworks JS/TS, infra (opentofu, terraform, coolify), APIs cloud, CLI tools. En cas d’échec Context7 ([AGENT_ERROR]), basculer directement sur gsk search.

genspark-cli

Quand l'utiliser (Trigger)

Mode d'emploi (Usage)