Saltar al contenido principal

Google Search API

Siesta AI - Google Search permite ejecutar búsquedas web programáticamente a través de la API JSON de Google Custom Search. La conexión es de solo lectura y devuelve un JSON estructurado con los resultados.

1. Configuración de Google Search API (procedimiento práctico)​

  1. Proyecto en Google Cloud: usa un proyecto existente o crea uno nuevo.
  2. Habilitar Custom Search API: en la API Library busca "Custom Search API" y haz clic en Enable. Activación de Custom Search API en API Library
  3. Crea un Programmable Search Engine: en https://programmablesearchengine.google.com/ abre la lista de motores de búsqueda y haz clic en Agregar. Lista de motores de búsqueda en Programmable Search Engine Creación de un nuevo motor de búsqueda
  4. Obtén el Search Engine ID (cx): en los detalles del motor de búsqueda abre la sección Básico y copia el ID del motor de búsqueda. Copia del Search Engine ID (cx)
  5. Genera una API Key: en Google Cloud Console -> APIs & Services -> Credentials -> Crear credenciales -> API key. Creación de API key en Credentials
  6. Restricciones de la clave (recomendado):
    • Restricciones de aplicación: según sea necesario (Ninguna/Sitios web/IP).
    • Restricciones de API: Restringir clave -> Custom Search API.
  7. Configuración en Siesta AI:
    • Conexiones -> Agregar Conexión -> GoogleSearch.
    • Completa Key (API Key) y Cx (Search Engine ID) y selecciona Compartido/Privado.
    • Guarda a través de Continuar. Configuración de Conexión GoogleSearch en Siesta AI

2. Propósito del documento​

El objetivo es permitir el acceso programático a los resultados de búsqueda web a través de la API JSON de Google Custom Search.

3. Resumen de Conexiones​

  • Nombre de Conexión: GoogleSearch
  • Tipo: REST API - Google Custom Search JSON API
  • Autenticación: API Key (Google Cloud) + Search Engine ID (cx) (OAuth no es necesario)
  • Alcance: solo lectura/búsqueda
  • Salida: objeto JSON con resultados de búsqueda
  • Nota: No existen operaciones de escritura; todas las llamadas son idempotentes.

La API JSON de Google Custom Search permite obtener programáticamente resultados de búsqueda de Google a través del Programmable Search Engine, que debe ser creado y configurado antes de su uso.

4. Principios generales​

4.1 Configuración​

  • Search Engine ID (cx): identificador de la instancia de búsqueda personalizada.
  • API Key: parámetro obligatorio para llamadas autorizadas a la API de Google.
  • Salida: JSON que contiene metadatos de búsqueda y conjunto de resultados (título, fragmento, URL, pagemap, etc.).

4.2 Sintaxis de consulta​

  • El parámetro query (alias q) determina el término de búsqueda.
  • Se pueden usar operadores avanzados como site:, intitle: etc. (sintaxis de consulta estándar de Google).

5. Operaciones de API​

5.1 Búsqueda​

Descripción: Realiza una búsqueda web a través de la API JSON de Google Custom Search.
HTTP: GET https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={query}

ParámetroTipoRequeridoDescripción
queryStringSíTérmino de búsqueda (por ejemplo, "mejores prácticas de IA").

Salida

  • Lista de resultados (título, URL, fragmento)
  • Metadatos sobre el número de resultados
  • Posibles bloques adicionales (pagemap)

Comportamiento y límites

  • Respuesta estándar ~10 resultados por página; páginas adicionales a través de start (fuera del alcance de la Conexión).

Errores típicos

  • 400 Bad Request - consulta no válida
  • 401 Unauthorized - API Key no válida
  • 403 Quota Exceeded - cuota diaria excedida

6. Seguridad y gobernanza​

  • Mantén la API Key de forma segura; prefiere restricciones (dominios/IP, limitaciones en Custom Search API).
  • Monitorea las cuotas y registra para control de facturación.
  • Registra al menos: cadena query, tiempo de llamada, número de resultados, estado HTTP.

7. Recomendaciones operativas​

  • Establece una política de rotación para la API Key (Rotar clave en Google Cloud Console).
  • Mantén cx y API Key en un almacén de secretos seguro; al cambiar la clave, actualiza la Conexión.

8. Ejemplo de uso​

GET https://www.googleapis.com/customsearch/v1
  ?key=YOUR_API_KEY
  &cx=YOUR_SEARCH_ENGINE_ID
  &q=mejores+prácticas+de+infraestructura+en+la+nube

JSON reducido:

{
  "queries": { "request": [ { "query": "mejores prácticas de infraestructura en la nube" } ] },
  "items": [
    { "title": "...", "link": "...", "snippet": "..." }
  ]
}