Good Old Search

Construye consultas de búsqueda precisas con frases exactas, filtros de sitio, exclusiones, rangos de fechas, tipos de archivo y enlaces de un solo clic en motores de búsqueda y objetivos de búsqueda vertical.

Esto no es un motor de búsqueda, agregador de metabúsqueda, raspador o proxy de API. Es un constructor de consultas estáticas local que abre el motor de búsqueda que elijas.

La aplicación tiene cinco superficies:

• Simple: el constructor de búsqueda exacta cotidiana en index.html.
• Laboratorio de Búsqueda Avanzada: un constructor de operadores profesionales en advanced.html para dorks de Google, búsquedas por tipo de archivo, filtros de sitio/ruta, operadores de título/URL/cuerpo, rangos de fechas, preajustes y líneas de operadores sin procesar.
• Shodan: un constructor de consultas Shodan y asistente de búsqueda en shodan.html para términos de banner, ámbitos de organización/red, puertos, filtros de certificados TLS, metadatos HTTP, capturas de pantalla y revisión de exposición defensiva.
• crt.sh: un constructor de consultas crt.sh y asistente de búsqueda en crtsh.html para búsquedas de transparencia de certificados, dominios comodín, limpieza de certificados caducados, resultados desduplicados, exportaciones JSON y pivotes de ID de certificado.
• Wayback: un constructor de consultas Wayback y asistente de búsqueda en wayback.html para URLs de API CDX, tipos de coincidencia, rangos de fechas, códigos de estado, filtros MIME, capturas colapsadas e investigación de archivos.

Destinos Compatibles

Web:

• Google (con udm=14 para omitir la Visión General de IA)
• Google Verbatim
• Brave
• Kagi
• DuckDuckGo
• Bing
• Marginalia (web pequeña, índice no comercial)
• Mojeek (rastreador independiente)

Técnicos y foros:

• Hacker News
• GitHub Issues
• GitHub Code
• Stack Overflow
• Reddit vía Google

Investigación y archivos:

• arXiv
• Google Scholar
• Wayback Machine (capturas web de Internet Archive)

Recetas

• Exacto: citar toda la entrada.
• Google Antiguo: citar la entrada y priorizar búsquedas web más estrictas.
• Error Técnico: citar el error completo y recomendar GitHub Issues, Stack Overflow, HN y búsqueda de código.
• Foros: priorizar superficies de discusión humana.
• Web Antigua: agregar una fecha before:, con preajustes rápidos para 2022, 2020, 2016 y 2010.
• PDFs / Documentos: agregar filetype:pdf.
• Excluir Basura: aplicar una lista de bloqueo local editable para filtros -site: y términos basura recurrentes.

Desarrollo Local

npm install
npm run dev

El comando dev construye la aplicación estática una vez y sirve dist en http://127.0.0.1:4173. No hay HMR. Vuelve a ejecutar npm run dev (o npm run build && npm run preview) después de los cambios. La compilación compila la aplicación TypeScript, copia activos estáticos y genera archivos sitemap/robots.

Compilación

npm run build

La salida va a dist/. La aplicación también se puede abrir directamente desde dist/index.html.

Establece PUBLIC_SITE_URL en tiempo de compilación para URLs canónicas y entradas de sitemap correctas. El valor predeterminado es https://goodoldsearch.com.

PUBLIC_SITE_URL=https://goodoldsearch.com npm run build

Docker / Coolify

El Dockerfile incluido construye la aplicación y luego sirve dist con el servidor estático Node existente.

Configuración de Coolify:

• Paquete de compilación: Dockerfile.
• Puerto expuesto: 3000.
• Argumento de compilación o entorno durante la compilación: PUBLIC_SITE_URL=https://goodoldsearch.com.
• Entorno de ejecución: Coolify puede proporcionar PORT; de lo contrario, la imagen predeterminada es 3000.

Pruebas y Smoke

npm test
npm run smoke
npm run smoke:live
npm run smoke:live:strict

• npm test construye la aplicación, ejecuta el conjunto de aserciones de un solo proceso y ejecuta comprobaciones de humo de tipo consulta.
• npm run smoke verifica cada constructor de URL de motor compatible, host, sintaxis de consulta específica del motor, comportamiento clave de receta y viaje de ida y vuelta de URL compartida.
• npm run smoke:live también intenta el alcance en vivo para cada destino e informa advertencias externas sin fallar el humo estructural.
• npm run smoke:live:strict también falla en advertencias de alcance externo. Algunos motores pueden limitar la velocidad, redirigir o bloquear bots en solicitudes automatizadas incluso cuando los enlaces del navegador funcionan.

Estructura de Archivos

src/
  main.ts
  styles.css
  lib/
    queryModel.ts
    queryBuilder.ts
    recipes.ts
    shareUrl.ts
    blocklist.ts
    bookmarklet.ts
    engines/
      index.ts
      google.ts
      googleVerbatim.ts
      bing.ts
      brave.ts
      duckduckgo.ts
      kagi.ts
      hn.ts
      redditGoogle.ts
      stackoverflow.ts
      githubIssues.ts
      githubCode.ts
      arxiv.ts
      utils.ts
tests/
  query.test.mjs
scripts/
  build-seo-files.mjs
  clean-dist.mjs
  copy-static.mjs
  serve-dist.mjs
  smoke-engines.mjs

Licencia

MIT. Ver LICENSE.

Advertencias

• Google puede coincidir términos entre comillas en texto de página oculto, URLs o contenido indexado obsoleto.
• DuckDuckGo puede mostrar resultados relacionados si las coincidencias exactas son escasas.
• Bing puede ignorar la puntuación o limitar cuántos términos afectan los resultados.
• Kagi puede requerir inicio de sesión.
• Las búsquedas verticales ignoran los operadores solo web cuando su motor no los admite.