Los agentes de Hermes admiten llamadas con herramientas a través de MCP, pero se envían sin una herramienta de búsqueda incorporada. Agregar Scavio MCP le brinda a su agente de Hermes acceso a datos de búsqueda de Google, YouTube, Amazon, Walmart, Reddit y TikTok sin código personalizado. El punto final de MCP es https://mcp.scavio.dev/mcp y cuesta $0,005 por llamada a la herramienta. Este tutorial lo conecta en menos de 5 minutos.
Requisitos previos
- Tiempo de ejecución del agente Hermes instalado
- Una clave API de Scavio de scavio.dev
- Familiaridad básica con la configuración de Hermes
Guia paso a paso
Paso 1: Obtenga su clave API de Scavio y su punto final MCP
Regístrese en scavio.dev y anote la URL del servidor MCP.
Bash
# 1. Sign up at https://scavio.dev (free: 250 credits/month)
# 2. Dashboard > API Keys > Create New Key
# 3. MCP endpoint: https://mcp.scavio.dev/mcp
# Verify the MCP server is reachable:
curl -X POST https://mcp.scavio.dev/mcp \
-H 'x-api-key: YOUR_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'Paso 2: Agregue Scavio MCP a la configuración del agente Hermes
Actualice la configuración de su agente Hermes para incluir el servidor Scavio MCP.
# In your Hermes agent config (config.yaml or equivalent):
# Add the MCP server under the tools or mcp_servers section
mcp_servers:
scavio:
url: "https://mcp.scavio.dev/mcp"
headers:
x-api-key: "${SCAVIO_API_KEY}"
tools:
- search
- extract
- tiktok
# Environment variable:
# export SCAVIO_API_KEY=your_key_herePaso 3: Pruebe la herramienta de búsqueda en su agente
Ejecute una consulta de prueba para verificar que la conexión MCP funcione de un extremo a otro.
Python
# Start your Hermes agent with the updated config
# Then send a test message:
# User: Search for the best Python web frameworks in 2026
# Expected agent behavior:
# 1. Agent recognizes it needs live data
# 2. Calls scavio.search tool via MCP
# 3. Receives structured Google results
# 4. Synthesizes answer from live data
# You can also test programmatically:
import requests
SH = {'x-api-key': os.environ['SCAVIO_API_KEY'], 'Content-Type': 'application/json'}
data = requests.post('https://api.scavio.dev/api/v1/search',
headers=SH, json={'query': 'best python web framework 2026', 'country_code': 'us'}).json()
print(f'Results: {len(data.get("organic_results", []))} organic')
print(f'AI Overview: {"yes" if data.get("ai_overview") else "no"}')Paso 4: Configurar búsquedas específicas de la plataforma
Utilice los parámetros de la plataforma para buscar en Reddit, YouTube, Amazon y más.
Bash
# Your Hermes agent can now use these search patterns:
# Google search (default):
# {"query": "serp api comparison", "country_code": "us"}
# Reddit search:
# {"query": "best api for agents", "platform": "reddit", "country_code": "us"}
# YouTube search:
# {"query": "python tutorial 2026", "platform": "youtube", "country_code": "us"}
# Amazon product search:
# {"query": "mechanical keyboard", "platform": "amazon", "country_code": "us"}
# Example agent prompt that triggers multi-platform search:
# "Research what Reddit says about the best SERP APIs,
# then check YouTube for tutorial coverage"
# Cost: $0.005 per search call
# Free tier: 250 searches/month
# Project plan: $30/month = 7,000 searchesEjemplo en Python
Python
# The MCP integration requires no Python code.
# To verify the same data programmatically:
import os, requests
SH = {'x-api-key': os.environ['SCAVIO_API_KEY'], 'Content-Type': 'application/json'}
for platform in ['google', 'reddit', 'youtube']:
data = requests.post('https://api.scavio.dev/api/v1/search',
headers=SH, json={'query': 'best serp api', 'platform': platform if platform != 'google' else None,
'country_code': 'us'}).json()
print(f'{platform}: {len(data.get("organic_results", []))} results ($0.005)')Ejemplo en JavaScript
JavaScript
// MCP integration requires no JS code.
// To verify the same data programmatically:
const SH = { 'x-api-key': process.env.SCAVIO_API_KEY, 'Content-Type': 'application/json' };
for (const platform of [null, 'reddit', 'youtube']) {
const body = { query: 'best serp api', country_code: 'us' };
if (platform) body.platform = platform;
const data = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST', headers: SH, body: JSON.stringify(body)
}).then(r => r.json());
console.log(`${platform || 'google'}: ${(data.organic_results || []).length} results`);
}Salida esperada
JSON
# After config update and agent restart:
Hermes Agent > MCP Servers:
scavio: Connected (3 tools available)
# Test query:
User: Search for best Python web frameworks in 2026
Agent: [Calling scavio.search]
Based on current search results:
1. FastAPI leads for async API development
2. Django 5.1 remains the full-stack standard
3. Litestar gaining traction as FastAPI alternative
google: 10 results ($0.005)
reddit: 8 results ($0.005)
youtube: 10 results ($0.005)