L'API Brave Search a supprimé son niveau gratuit en février 2026 et facture désormais 5 $/1K requêtes avec attribution obligatoire. Si votre projet dépendait de la recherche Brave gratuite, ce tutoriel vous guide dans la migration vers Scavio (250 crédits gratuits/mois, aucune attribution requise) avec des modifications de code minimales.
Prérequis
- Intégration existante de l'API Brave Search
- Une clé API Scavio provenant de scavio.dev (inscription gratuite)
Parcours
Étape 1: Comparer les formes d'API
Brave utilise GET avec des paramètres de requête et un en-tête de clé d'abonnement. Scavio utilise POST avec un corps JSON et un en-tête x-api-key. Mappez vos paramètres de requête existants vers le nouveau format.
Bash
# Brave (old)
curl -H 'X-Subscription-Token: BRAVE_KEY' \
'https://api.search.brave.com/res/v1/web/search?q=python+web+framework'
# Scavio (new)
curl -X POST https://api.scavio.dev/api/v1/search \
-H 'x-api-key: SCAVIO_KEY' \
-H 'Content-Type: application/json' \
-d '{"platform": "google", "query": "python web framework"}'Étape 2: Mettre à jour le code Python
Remplacez l'appel HTTP Brave par le point de terminaison POST de Scavio.
Python
import requests, os
# Old Brave code:
# resp = requests.get('https://api.search.brave.com/res/v1/web/search',
# headers={'X-Subscription-Token': os.environ['BRAVE_KEY']},
# params={'q': query})
# results = resp.json()['web']['results']
# New Scavio code:
def search(query: str) -> list:
resp = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': os.environ['SCAVIO_API_KEY'], 'Content-Type': 'application/json'},
json={'platform': 'google', 'query': query}, timeout=10)
return resp.json().get('organic', [])Étape 3: Mettre à jour le code JavaScript
Remplacez l'appel fetch Brave par le point de terminaison POST de Scavio.
JavaScript
// Old Brave code:
// const resp = await fetch(`https://api.search.brave.com/res/v1/web/search?q=${q}`, {
// headers: {'X-Subscription-Token': process.env.BRAVE_KEY}
// });
// New Scavio code:
async function search(query) {
const resp = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: {'x-api-key': process.env.SCAVIO_API_KEY, 'Content-Type': 'application/json'},
body: JSON.stringify({platform: 'google', query})
});
return (await resp.json()).organic || [];
}Étape 4: Mapper les champs de réponse
Mappez les champs de réponse Brave vers leurs équivalents Scavio.
Python
# Brave response field -> Scavio equivalent:
# result.title -> result['title']
# result.url -> result['link']
# result.description -> result['snippet']
# result.age -> result['date'] (if available)
# result.extra_snippets -> (not available, use snippet)
# Normalize function:
def normalize_result(r: dict) -> dict:
return {
'title': r.get('title', ''),
'url': r.get('link', ''),
'description': r.get('snippet', ''),
}Étape 5: Mettre à jour la configuration MCP (le cas échéant)
Si vous utilisiez Brave MCP, remplacez-le par Scavio MCP.
JSON
// In claude_desktop_config.json or .cursor/mcp.json:
// Remove Brave MCP:
// "brave-search": { "command": "npx", "args": ["@anthropic/mcp-brave-search"] }
// Add Scavio MCP:
{
"mcpServers": {
"scavio": {
"url": "https://mcp.scavio.dev/mcp",
"headers": { "x-api-key": "your_scavio_api_key" }
}
}
}Étape 6: Supprimer l'obligation d'attribution
Brave exigeait une attribution dans votre projet pour le crédit gratuit. Scavio n'exige pas d'attribution.
Bash
# Remove from your README/about page:
# 'Powered by Brave Search API' (no longer needed)
# Scavio free tier (250 credits/month) has no attribution requirement.
# You may credit Scavio if you want, but it is not required.Exemple Python
Python
import requests, os
def search_scavio(query: str, platform: str = 'google') -> list:
resp = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': os.environ['SCAVIO_API_KEY'], 'Content-Type': 'application/json'},
json={'platform': platform, 'query': query}, timeout=10)
return [{'title': r['title'], 'url': r.get('link',''), 'snippet': r.get('snippet','')}
for r in resp.json().get('organic', [])]Exemple JavaScript
JavaScript
async function searchScavio(query, platform = 'google') {
const resp = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: {'x-api-key': process.env.SCAVIO_API_KEY, 'Content-Type': 'application/json'},
body: JSON.stringify({platform, query})
});
const data = await resp.json();
return (data.organic || []).map(r => ({title: r.title, url: r.link, snippet: r.snippet}));
}Sortie attendue
JSON
A migrated search integration that works with Scavio instead of Brave, with 250 free credits/month and no attribution requirement.