Circuit-Forge/snipe
3
0
Fork 0
Code Issues 11 Pull requests 1 Projects Releases 2 Packages Wiki Activity Actions
snipe/docs/user-guide/searching.md
pyr0ball 2dda26a911
Some checks failed
CI / Frontend typecheck + tests (push) Waiting to run
Details
CI / Python tests (push) Waiting to run
Details
Mirror / mirror (push) Has been cancelled
Details
Release / release (push) Has been cancelled
Details
feat: infra/devops batch — CI/CD, installer, nginx docs, cf-orch agent (v0.3.0) 
Closes #15, #22, #24, #25. Closes #1 and #27 (already shipped in 0.2.0).

## CI/CD (#22)
- .forgejo/workflows/ci.yml — Python lint (ruff) + pytest + Vue typecheck + vitest
  on every PR/push. Installs cf-core from GitHub mirror for the CI runner.
- .forgejo/workflows/release.yml — Docker build/push (api + web) to Forgejo registry
  on v* tags; git-cliff changelog; multi-arch amd64+arm64.
- .forgejo/workflows/mirror.yml — push to GitHub + Codeberg mirrors.

## Self-hosted installer (#25)
- install.sh rewritten to match CF installer pattern: coloured output, named
  functions, --docker / --bare-metal / --help flags, auto-detect Docker/conda/
  Python/Node/Chromium/Xvfb, license key prompting with format validation.

## Nginx docs (#24)
- docs/nginx-self-hosted.conf — sample nginx config: SPA fallback, SSE proxy
  (proxy_buffering off), long-term asset cache headers.
- docs/getting-started/installation.md — bare-metal install section with nginx
  setup, Chromium/Xvfb note, serve-ui.sh vs nginx trade-off.

## cf-orch agent (#15)
- compose.override.yml — cf-orch-agent sidecar service (profiles: [orch]).
  Starts only with docker compose --profile orch. Registers with coordinator at
  CF_ORCH_COORDINATOR_URL (default 10.1.10.71:7700).
- .env.example — CF_ORCH_URL / CF_ORCH_COORDINATOR_URL comments expanded.

## Docs
- mkdocs.yml + full docs/ tree (getting-started, reference, user-guide) staged
  from prior session work.

Bump version 0.2.0 → 0.3.0.
2026-04-14 06:19:25 -07:00

1.8 KiB
Raw Blame History

Searching

Basic search

Type a query and press Search. Snipe fetches listings from eBay and scores each seller in parallel.

Result count depends on the Pages to fetch setting (1 page = up to 200 listings). More pages means a more complete picture but a longer wait.

Keyword modes

The must-include field has three modes:

Mode Behavior
All Every term must appear in results (eBay AND search)
Any At least one term must appear (eBay OR search)
Groups Comma-separated groups, each searched separately and merged

Groups mode is the most powerful. Use it to search for variations that eBay's relevance ranking might drop:

16gb, 32gb
RTX 4090, 4090 founders

This sends two separate eBay queries and deduplicates the results by listing ID.

Must-exclude

Terms in the must-exclude field are forwarded to eBay on re-search. Common uses:

broken, parts only, for parts, untested, cracked

!!! note Must-exclude applies on re-search (it goes to eBay). The Hide listings: Scratch/dent mentioned sidebar filter applies instantly to current results using Snipe's own detection logic, which is more comprehensive than eBay's keyword exclusion.

Filters sidebar

The sidebar has two sections:

eBay Search — settings forwarded to eBay on re-search:

  • Category filter
  • Price range (min/max)
  • Pages to fetch
  • Data source (Auto / API / Scraper)

Filter Results — applied instantly to current results:

  • Min trust score slider
  • Min account age / Min feedback count
  • Hide listings checkboxes

Saved searches

Click the bookmark icon next to the Search button to save a search with its current filter settings. Saved searches appear in the Saved view and can be re-run with one click, restoring all filters.