API OrioSearch

Base URL : https://orio.heezy.io · Réponses au format Tavily-compatible (JSON).

Authentification

Récupère une clé sur le dashboard (connexion GitHub), puis envoie-la en en-tête :

Authorization: Bearer orio_sk_votre_cle

Quota par défaut : … requêtes/jour par clé. Les en-têtes X-RateLimit-Remaining / X-RateLimit-Limit sont renvoyés à chaque appel.

---

POST /v1/search

Recherche web.

Paramètres

Champ	Type	Défaut	Description
query *	string	—	La requête.
search_depth	basic | advanced	basic	advanced = récupère et extrait le contenu complet.
topic	general | news	general	Catégorie.
max_results	int (1–20)	5	Nombre de résultats.
time_range	day | week | month | year	—	Filtre temporel.
include_images	bool	false	Inclure des images liées.
include_raw_content	bool	false	Contenu complet de chaque page.
include_domains	string[]	[]	Limiter à ces domaines.
exclude_domains	string[]	[]	Exclure ces domaines.

Exemple

curl -X POST https://orio.heezy.io/v1/search \
  -H "Authorization: Bearer orio_sk_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"query":"kubernetes best practices 2026","max_results":5}'

Réponse

{
  "query": "kubernetes best practices 2026",
  "answer": null,
  "results": [
    { "title": "...", "url": "https://...", "content": "extrait…", "score": 0.91, "raw_content": null }
  ],
  "images": [],
  "response_time": 1.23
}

---

POST /v1/extract

Extraction de contenu propre depuis des URLs.

Champ	Type	Défaut	Description
urls *	string[] (1–20)	—	URLs à extraire.
extract_depth	basic | advanced	basic	advanced = tables/contenu embarqué.
format	markdown | text	markdown	Format de sortie.

Exemple

curl -X POST https://orio.heezy.io/v1/extract \
  -H "Authorization: Bearer orio_sk_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://coder.com/docs"],"format":"markdown"}'

{
  "results": [ { "url": "https://coder.com/docs", "raw_content": "# Coder…" } ],
  "failed_results": [],
  "response_time": 0.84
}

---

Codes d’erreur

Code	Sens
400	Requête invalide (ex : query manquant).
401	Clé API manquante, invalide ou révoquée.
429	Quota journalier dépassé.

---

Serveur MCP /mcp

OrioSearch est aussi un serveur MCP distant : branche-le dans n'importe quel client MCP (Claude Code, Claude Desktop, Cursor…) pour donner à ton agent les outils tavily_search et tavily_extract. Endpoint :

URL  : https://orio.heezy.io/mcp     (transport : streamable-http)
Header: Authorization: Bearer orio_sk_votre_cle

Le quota n'est débité que sur les vraies recherches (tools/call), pas sur la connexion.

Claude Code (CLI)

claude mcp add orio --transport http https://orio.heezy.io/mcp \
  --header "Authorization: Bearer orio_sk_votre_cle"

Claude Desktop / Cursor (config JSON)

{
  "mcpServers": {
    "orio": {
      "type": "http",
      "url": "https://orio.heezy.io/mcp",
      "headers": { "Authorization": "Bearer orio_sk_votre_cle" }
    }
  }
}

Outils exposés

Outil	Description
tavily_search	Recherche web (mêmes params que /v1/search).
tavily_extract	Extraction de contenu d'URLs (mêmes params que /v1/extract).

À noter : en interne (workspaces Coder + Atelier), les mêmes outils sont déjà disponibles via la passerelle MetaMCP — sans clé, sur le réseau privé.