Free-Search: ferramenta API para acesso gratuito aos resultados de pesquisa do Google em tempo real

Introdução geral

O Free-Search é uma ferramenta de API de código aberto desenvolvida por Hanzla Javaid e hospedada no GitHub. Sua principal função é fornecer resultados de pesquisa do Google em tempo real por meio de um mecanismo de pesquisa personalizado e rastrear o conteúdo da Web para retornar dados estruturados. Essa ferramenta foi projetada para agentes de IA e aplicativos de modelagem de linguagem ampla (LLM) para ajudar a melhorar a acessibilidade dos dados da Internet. Os usuários podem usá-la gratuitamente simplesmente baixando o código e implantando-o localmente. O projeto é desenvolvido em Python e suporta parâmetros de pesquisa personalizados, o que o torna adequado para desenvolvedores e equipes técnicas. Atualmente, ele está disponível com exemplos públicos de demonstração para facilitar a experiência.

Lista de funções

• Oferece suporte à pesquisa em tempo real no Google e retorna os resultados mais recentes após a inserção de palavras-chave.
• Rastreia automaticamente as páginas de resultados de pesquisa e extrai o conteúdo principal de cada página.
• Retorna dados estruturados, incluindo fontes, links e snippets de conteúdo.
• Número ajustável de resultados (1-5) e comprimento de cada conteúdo (100-5000 caracteres).
• Código-fonte aberto, livremente modificável e otimizado pelo usuário.
• Exemplos públicos de demonstração são fornecidos e podem ser testados sem instalação.

Usando a Ajuda

O Free-Search é uma ferramenta de API para desenvolvedores e requer uma certa base técnica para ser instalado e usado. Aqui está um guia detalhado para ajudá-lo a começar.

Como instalar

O Free-Search exige que você baixe o código-fonte do GitHub e configure o ambiente de tempo de execução. Aqui estão as etapas:

1. armazém de clones
   Abra seu navegador e acesse https://github.com/HanzlaJavaid/Free-SearchClique no ícone verde Code botão, selecione Download ZIP Faça o download do arquivo zip. Ou digite-o na linha de comando:

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

Quando o download estiver concluído, vá para a pasta do projeto.

2. Instalação de dependências
   O projeto requer o Python 3.7 ou posterior e várias bibliotecas importantes. Execute-o na linha de comando:

pip install fastapi uvicorn pydantic playwright beautifulsoup4

Isso instalará o FastAPI (criação da API), o Uvicorn (execução do servidor), o Pydantic (validação de dados), o Playwright (rastreamento da Web) e o BeautifulSoup4 (análise de HTML).

3. Instalar o navegador Playwright
   O projeto conta com o navegador Chromium do Playwright, que é instalado com a execução do seguinte comando:

playwright install chromium

Após a instalação, a ferramenta poderá rastrear a página da Web corretamente.

4. Início dos serviços
   Execute-o na pasta do projeto:

xvfb-run python main.py

Se você não tiver uma interface gráfica em seu sistema Linux, oxvfb-run é necessário; os usuários de Windows ou Mac podem simplesmente executar o python main.pyO serviço de API será executado localmente após a inicialização. Uma vez iniciado, o serviço de API é executado localmente na porta padrão 11235.

Como usar os principais recursos

O núcleo do Free-Search é a API de pesquisa, que é executada para obter resultados por meio de solicitações HTTP. Veja como ela funciona:

• Acesso a pontos de extremidade da API
  Depois que o serviço for iniciado, abra um navegador ou uma ferramenta de linha de comando e acesse o arquivo http://localhost:11235/search. Você precisa fornecer parâmetros de pesquisa, como palavras-chave.
• Enviar solicitação de pesquisa
  fazer uso de curl ou outras ferramentas para enviar solicitações. Exemplo:

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

• queryPalavras-chave de pesquisa, obrigatórias, por exemplo, "fastapi tutorial".
• max_resultsNúmero de resultados a serem retornados, opcional, padrão 3, intervalo de 1 a 5.
• max_contentComprimento do conteúdo de cada resultado: opcional, padrão 2000 caracteres, intervalo 100-5000.
• Exibir resultados de retorno
  A API retorna dados estruturados no formato JSON, por exemplo:

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

Cada resultado inclui o nome da fonte, o link e o conteúdo extraído.

Operação da função em destaque

• Pesquisa em tempo real no Google
  O Free-Search se conecta ao Google por meio de um mecanismo de pesquisa personalizado para obter os resultados mais recentes. Não há necessidade de desenvolver seu próprio rastreador, basta inserir palavras-chave e usá-lo.
• Rastreamento de conteúdo e saída estruturada
  A ferramenta visita automaticamente cada página de resultados de pesquisa, extrai o conteúdo principal e o organiza em um formato fácil de ler. Isso é particularmente útil para aplicativos de IA, onde pode ser fornecido diretamente aos modelos para processamento.
• Parâmetros personalizados
  Você pode ajustar o max_results responder cantando max_contentque controla a quantidade e o nível de detalhes dos dados retornados. Por exemplo, para obter mais resultados, você pode usar:

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

• Uso de instâncias públicas
  Se não quiser instalá-lo localmente, você pode visitar diretamente os exemplos de demonstração oficiais fornecidos:https://freesearch.replit.app/. Basta digitar em seu navegador algo como https://freesearch.replit.app/search?query=测试 endereço, você pode experimentá-lo.

advertência

• Ao executar localmente, certifique-se de que a Internet esteja aberta, pois a ferramenta requer acesso ao Google e a outras páginas da Web.
• Se você encontrar erros do Playwright, verifique se o Chromium está instalado corretamente.
• O projeto é de código aberto e você pode modificá-lo main.py ou outros arquivos, adicionar novos recursos, como suporte a outros mecanismos de pesquisa.

Com essas etapas, você pode implantar e usar facilmente o Free-Search para obter dados de pesquisa em tempo real.

cenário do aplicativo

1. Desenvolvimento de agentes de IA
   Os desenvolvedores podem usar o Free-Search para adquirir dados da Web em tempo real para treinar ou aprimorar a base de conhecimento do agente de IA.

Descrição da cenaPor exemplo, se você estiver desenvolvendo um chatbot que precise responder a perguntas sobre as últimas notícias de tecnologia, o Free-Search poderá fornecer o conteúdo relevante da Web para que o bot dê respostas precisas.

2. Entrada de dados LLM
   Modelos de linguagem grandes exigem muito suporte de dados externos, e o Free-Search pode ser usado como uma fonte de dados.

Descrição da cenaVocê está criando um modelo para analisar artigos, digite a palavra-chave "aprendizado de máquina" e o Free-Search retorna links e resumos dos artigos mais recentes para o modelo processar.

3. Ferramentas de pesquisa individuais
   Estudantes ou pesquisadores podem usá-lo para reunir rapidamente informações da Web.

Descrição da cenaQuando estiver escrevendo um artigo, digite "climate change impacts" para obter dados em tempo real de várias fontes e economizar tempo de pesquisa.

QA

1. Qual é a diferença entre o Free-Search e a Pesquisa Google?
   O Free-Search é uma ferramenta de API que rastreia automaticamente os resultados de pesquisa do Google e retorna dados estruturados, enquanto a pesquisa do Google fornece apenas uma interface da Web.
2. Qual é a diferença entre uma instância pública e uma implementação local?
   As instâncias públicas podem ser usadas sem instalação, mas podem ter limitações de acesso; as implementações locais são totalmente controláveis e também podem ser personalizadas quanto à funcionalidade.
3. Ele oferece suporte à pesquisa em chinês?
   Sim, basta digitar as palavras-chave em chinês e a API retornará resultados relevantes, desde que o Google encontre uma correspondência.