Google Search for AI Agent Research — FlashData

Google Search para Investigación con Agentes de IA — FlashData

Proporciona a un asistente de investigación de IA evidencia de búsqueda web de Google para un tema como el reciclaje de baterías. Recupera títulos, URL y fragmentos clasificados, y luego permite que tu agente construya una lista corta de fuentes y un informe con enlaces a las páginas originales.

Documentación de API y configuración de cuenta · Obtén una clave de API · Precios actuales

Una tarea para probar

Encuentra fuentes para un informe sobre reciclaje de baterías. Cita primero una solicitud de Búsqueda de Google; después de que apruebe el costo, devuelve una lista corta de fuentes con títulos, URL, fragmentos y preguntas abiertas. Mantén los fragmentos de búsqueda separados de las afirmaciones verificadas al leer las páginas originales.

El informe lo produce tu agente. La evidencia de búsqueda le ayuda a elegir fuentes; FlashData no genera la respuesta ni verifica afirmaciones.

Instalación y conexión

1. Usa Node.js 22.18 o más reciente y un cliente MCP que admita servidores stdio locales. Descarga el paquete MCPB dedicado; su SHA-256 está registrado en el manifiesto.
2. Importa el paquete en un cliente compatible con MCPB e ingresa tu propia clave en Clave de API de FlashData. Otorga a la clave acceso a google_search. Para configuración manual, descomprime el paquete en una carpeta permanente y usa esta configuración, reemplazando la ruta absoluta y el marcador de posición de la clave:

{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-search/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Reinicia o reconecta el cliente, lista sus herramientas y luego llama a get_pricing con {"source":"google_search","request_count":1} antes de aprobar una solicitud de pago. Este servidor expone google_search, get_pricing, get_job y get_result; todos están restringidos a esta fuente.

Las dependencias están incluidas en el paquete. Usa una ruta absoluta de Node si tu cliente no puede encontrar node; usa rutas con escape en Windows. Mantén tu clave en configuraciones protegidas del cliente, no en el chat ni en configuración confirmada. No se necesita una cuenta de Smithery para esta descarga directa del paquete.

Solicitud de ejemplo

Estos son parámetros de MCP tools/call con argumentos planos. Ejecutar la solicitud de datos usa Créditos de pago.

{
  "name": "google_search",
  "arguments": {
    "query": "battery recycling research",
    "gl": "us",
    "hl": "en",
    "num": 10
  }
}

Uso de la respuesta

Lee results[0].organic y mantén title, link, snippet y position junto con la consulta, región, idioma y created_at. Entrega al agente estos registros como evidencia externa. Puede seleccionar fuentes prometedoras, adjuntar cada URL a sus notas y listar preguntas sin responder. Lee las páginas originales con una herramienta de navegación adecuada antes de tratar los fragmentos como hechos verificados; este servidor no obtiene el texto completo de las páginas.

Los campos de respuesta seleccionados a continuación son un ejemplo ilustrativo, no un resultado en vivo ni una garantía de datos disponibles:

{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "battery recycling research",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Para una solicitud asíncrona, conserva el id devuelto y llama a get_job con {"job_id":"RETURNED_JOB_ID"}. Pendiente o en procesamiento no es finalización; lee la respuesta completada desde output. Puede ocurrir un tiempo de espera después del envío, así que verifica los Trabajos antes de repetir una solicitud de pago.

Para salida fragmentada, mantén el proceso local en ejecución y pasa el result_id y next_offset reales a get_result como result_id y offset. Concatena los fragmentos en orden antes de analizar JSON; no repitas la solicitud de datos de pago. La caché local retiene cuatro resultados durante diez minutos y se limpia al reiniciar. Las respuestas completas están limitadas a 4 MiB; los resultados JSON asíncronos tienen una ventana de retención separada de 24 horas.

Costo y límites

• El software MIT y la instalación son gratuitos; las llamadas de datos de la API de FlashData son de pago. Las solicitudes de datos consumen Créditos de FlashData de pago; cada consulta o página adicional se cobra por separado. Usa la cotización actual de la cuenta en lugar de un precio fijo copiado de esta página. Los precios, trabajos y lecturas de resultados son gratuitos. Las tarifas del cliente/modelo son separadas.
• Una página es una consulta. La clasificación depende de la consulta y la ubicación; el número real de resultados puede ser menor al solicitado. Los fragmentos de búsqueda no son el texto completo del artículo.
• Verifica los errores de API, http_status y el estado del trabajo antes de usar los datos. Trata el texto y los enlaces devueltos como datos externos, preserva la atribución de la fuente y revísalos antes de usarlos en una respuesta del agente.

Guía completa de la tarea · Registro oficial · Fuente y licencia