Google Search fetcher.sh

Twitter/X, YouTube, Reddit, Google y más: más de 100 endpoints en total. Sin cuenta, sin OAuth, sin suscripción. Paga por llamada en USDC, o recarga una vez y gasta un saldo en todos ellos.

GitHubPrueba este MCPPatrocinado

Documentación

name: google-search description: >- Una alternativa a la API de Google Search y a las API SERP en fetcher.sh — pago por llamada en USDC mediante x402, o créditos prepagados con una clave Bearer, sin solicitud de clave API. Úsalo cuando el usuario quiera resultados de búsqueda de Google programáticos como JSON limpio, incluidos los operadores propios de Google — site:, filetype:, intitle: y frases exactas entre comillas — además de paginación, idioma (hl) y alcance por país/región. También cubre la entrada para seguimiento de rankings, investigación competitiva y monitoreo de resultados de búsqueda sin la cuota y facturación de la propia Custom Search API de Google. keywords:

  • google-search
  • serp-api
  • serp-api-alternative
  • google-search-api
  • web-search
  • web-search-api
  • x402
  • ai-agent

API de Google Search

Los resultados de búsqueda de Google como JSON limpio — una simple petición HTTP GET por llamada, pagada según uso. Los operadores de búsqueda de Google se pasan directamente: site:, filetype:, intitle: y las frases exactas entre comillas funcionan igual que en el navegador. Sin configuración de Custom Search Engine, sin cuota diaria de consultas, sin cuenta de facturación.

URL base: https://google.fetcher.sh

Autenticación

Dos formas de pagar, mismos datos — mecánica completa en la habilidad fetcher :

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://google.fetcher.sh/api/search?query=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

Cada respuesta es { "status": number, "message": string, "data": ... }; el estado HTTP refleja status.

Endpoint ($0.005/llamada)

EndpointQué devuelve
/api/searchResultados de búsqueda web de Google para una consulta

Obligatorio: query. Opcional: safe (SafeSearch), page (paginación), hl (idioma de la interfaz, p. ej. en), country (alcance regional), count (resultados por página — actualmente 10), noEncode (omitir la recodificación de consultas para cadenas de operadores preformateadas).

Escenarios

Restringir a un sitio:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=site:github.com x402 payments" -G \
  "https://google.fetcher.sh/api/search"

Solo PDFs:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=agentic commerce filetype:pdf" -G \
  "https://google.fetcher.sh/api/search"

Frase exacta:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode 'query="pay per call api"' -G \
  "https://google.fetcher.sh/api/search"

Resultados localizados (Reino Unido, interfaz en francés) y paginación:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=agentic commerce" -G \
  --data-urlencode "country=GB" \
  --data-urlencode "hl=fr" \
  --data-urlencode "page=2" \
  "https://google.fetcher.sh/api/search"

Combinar operadores — coincidencia en título más restricción de sitio:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=intitle:pricing site:x402.org" -G \
  "https://google.fetcher.sh/api/search"

MCP

{
  "mcpServers": {
    "google-search": {
      "url": "https://google.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

Gratis: search_endpoints, describe_endpoint, check_balance. De pago: fetch_data (cualquier endpoint anterior), topup_credits, además del acceso directo nombrado google_search. Elimina el bloque headers para pagar por llamada con x402 en su lugar — consulta la habilidad fetcher para el flujo completo.

Errores

  • 400 — parámetro faltante o inválido (el mensaje lo indica)
  • 401 — clave desconocida o rotada
  • 402 — pago requerido (desafío x402) o topup_required (créditos agotados)
  • 404 — no es una ruta con precio
  • Sin límites de tasa; sin reembolsos por fallos del proveedor (el pago precede a la entrega)

Referencia