Free-Search: herramienta API de acceso gratuito a los resultados de búsqueda de Google en tiempo real

Introducción general

Free-Search es una herramienta API de código abierto desarrollada por Hanzla Javaid y alojada en GitHub. Su función principal es proporcionar resultados de búsqueda de Google en tiempo real a través de un motor de búsqueda personalizado y rastrear contenido web para devolver datos estructurados. Esta herramienta está diseñada para que los agentes de IA y las aplicaciones de modelado de grandes lenguajes (LLM) ayuden a mejorar la accesibilidad de los datos de Internet. Los usuarios pueden utilizarla gratuitamente con sólo descargar el código e instalarlo localmente. El proyecto está desarrollado en Python y admite parámetros de búsqueda personalizados, lo que lo hace adecuado para desarrolladores y equipos técnicos. Actualmente está disponible con ejemplos de demostración públicos para facilitar la experiencia.

Lista de funciones

• Admite la búsqueda en Google en tiempo real y devuelve los últimos resultados tras introducir las palabras clave.
• Rastrea automáticamente las páginas de resultados de búsqueda y extrae el contenido central de cada página.
• Devuelve datos estructurados, incluidas fuentes, enlaces y fragmentos de contenido.
• Número de resultados ajustable (1-5) y longitud de cada contenido (100-5000 caracteres).
• Código fuente abierto, libremente modificable y optimizado por el usuario.
• Se proporcionan ejemplos de demostración públicos que pueden probarse sin instalación.

Utilizar la ayuda

Free-Search es una herramienta API para desarrolladores y requiere una cierta base técnica para su instalación y uso. Aquí tienes una guía detallada que te ayudará a empezar.

Cómo instalar

Free-Search requiere que descargues el código fuente de GitHub y configures el entorno de ejecución. Estos son los pasos:

1. almacén de clones
   Abra su navegador y visite https://github.com/HanzlaJavaid/Free-SearchHaga clic en el botón verde Code seleccione Download ZIP Descarga el archivo zip. O introdúzcalo en la línea de comandos:

git clone https://github.com/HanzlaJavaid/Free-Search.git

Una vez finalizada la descarga, vaya a la carpeta del proyecto.

2. Instalación de dependencias
   El proyecto requiere Python 3.7 o posterior, y varias librerías clave. Ejecútalo desde la línea de comandos:

pip install fastapi uvicorn pydantic playwright beautifulsoup4

Esto instalará FastAPI (creación de la API), Uvicorn (ejecución del servidor), Pydantic (validación de datos), Playwright (rastreo web) y BeautifulSoup4 (análisis sintáctico de HTML).

3. Instalar Playwright Browser
   El proyecto se basa en el navegador Chromium de Playwright, que se instala ejecutando el siguiente comando:

playwright install chromium

Después de la instalación, la herramienta es capaz de rastrear la página web correctamente.

4. Inicio de los servicios
   Ejecútalo en la carpeta del proyecto:

xvfb-run python main.py

Si no dispone de una interfaz gráfica en su sistema Linux, la opciónxvfb-run los usuarios de Windows o Mac pueden simplemente ejecutar la aplicación python main.pyEl servicio API se ejecutará localmente tras el inicio. Una vez iniciado, el servicio API se ejecuta localmente en el puerto predeterminado 11235.

Cómo utilizar las principales funciones

El núcleo de Free-Search es la API de búsqueda, que se ejecuta para obtener resultados a través de peticiones HTTP. Así es como funciona:

• Acceso a los puntos finales de la API
  Una vez iniciado el servicio, abra un navegador o una herramienta de línea de comandos y acceda al archivo http://localhost:11235/search. Debe proporcionar parámetros de búsqueda, como palabras clave.
• Enviar solicitud de búsqueda
  utilizar curl u otras herramientas para enviar solicitudes. Ejemplo:

curl "http://localhost:11235/search?query=fastapi+tutorial&max_results=2&max_content=1000"

• queryPalabras clave de búsqueda, obligatorias, por ejemplo "tutorial fastapi".
• max_results: Número de resultados a devolver, opcional, por defecto 3, rango 1-5.
• max_contentLongitud del contenido de cada resultado, opcional, por defecto 2000 caracteres, rango 100-5000.
• Ver resultados de devoluciones
  La API devuelve datos estructurados en formato JSON, por ejemplo:

[
{
"source": "fastapi官方文档",
"link": "https://fastapi.tiangolo.com/tutorial/",
"context": "FastAPI 是一个现代、快速的 Web 框架..."
},
{
"source": "教程博客",
"link": "https://example.com/fastapi-guide",
"context": "本教程介绍如何使用 FastAPI 构建 API..."
}
]

Cada resultado incluye el nombre de la fuente, el enlace y el contenido extraído.

Función destacada Operación

• Búsqueda en Google en tiempo real
  Free-Search se conecta a Google a través de un motor de búsqueda personalizado para obtener los últimos resultados. No hay necesidad de desarrollar su propio rastreador, sólo tiene que introducir palabras clave y utilizarlo.
• Rastreo de contenidos y resultados estructurados
  La herramienta visita automáticamente cada página de resultados de búsqueda, extrae el contenido principal y lo organiza en un formato fácil de leer. Esto resulta especialmente útil para aplicaciones de inteligencia artificial, ya que puede introducirse directamente en los modelos para su procesamiento.
• Parámetros personalizados
  Puede ajustar el max_results responder cantando max_contentque controla la cantidad y el nivel de detalle de los datos devueltos. Por ejemplo, para obtener más resultados, puede utilizar:

curl "http://localhost:11235/search?query=python+学习&max_results=5"

• Uso de instancias públicas
  Si no desea instalarlo localmente, puede visitar directamente los ejemplos de demostración oficiales proporcionados:https://freesearch.replit.app/. Simplemente escriba en su navegador algo como https://freesearch.replit.app/search?query=测试 dirección, puede probarlo.

advertencia

• Cuando se ejecuta localmente, asegúrate de que Internet está abierto, ya que la herramienta requiere acceso a Google y a otras páginas web.
• Si encuentra errores de Playwright, compruebe que Chromium está instalado correctamente.
• El proyecto es de código abierto y se puede modificar main.py u otros documentos, añadir nuevas funciones como la compatibilidad con otros motores de búsqueda.

Con estos pasos, podrá implantar y utilizar fácilmente Free-Search para obtener datos de búsqueda en tiempo real.

escenario de aplicación

1. Desarrollo de agentes de IA
   Los desarrolladores pueden utilizar Free-Search para adquirir datos web en tiempo real con los que entrenar o mejorar la base de conocimientos del agente de IA.

Descripción de la escenaPor ejemplo, si estás desarrollando un chatbot que necesita responder a preguntas sobre las últimas noticias tecnológicas, Free-Search puede proporcionar el contenido web relevante para que el bot dé respuestas precisas.

2. Entrada de datos LLM
   Los grandes modelos lingüísticos requieren muchos datos externos, y Free-Search puede utilizarse como fuente de datos.

Descripción de la escenaSi está creando un modelo para analizar artículos, introduzca la palabra clave "aprendizaje automático" y Free-Search le devolverá enlaces y resúmenes de los artículos más recientes para que el modelo los procese.

3. Herramientas individuales de investigación
   Los estudiantes o investigadores pueden utilizarlo para recopilar rápidamente información de la web.

Descripción de la escena: Cuando escriba un artículo, teclee "repercusiones del cambio climático" para obtener datos en tiempo real de múltiples fuentes y ahorrar tiempo de búsqueda.

CONTROL DE CALIDAD

1. ¿Cuál es la diferencia entre Free-Search y Google Search?
   Free-Search es una herramienta API que rastrea automáticamente los resultados de búsqueda de Google y devuelve datos estructurados, mientras que la búsqueda de Google sólo proporciona una interfaz web.
2. ¿Cuál es la diferencia entre una instancia pública y una implantación local?
   Las instancias públicas pueden utilizarse sin instalación, pero pueden tener limitaciones de acceso; las implantaciones locales son totalmente controlables y también pueden personalizarse en cuanto a funcionalidad.
3. ¿Admite búsquedas en chino?
   Sí, basta con escribir palabras clave en chino y la API devolverá resultados relevantes, siempre que Google encuentre una coincidencia.