Automatización de la indexación de búsqueda de Google - Web Search Indexing API

힘센캥거루
2025년 12월 13일(수정됨)
2
nextjs

Después de IndexNow, decidí probar también la automatización con Google.

Buscando un poco, vi que Google ofrecía algo llamado Web Search Indexing a través de una API.

Automatización de la indexación de búsqueda de Google - Web Search Indexing API-1

1. Alcance permitido

Automatización de la indexación de búsqueda de Google - Web Search Indexing API-2

Oficialmente, el ámbito que admite esta API son las ofertas de empleo y los servicios de vídeo en streaming.

Dicen que es para generar índices de contenido en el que la información en tiempo real es importante, pero por lo que he visto, parece que todo el mundo está enviando también blogs normales.

2. Configurar la API en Cloud Console y Search Console

Los hermanos mayores de Google han dejado preparada amablemente una librería de API para indexación.

No pienses en crearla tú mismo, simplemente úsala tal cual.

Para utilizar esta librería y generar la indexación del sitio, primero hay que realizar la autenticación.

Entra en la siguiente dirección y crea una cuenta de servicio.

Automatización de la indexación de búsqueda de Google - Web Search Indexing API-4

Luego copia la dirección de email de esa cuenta y añádela en Search Console en Configuración -> Usuarios y permisos.

Automatización de la indexación de búsqueda de Google - Web Search Indexing API-5

En la imagen de abajo aparece con permiso total, pero es imprescindible registrarla como propietario.

Automatización de la indexación de búsqueda de Google - Web Search Indexing API-6

Después vuelve al servicio y emite una clave json; con eso, la preparación básica queda lista.

Automatización de la indexación de búsqueda de Google - Web Search Indexing API-7Automatización de la indexación de búsqueda de Google - Web Search Indexing API-8

3. Enviar la solicitud desde el servidor

Lo monté utilizando el código que aparece al final del apartado Requisitos previos de la documentación oficial.

Como era de esperar, se nota la mano del gran hermano GPT.

import key from "@/utils/seo/다운받은json.json";
import { google } from "googleapis";

type IndexingType = "URL_UPDATED" | "URL_DELETED";

export async function publishIndexing(url: string, type: IndexingType = "URL_UPDATED") {
  const jwtClient = new google.auth.JWT({
    email: key.client_email,
    key: key.private_key,
    scopes: ["https://www.googleapis.com/auth/indexing"],
  });

  await jwtClient.authorize();

  const indexing = google.indexing({ version: "v3", auth: jwtClient });

  const res = await indexing.urlNotifications.publish({
    requestBody: { url, type },
  });

  return res.data;
}

Ahora apliqué esto, junto con IndexNow, a cada endpoint de la API.

Así, con solo escribir una entrada, el registro se realiza automáticamente.

Al ver la consola de depuración, se ve que funciona bien.

Automatización de la indexación de búsqueda de Google - Web Search Indexing API-9

4. Reseña

Al intentar gestionar un blog personal hecho a medida, hay muchas cosas de las que estar pendiente.

Problemas de seguridad y hacking, crear nuevas funciones, etc...

Si lo piensas, quizá sea más cómodo simplemente instalar WordPress y comprar módulos, pero también tiene su gracia ir construyendo todo poco a poco.

Quiero seguir creando muchas más funciones en el futuro.

댓글을 불러오는 중...