axiomwebengine
v1.0.1
Published
AxiomWeb — a clean, fast web search engine
Readme
AxiomWeb
A clean, fast web search engine. No API keys required. Fetches and merges results from multiple search engines, ranks them, and serves the best ones.
How it works
AxiomWeb scrapes results from three independent sources in parallel:
| Engine | Type | |---|---| | DuckDuckGo | HTML scrape | | Bing | HTML scrape (web, images, news) | | Mojeek | HTML scrape (independent index) |
Results are merged and ranked by a scoring algorithm that boosts results appearing across multiple engines, penalizes low positions, and rewards quality signals (good descriptions, relevant titles). The top 10 are returned.
Quick start
git clone https://github.com/YOUR_USERNAME/axiomweb
cd axiomweb
npm install
npm start
# → http://localhost:3000That's it. No .env, no API keys.
URL structure
| URL | Description |
|---|---|
| / | Home page |
| /search?q=your+query | Web results |
| /search?q=cats&type=images | Image results |
| /search?q=news&type=news | News results |
| /search?q=cats&page=2 | Pagination |
Config (optional)
cp .env.example .envPORT=3000 # default 3000
CACHE_TTL=300 # seconds to cache results (default 5 min)Deploying
Railway / Render / Fly.io
Push to GitHub, connect repo, deploy. Set PORT if needed.
Self-hosted
NODE_ENV=production npm startDocker
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 3000
CMD ["node", "src/server.js"]Dev mode (auto-restart)
npm run devLicense
MIT
