Agent Web Search MCP

Pesquisa web DuckDuckGo + buscador de URLs para agentes de IA. Sem necessidade de chave de API no nível gratuito (7 req/IP/dia), nível Pro ilimitado com chave de API.

GitHubExperimente este MCPPatrocinado

Documentação

Agent Web Search MCP

Busca na web + buscador de URLs para agentes de IA. DuckDuckGo Lite — zero chaves de API para começar.

Duas ferramentas: search_web (DuckDuckGo, 10 resultados com título/URL/trecho) e fetch_url (lê o conteúdo da página, remove HTML, limite de 8000 caracteres). Funciona com qualquer cliente compatível com MCP — Claude Code, Cursor, Windsurf, Continue.dev e JSON-RPC puro.

Início Rápido

# Install
npm install
PORT=3169 node index.js

Ou conecte-se diretamente ao endpoint público:

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

Protocolo MCP

JSON-RPC 2.0 padrão. Solicitação:

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

A resposta contém resultados com título, URL e trecho por ferramenta.

Ferramentas Disponíveis

Ferramenta	Descrição
`search_web`	Busca na web via DuckDuckGo. Parâmetro: `query` (string, obrigatório). Máx. 500 caracteres.
`fetch_url`	Busca e extrai texto de qualquer URL. Parâmetro: `url` (string, obrigatório). Saída máx. 8000 caracteres.

Preços

Nível	Preço	Limite	Como
Free	$0	7 req/dia por IP	Nenhuma chave de API necessária
Pro	R$50	Ilimitado	Chave de API via cabeçalho `x-api-key`

Comprar 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"}}}'

Ou pague primeiro, ative depois

Basta pagar R$50 diretamente:

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

Em seguida, chame POST /activate com seu payment_ref e e-mail.

Verificação de Saúde

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"}

Hospede Você Mesmo

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

Implante em qualquer host Node.js (Railway, Fly.io, Render, VPS).

Por Que Isso Existe

Agentes de IA não têm uma busca na web conveniente. A maioria das APIs de busca custa dinheiro ou exige configuração complexa. DuckDuckGo Lite é gratuito, sem chave de API, sem limite de taxa no lado deles — este servidor o envolve em uma interface MCP limpa que qualquer agente pode consumir programaticamente.

Licença

MIT