From 5ab3eb2e97b2b044a0ec221fe63ae5411c422824 Mon Sep 17 00:00:00 2001 From: ptarrant Date: Sun, 28 Jun 2026 21:01:02 -0500 Subject: [PATCH] docs: web.py live smoke-test procedure Co-Authored-By: Claude Sonnet 4.6 Claude-Session: https://claude.ai/code/session_01C7rEog2rS7uKNMb1CvpVjr --- docs/web-research-smoke-test.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 docs/web-research-smoke-test.md diff --git a/docs/web-research-smoke-test.md b/docs/web-research-smoke-test.md new file mode 100644 index 0000000..9dad820 --- /dev/null +++ b/docs/web-research-smoke-test.md @@ -0,0 +1,27 @@ +# web.py smoke test (webtools box) + +Manual checks against SearXNG (:8080) and Firecrawl (:3002) on +`10.10.20.37`. Not run in CI — exercises live services. + +## Search +``` +./.venv/bin/python web.py search "angelic hierarchy pseudo-dionysius" --max 3 --json +``` +Expect a JSON array of hits with non-empty `url`s. + +**SearXNG JSON note:** if you get an empty list or a `format` error, JSON +output is disabled. Enable in the box's `searxng/settings.yml` +(`search: formats: [html, json]`) and restart. + +## Scrape +``` +./.venv/bin/python web.py scrape https://en.wikipedia.org/wiki/Christian_angelic_hierarchy --out /tmp/smoke.md +``` +Expect `wrote /tmp/smoke.md` and real markdown in the file. + +## Env overrides +Point at a different box without code changes: +``` +WEBTOOLS_HOST=192.168.1.50 SEARXNG_PORT=8080 FIRECRAWL_PORT=3002 \ + ./.venv/bin/python web.py search "test" --json +```