Agent Web Search MCP

Búsqueda web DuckDuckGo + recuperador de URLs para agentes de IA. No se necesita clave API para el nivel gratuito (7 solicitudes/IP/día), nivel Pro ilimitado con clave API.

GitHubPrueba este MCPPatrocinado

Documentación

Agent Web Search MCP

Búsqueda web + recuperador de URL para agentes de IA. DuckDuckGo Lite — sin necesidad de claves API para empezar.

Dos herramientas: search_web (DuckDuckGo, 10 resultados con título/URL/fragmento) y fetch_url (lee el contenido de la página, elimina HTML, límite de 8000 caracteres). Funciona con cualquier cliente compatible con MCP: Claude Code, Cursor, Windsurf, Continue.dev y JSON-RPC puro.

Inicio Rápido

# Install
npm install
PORT=3169 node index.js

O conéctate directamente al endpoint público:

POST https://hermes-api.tiagohanna.com/

Protocolo MCP

JSON-RPC 2.0 estándar. Solicitud:

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_web","arguments":{"query":"latest AI news"}}}

La respuesta contiene resultados con título, URL y fragmento por herramienta.

Herramientas Disponibles

Herramienta	Descripción
`search_web`	Búsqueda web en DuckDuckGo. Parámetro: `query` (cadena, obligatorio). Máximo 500 caracteres.
`fetch_url`	Recupera y extrae texto de cualquier URL. Parámetro: `url` (cadena, obligatorio). Salida máxima de 8000 caracteres.

Precios

Nivel	Precio	Límite	Cómo
Gratis	$0	7 solicitudes/día por IP	Sin necesidad de clave API
Pro	R$50	Ilimitado	Clave API mediante el encabezado `x-api-key`

Compra Pro — Totalmente Automatizado

# Step 1: Initiate purchase
curl -X POST https://hermes-api.tiagohanna.com/buy \
  -H 'Content-Type: application/json' \
  -d '{"email": "your@email.com"}'
# → Returns pending_id + purchase URL

# Step 2: Pay R$50 (Pix or credit card)
# Use the purchase URL from step 1

# Step 3: Activate with payment proof
curl -X POST https://hermes-api.tiagohanna.com/activate \
  -H 'Content-Type: application/json' \
  -d '{"pending_id": "pend-xxx...", "payment_ref": "your-order-id", "email": "your@email.com"}'
# → Returns your API key

# Step 4: Use it
curl -X POST https://hermes-api.tiagohanna.com/ \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_PRO_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_web","arguments":{"query":"hello world"}}}'

O paga primero, activa después

Simplemente paga R$50 directamente:

https://checkout.infinitepay.io/mkblprodutora?lenc=GzcBYBwJduzICuU4dMz9_dyOkAllVa2TwkT_7E2RKFYJ2bUkri-gGqWJ6srTA4cwCNqCttri_stBTnjQE0Q_yqG2uWwiwnsvRA2hzJ4B6qnU07L-YX6heyWdFUDzqqoJoqLJ8pb2uCSRFf8mnhUU5katL8d7T7i1Ubb_24uTCG6ktxvbte6CaufMuigAC7kFBo-ZKVAYAt1MB_AtUnqIBC4d6upcNHvQ6yJu5C1SJx9VQW25UVTI9CEw09TkBZFtSVxreiKxs138EwBEw1VdxA2ziepSCa6WZoZYlHooRZWbmQO6Cg.v1.2e0fe926212753c6

Luego llama a POST /activate con tu payment_ref y correo electrónico.

Verificación de Estado

curl https://hermes-api.tiagohanna.com/
# → {"status":"ok","server":"agent-web-search-mcp","version":"2.0.0","freeTier":"7 req/IP/day","proTier":"R$50 via Pix/Credit"}

Aloja el Tuyo

git clone https://github.com/tiagohanna123/agent-web-search-mcp
cd agent-web-search-mcp
npm install
PORT=3169 node index.js

Despliega en cualquier host de Node.js (Railway, Fly.io, Render, VPS).

Por Qué Existe

Los agentes de IA no tienen una búsqueda web conveniente. La mayoría de las API de búsqueda cuestan dinero o requieren una configuración compleja. DuckDuckGo Lite es gratuito, sin clave API, sin límite de tasa por su parte — este servidor lo envuelve en una interfaz MCP limpia que cualquier agente puede consumir programáticamente.

Licencia

MIT