CarlBrownson/open-serp

OpenSERP on Hugging Face Spaces

This folder is ready to upload to Hugging Face as a Docker Space.

It builds karust/openserp from source and exposes the OpenSERP API on port 7860.

What you get

• —SERP API for Google, Yandex, Baidu, Bing, DuckDuckGo, and Ecosia
• —/mega/search for multi-engine search
• —/docs and /openapi.yaml for interactive API docs
• —JSON, Markdown, Text, and NdJSON response formats

How to use after deploying

Example request:

curl "https://<your-space>.hf.space/mega/search?engines=bing&text=golang+vs+rust&extract=0&mode=any"

Start with engines=bing for the most reliable results on Hugging Face Spaces. Add duckduckgo or google only when you need broader coverage. Keep extract=0 for fast SERP checks, and use extract=1 only when you want OpenSERP to fetch result pages too.

Useful endpoints:

• —GET /docs
• —GET /openapi.yaml
• —GET /mega/search
• —GET /google/search
• —GET /bing/image

Notes

• —The container listens on 0.0.0.0:7860, which is the standard Hugging Face Spaces port.
• —If you want, we can also add a tiny client page or a FastAPI proxy wrapper on top of this API.