Il y a quelques semaines, Grégory de chez ibou, m'a écrit pour me proposer de tester leur toute nouvelle API de recherche. Ibou, si vous avez zappé ça, c'est le moteur de recherche français de la société Babbar, dont je vous avais présenté Ibou Explorer au printemps dernier. Et le principe de leur API c'est que vous lui envoyez une question, puis vous récupérez des résultats au format JSON, prêts à être gobés par un script ou par un agent IA.

Je me suis dit qu'un petit tuto, ça vaut mieux qu'une longue présentation, donc ce que je vous propose aujourd'hui, c'est de faire 2 trucs concrets avec l'API d'Ibou pour voir ce que ça donne.

D'abord, sans surprise, un petit outil de recherche que n'importe quel agent peut appeler pour répondre en citant ses sources, puis une petite veille qui surveille ce que le web raconte sur un nom (ma marque "Korben" tant qu'à faire).

Créer sa clé et choisir son niveau de détail

L'inscription se fait sur le site d'ibou Platform (sans carte bancaire) et de base, vous avez le droit à 100 unités valables durant 90 jours. Vous créez ensuite une clé sur la page Clés API, puis vous la rangez dans un fichier ~/.config/ibou/key qui ne contient qu'elle, ou dans une variable d'environnement IBOU_API_KEY. Chaque requête la transmettra alors via l'en-tête X-API-Key, et le script qu'on va écrire ira la chercher tout seul à l'un de ces deux endroits.

Ensuite, tout dépend de l'endpoint que vous appelez, puisque l'API propose quatre niveaux de détail pour une même recherche. /v1/urls ne renvoie que les adresses, /v1/results y ajoute l'hôte, le titre, un extrait et la langue, /v1/passage y colle le passage de la page qui répond le mieux, et /v1/page sort tous les passages de la page. Bien sûr, plus c'est complet, plus c'est couteux (mais ça vaaaa).

Les quatre niveaux de réponse de l'API et leur prix par appel

On peut surveiller également son solde de crédits puisque l'API le renvoie après chaque appel dans l'en-tête X-Units-Remaining. Et côté requête, c'est 512 caractères au maximum, et vous pouvez récupérer de 1 à 20 résultats (10 par défaut) au rythme de 3 requêtes par seconde. Je précise ça parce qu'au-delà, si vous êtes trop gourmand, l'API répondra par une jolie erreur 429.

Un moteur de recherche pour votre agent

Allez, on attaque. Voici donc un premier script en Python et sans aucune dépendance que j'ai vibe codé bien sûr et qui prend une question, un niveau (passage par défaut) et un nombre de résultats, puis affiche chaque source numérotée avec son URL et son texte.

Bien sûr, si l'API répond 429 ou 503, mon script attendra le délai indiqué dans Retry-After avant de retenter, 2 fois au maximum pour pas partir en toupie infinie.

#!/usr/bin/env python3 """Recherche web via l'API ibou : python3 ibou.py "ma question" [niveau] [nombre]""" import json, os, sys, time, urllib.request, urllib.error API = "https://platform.ibou.com/api/v1/" def cle(): if os.environ.get("IBOU_API_KEY"): return os.environ["IBOU_API_KEY"] with open(os.path.expanduser("~/.config/ibou/key")) as f: return f.read().strip() def chercher(question, niveau="passage", nombre=5): corps = json.dumps({"query": question, "max_results": nombre}).encode() req = urllib.request.Request(API + niveau, data=corps, headers={ "Content-Type": "application/json", "X-API-Key": cle()}) for essai in range(3): try: with urllib.request.urlopen(req, timeout=30) as r: return json.load(r), r.headers.get("X-Units-Remaining") except urllib.error.HTTPError as e: if e.code in (429, 503) and essai < 2: time.sleep(int(e.headers.get("Retry-After") or 1)) continue sys.exit(f"ibou {e.code} : {e.read().decode()[:200]}") if __name__ == "__main__": question = sys.argv[1] niveau = sys.argv[2] if len(sys.argv) > 2 else "passage" nombre = int(sys.argv[3]) if len(sys.argv) > 3 else 5 reponse, reste = chercher(question, niveau, nombre) for i, r in enumerate(reponse["results"], 1): if isinstance(r, str): print(f"[{i}] {r}") continue print(f"[{i}] {r['title']}\n {r['url']}") texte = r["passage"]["text"] if "passage" in r else r["snippet"] print(" " + " ".join(texte.split()) + "\n") print(f"(unités restantes : {reste})", file=sys.stderr) 

Enregistrez-le sous le nom ibou.py, puis lancez-le avec votre question entre guillemets.

Sur ma première requête "comment vider le cache DNS sur macOS", avec 5 passages, la bonne commande (sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder) figurait dans trois d'entre eux : chez wikiHow, Tech Magazine et MacPaw, chacun avec son adresse. C'est top pour que votre agent puisse répondre ensuite correctement en disant d'où il tient l'info, au lieu de la sortir de sa mémoire.

python3 ibou.py "comment vider le cache DNS sur macOS" passage 5 

Pour Claude Code, ce qui est cool c'est que ça prend la forme d'un skill (vous dites une skill ou un skill d'ailleurs ?). Dans votre projet, mettez donc ce script ibou.py dans un dossier .claude/skills/ibou/, avec ce fichier SKILL.md juste à côté :

--- name: ibou description: Recherche web via l'API ibou. À utiliser dès qu'une question demande une information du web ou une source à citer. --- Lance dans le terminal : python3 .claude/skills/ibou/ibou.py "ta requête" passage 5 Chaque résultat sort numéroté, avec son URL et le passage de la page qui répond le mieux. Réponds uniquement à partir de ces passages et donne l'URL de chaque information utilisée. L'index d'ibou a quelques semaines de retard : sur une actualité récente, dis-le au lieu d'inventer. 

J'ai fait l'essai avec une session Claude Code qui suivait ces consignes à la lettre, et elle a lancé le script puis répondu à partir des passages en donnant leurs URL. Ce ne sont que quatre lignes d'instructions, donc vous pouvez les recoller telles quelles dans n'importe quel agent qui sait lancer une commande.

Une veille sur votre nom

Deuxième usage, faire de la veille. Cet autre script vibe codé lui aussi, réutilise la fonction de recherche, exige 20 résultats au niveau /v1/results (2 unités cramées par appel) et ne vous affichera que les URL qu'il n'a encore jamais vues, en conservant leur trace dans une liste stockée dans ~/.config/ibou/deja-vus.json. Mettez-le dans le même dossier que notre ibou.py précédent puisqu'il l'importe :

#!/usr/bin/env python3 """Veille ibou : python3 veille.py "Korben" "korben.info" ... -> seulement les URL jamais vues""" import json, os, sys from ibou import chercher MEMOIRE = os.path.expanduser("~/.config/ibou/deja-vus.json") vus = json.load(open(MEMOIRE)) if os.path.exists(MEMOIRE) else {} for sujet in sys.argv[1:]: reponse, reste = chercher(sujet, "results", 20) connus = set(vus.get(sujet, [])) nouveaux = [r for r in reponse["results"] if r["url"] not in connus] for r in nouveaux: print(f"[{sujet}] {r['title']} ({r['host']})\n {r['url']}") vus[sujet] = sorted(connus | {r["url"] for r in reponse["results"]}) json.dump(vus, open(MEMOIRE, "w"), indent=1) print(f"(unités restantes : {reste})", file=sys.stderr) 

Ça permet de surveiller comme ça très facilement votre marque ou un sujet qui vous intéresse et surtout, les opérateurs classiques fonctionnent aussi, même si la doc d'ibou n'en dit pas un mot.

Par exemple, -site:joinmastodon.org retirera le site officiel de Mastodon, site: fait l'inverse, "nom prénom" entre guillemets ne ramènera en tête que les infos vous concernant, et -sujet retire des résultats n'importe quel mot clé.

python3 veille.py "Mastodon -site:joinmastodon.org -mastodonte"

Au premier passage, toutes les URL sont nouvelles, donc vous récupérez un inventaire de 20 pages. Chez moi, elles parlaient toutes du réseau social. On y trouvait l'instance mastodon.social, un guide et même un article qui explique aux entreprises de Tahiti pourquoi s'y intéresser.

Sans le -mastodonte, la page d'homonymie de Wikipédia se glissait dans le lot, puisqu'elle renvoie aussi vers l'animal et vers un groupe de metal américain. Mais il a aussi fait sauter la fiche Wikipédia du logiciel, qui présente la mascotte du réseau, un mastodonte.

Choisissez donc bien le mot que vous excluez. Relancé dans la foulée, le script n'a rien affiché, ce qui est normal puisque le classement n'avait pas bougé entre-temps.

Ce que l'index ne voit pas encore

Et c'est là qu'est le drame, car l'index ne voit pas encore les derniers jours... J'ai cherché 20 de mes articles avec site:korben.info et les mots de leur titre : aucun des 10 publiés entre le 3 et le 20 novembre n'est sorti, 4 sur 8 entre le 28 octobre et le 2 novembre, et les plus anciens arrivaient premiers. Même punition pour 6 articles des 19 et 20 novembre chez Le Monde, Numerama et 01net, tous absents.

Donc pour de l'actu chaude, je vous avoue que ce n'est pas encore le bon outil, d'où la dernière ligne de mon skill. Par contre, pour de la doc, des réponses sourcées ou une veille au long cours, ça fait très bien le job.

Côté portefeuille, c'est donc 1 € HT les 1 000 unités, sachant que (et je vous dis ça pour comparer hein), chez Brave par exemple, ils facturent 5 $ les 1 000 requêtes. Chez ibou surtout, ce qui est bien c'est que le crawl, l'index et le classement sont les leurs, hébergés en France et que le texte de vos recherches ne restera que 30 jours au plus dans les logs et ne sera pas utilisé pour vous profiler.

Bref, à tester si vous avez besoin d'API de recherche et que vous n'avez pas envie de vous tourner vers des services américains.

Source : documentation d'ibou Platform