openserp

自建搜索 API,六大引擎结果一键拿

openserp 是一个用 Go 编写的自托管 SERP(搜索引擎结果页)API,目标是替代 SerpApi 等付费服务。它通过真实浏览器渲染抓取 Google、Bing、Yandex、百度、DuckDuckGo、Ecosia 六大搜索引擎的结果,并支持对结果页面做正文提取,输出结构化 JSON。项目面向 AI 应用、SEO 监控和自动化流程:LLM 需要实时联网检索时可直接调用它获取干净结果,SEO 团队可批量跟踪关键词排名,自动化脚本可把搜索能力封装进自己的服务。它提供 HTTP API 和 CLI 两种使用方式,可 Docker 部署,数据完全留在自己服务器上,避免第三方 API 的额度、费用和隐私问题。Go 语言带来单二进制、低依赖、易部署的特点,适合中小团队自建搜索数据管道。

开源 freemium 搜索知识
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1451
维护状态 较活跃
是否开源 是
定价模式 freemium

项目预览

项目数据

分类搜索知识
开发团队karust
所属国家
定价模式freemium
价格说明开源可自托管免费,官网提供云服务付费方案,定价信息待确认
访问状态
是否开源是
开源协议MIT
主要语言Go
技术栈/模型ai,api,baidu,bing,cli,duckduckgo,ecosia,google,llm,openserp,opensource,search,search-engine,seo,serp,serpapi,web-scraping,yandex
GitHub 星标★ 1451
30天Star增速
HF 下载量
上线时间2023-06-23 00:00:00
代码更新—
仓库体积—
本站数据更新—
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-10-08
浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度:入门 约 10 分钟 部署方式:Docker 5 步

环境要求

  • Docker(使用预构建镜像部署 API 服务)
  • Go 环境(使用 go install 安装 CLI 或从源码构建)
  • 可访问 Google/Bing/Yandex/百度/DuckDuckGo/Ecosia 的网络环境
  • 无需任何搜索引擎 API Key

安装与启动步骤

  1. 1启动 Docker API 服务

    用官方预构建镜像在本地 7000 端口启动服务,容器退出后自动删除。注意 -a 指定监听地址,-p 指定端口。

    docker run --rm -p 127.0.0.1:7000:7000 karust/openserp:latest serve -a 0.0.0.0 -p 7000
  2. 2或用 Docker Compose

    若已获取项目源码并带 compose 文件,可直接一条命令拉起服务,适合需要长期运行的场景。

    docker compose up
  3. 3安装 Go CLI

    通过 go install 把 openserp 命令行工具装到 GOPATH/bin,之后可直接在终端搜索,无需自己启服务。

    go install github.com/karust/openserp@latest
  4. 4命令行搜索验证

    用 CLI 在 DuckDuckGo 上搜索关键词并输出 markdown 结果,用来确认工具可正常抓取。

    openserp search duckduckgo "open source serp api" --format markdown
  5. 5从源码获取项目

    克隆仓库并进入目录,便于后续自行构建或使用 compose 部署。

    git clone https://github.com/karust/openserp.git
    cd openserp

关键配置

配置项必填说明示例
-p是API 服务监听端口,Docker 与本地启动均使用 70007000
-a是服务绑定的监听地址,容器内需用 0.0.0.0 才能被外部访问0.0.0.0
--format否CLI 搜索结果的输出格式,支持 JSON/Markdown/Text/NdJSONmarkdown

如何确认成功

容器启动后本地 7000 端口有服务响应,即表示 API 已正常运行;CLI 执行搜索能返回结构化结果即安装成功。

常见问题

Q:需要申请 API Key 或按次付费吗?

A:不需要。OpenSERP 完全免费开源,不依赖任何 API Key,也没有按搜索次数计费。

Q:支持哪些搜索引擎?

A:支持 Google、Yandex、百度、Bing、DuckDuckGo、Ecosia 六个引擎,且各引擎返回同一套 JSON 结构。

Q:不想自己维护服务器怎么办?

A:官方提供托管版本(hosted version),API 与自托管一致,可到 openserp.org 查看。

Q:能一次查询多个引擎吗?

A:可以,Megasearch 功能支持一次查询跨多个引擎,并自动合并与去重结果。

注意事项

  • README 中源码构建命令(go b...)被截断,请以仓库最新说明为准,不要照抄不完整命令。
  • Docker 端口映射到 127.0.0.1 表示仅本机可访问,需要外部调用时应调整映射与监听配置。
  • 项目还支持代理、缓存、resilient 模式以及 URL 正文提取,可输出 JSON/Markdown/Text/NdJSON。
  • 搜索结果为浏览器实时渲染抓取,频繁请求时请注意目标站点的访问频率限制。

核心亮点

  • 支持 Google、Bing、Yandex、百度、DuckDuckGo、Ecosia 六大引擎,覆盖面广
  • 浏览器真实渲染抓取,能拿到 JS 动态加载的结果,比纯 HTTP 请求更接近真实页面
  • Go 单二进制 + Docker 部署,自托管无外部 API 费用,数据不出自己服务器

不足之处

  • 依赖浏览器渲染,资源占用和抓取速度不如纯 HTTP 方案,大规模并发需要额外调优
  • 搜索引擎反爬策略变化频繁,长期维护和选择器更新压力较大

适用场景

  • 给 LLM/Agent 提供实时联网搜索能力,替代付费搜索 API
  • SEO 团队批量抓取关键词排名和竞品 SERP 数据
  • 自动化脚本或内部工具中集成多引擎搜索与网页正文提取

替代项目

SerpApi、searxng、SearXNG

项目介绍

openserp 是搜索知识领域的开源项目,由 karust 开发,2023 年首次发布。

在全站 13,916 个收录项目中,它的 GitHub 星标数(1,451)位列前 30%,在搜索知识分类中处于中上游。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-28。开源可自托管免费,官网提供云服务付费方案。

它主要面向的使用场景是:给LLM/Agent提供实时联网搜索能力,替代付费搜索API。同类可对比的替代方案包括 SerpApi、searxng、SearXNG。

上一篇:leviathan

下一篇:没有了!

同类项目推荐

firecrawl 开源

网页抓取像喝水一样简单,开发者省下整周加班

Supercharge your AI agents with data from the web and beyond. Building the library f···

★ 189435 2026-08-09
contoso-chat 开源

一键跑通 Azure RAG 应用,从代码到评估部署全流程

This sample has the full End2End process of creating RAG application with Prompty an···

★ 766 2026-08-09
graphify 开源

整个代码库画成一张图,找问题一眼定位

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···

★ 124613 2026-08-09
WeKnora 开源

文档往里一扔,自动变成啥都能答的知识库

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an auto···

★ 32415 2026-08-09