项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1604
使用教程
环境要求
- Docker(使用预构建镜像部署 API 服务)
- Go 环境(使用 go install 安装 CLI 或从源码构建)
- 可访问 Google/Bing/Yandex/百度/DuckDuckGo/Ecosia 的网络环境
- 无需任何搜索引擎 API Key
安装与启动步骤
-
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或用 Docker Compose
若已获取项目源码并带 compose 文件,可直接一条命令拉起服务,适合需要长期运行的场景。
docker compose up -
3安装 Go CLI
通过 go install 把 openserp 命令行工具装到 GOPATH/bin,之后可直接在终端搜索,无需自己启服务。
go install github.com/karust/openserp@latest -
4命令行搜索验证
用 CLI 在 DuckDuckGo 上搜索关键词并输出 markdown 结果,用来确认工具可正常抓取。
openserp search duckduckgo "open source serp api" --format markdown -
5从源码获取项目
克隆仓库并进入目录,便于后续自行构建或使用 compose 部署。
git clone https://github.com/karust/openserp.git cd openserp
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-p | 是 | API 服务监听端口,Docker 与本地启动均使用 7000 | 7000 |
-a | 是 | 服务绑定的监听地址,容器内需用 0.0.0.0 才能被外部访问 | 0.0.0.0 |
--format | 否 | CLI 搜索结果的输出格式,支持 JSON/Markdown/Text/NdJSON | markdown |
如何确认成功
容器启动后本地 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
上一篇:leviathan
同类项目推荐
trafilatura
开源
从网页中精准提取正文和元数据,一键输出多种格式。
Python & Command-line tool to gather text and metadata on the Web: Crawling, scrapin···
awesome-selfhosted-ai
开源
每周体检的自托管 AI 项目清单,直接照着搭
Curated list of self-hosted open-source AI: local LLMs, chat UIs, agents, MCP server···
crw
开源
6MB 内存的 Rust 爬虫,给 AI 智能体喂网页
Fast, lightweight Firecrawl/Tavily alternative in Rust. Web scraper, crawler & searc···
Advanced_RAG
开源
用实战 Notebook 掌握高级 RAG 检索与生成技巧
Advanced Retrieval-Augmented Generation (RAG) through practical notebooks, using th···
leettools-archive
开源
把大模型接进搜索流程,快速搭出带引用的智能问答原型
AI Search tools.
pg_vectorize
开源
在 Postgres 里直接搞定全文+语义搜索,不用额外部署向量库
Full-text and semantic search on any Postgres
contextgem
开源
用几行代码从文档中抽取结构化数据,告别繁琐提示词
Extract structured data and insights from documents using LLMs and decision models
colpali-cookbooks
开源
手把手教你微调 ColPali,让多模态文档检索更精准
Recipes for learning, fine-tuning, and adapting ColPali to your multimodal RAG use c···
awesome-claude
开源
一站收齐 Claude 生态工具与资源
A curated list of awesome things related to Anthropic Claude
