Free-Search API 利用搜索引擎和爬虫技术为AI应用提供实时的Google搜索结果

Free-Search API 是为人工智能代理和大型语言模型（LLM）提供实时 Google 搜索结果的工具，通过自定义搜索引擎执行搜索查询，检索指定数量的最佳结果，抓取每个结果页面以提取内容，返回包含来源、链接和上下文信息的结构化数据。

要使用Free-Search，你需要安装 Python 3.7+、Playwright、Beautiful Soup 4、FastAPI 和 Uvicorn。安装完成后，可以通过 GET /search 端点进行查询，可以设置返回结果的数量（max_results）和每个结果的最大内容长度（max_content）。

Free-Search提供了一个公开可访问的演示实例，方便用户体验该API的功能。

Free Search API 提供了一个搜索端点，具备以下功能：

• 使用自定义搜索引擎执行搜索查询。

• 获取指定数量的顶级搜索结果。

• 爬取每个结果页面以提取内容。

• 返回结构化数据，包括每个结果的来源、链接和上下文。

安装

前提条件

• Python 3.7 或更高版本

• Playwright

• Beautiful Soup 4

• FastAPI

• Uvicorn

安装依赖

1、克隆此仓库。 2、安装依赖项：pip install fastapi uvicorn pydantic playwright beautifulsoup4。 3、安装 Playwright 浏览器：playwright install chromium。

使用

• 运行 xvfb-run python main.py 启动服务。

API 端点

GET /search

搜索查询并返回结果及其额外上下文。

参数

• query（字符串）：必需。搜索查询字符串。

• max_results（整数）：可选，默认值为3。返回的结果数量（范围：1-5）。

• max_content（整数）：可选，默认值未指定。每个结果的最大内容长度（字符数），范围为100-5000。

响应示例

[
  {
    "source": "source_name",
    "link": "https://example.com/page",
    "context": "Extracted content from the page..."
  }
]

示例请求

使用 curl 发送请求：

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

公共实例

Free Search API 的公共实例已经部署，这个实例可以让用户在不安装任何软件的情况下，直接使用 API 来获取搜索结果。