Google Places — FlashData

Google Places — FlashData

Busca negocios y lugares locales con direcciones, calificaciones disponibles y conteos de reseñas. Crea listas cortas de investigación específicas por ubicación.

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

Una tarea para probar

Encuentra cafeterías en Singapur para una lista corta de investigación local. De los registros devueltos, conserva calificaciones de al menos 4.2 con al menos 20 reseñas; lista las direcciones y marca los campos faltantes.

Instalación y conexión

1. Usa Node.js 22.18 o superior 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 FlashData API Key. Otorga a la clave acceso a google_places. 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-places": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-places/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_places","request_count":1} antes de aprobar una solicitud de pago. Este servidor expone google_places, 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.

Ejemplo de solicitud

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

{
  "name": "google_places",
  "arguments": {
    "query": "coffee shops in Singapore",
    "num": 20
  }
}

Usa la respuesta

Lee results[0].places. Conserva las entradas con calificación de al menos 4.2 y ratingCount de al menos 20, preservando el título, la dirección y los campos disponibles de categoría/contacto para revisión manual.

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_places",
  "status": "done",
  "results": [
    {
      "places": [
        {
          "title": "Example cafe",
          "address": "Example street",
          "rating": 4.8,
          "ratingCount": 200,
          "category": "Cafe"
        }
      ]
    }
  ],
  "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 Jobs 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 el JSON; no repitas la solicitud de datos pagada. La caché local conserva 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 y la instalación MIT son gratuitos; las llamadas de datos de la API de FlashData son pagadas. Las solicitudes de datos consumen Créditos FlashData pagados; 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.
• Las calificaciones y la información de contacto pueden estar ausentes. La consulta no envía comunicaciones ni garantiza una base de datos comercial completa.
• 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 de agente.

Guía completa de tareas · Registro oficial · Fuente y licencia