# SourceSearch

**Repository Path**: mykin2026/source-search

## Basic Information

- **Project Name**: SourceSearch
- **Description**: 结合searxng进行搜索，整合newspaper4k进行网页提取。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-19
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Source Search

Source Search is a small stack built around SearXNG search, article extraction, and an MCP server.

Components:

- `search_searxng`: local SearXNG backend
- `extractor_newspaper4k`: unified web/API app for search proxy and detail extraction
- `source_search_mcp`: MCP server for search, detail, browser config, and runtime config

Main URLs after integrated startup:

- SearXNG: `http://127.0.0.1:8899/search?q=test&format=json`
- Unified web: `http://127.0.0.1:18081/`
- Unified API: `http://127.0.0.1:18081/api`
- MCP streamable HTTP: `http://127.0.0.1:18084/mcp`

Docs:

- [Development and Deployment](docs/development-and-deployment.md)
- [API and MCP Usage](docs/api-and-mcp.md)

Run scripts:

- Linux start: `./scripts/start_linux.sh`
- Linux stop: `./scripts/stop_linux.sh`
- Linux systemd generator: `./scripts/render_linux_systemd.sh`
- Windows start: `powershell -ExecutionPolicy Bypass -File .\scripts\start_windows.ps1`
- Windows stop: `powershell -ExecutionPolicy Bypass -File .\scripts\stop_windows.ps1`

Quick start on Linux:

```bash
uv python install 3.13
python3.13 -m venv .venv
./.venv/bin/pip install -r requirements.txt
./scripts/start_linux.sh
```

Important engine rule:

- Request-side `engines` only selects from engines that the local SearXNG instance actually exposes.
- `SEARXNG_ENGINES` controls the backend engine scope.
- `SEARCH_DEFAULT_ENGINES` is only the fallback used by API/MCP when callers omit `engines`.
- To see what the running SearXNG instance has enabled, query `http://127.0.0.1:8899/config`.
- For persistent local config, edit `versions.env`. For persistent systemd config, edit `/etc/default/source-search`.

OpenClaw integration lives under `integrations/openclaw/`.