obscura-web-search

name	obscura-web-search
description	Search the web with Dockerized Obscura. Use to search, look up sources, find pages, or compare information from web results.

Obscura Web Search

Use Obscura through Docker as the browser layer for web search. Fetch a search-result page, parse results, browse selected pages, and answer only from sources you could retrieve.

Quick Start

1. Read Obscura Docker Runbook for the Docker search helper and launch patterns.
2. Read Search Workflow for query construction, parsing, retries, and output shape.
3. Read Result Browsing And Citations before making factual claims from search results.
4. Use scripts/obscura_search.py for repeatable searches and optional top-result browsing.

Workflow

1. Turn the user's request into a focused search query.
2. Run Dockerized Obscura against the search page with scripts/obscura_search.py.
3. Inspect parsed results; if parsing fails, retry once with a narrower query or alternate template.
4. Browse the top relevant result pages before answering.
5. Cite browsed URLs and state blocked pages, weak results, or parser failures.

Sample Applications

See Sample Applications for source-finding, CDP lookup, install-method comparison, and parser-failure examples.

Reference Map

• Obscura Docker Runbook: Docker commands and helper usage.
• Search Workflow: query, search, retry, and instrumentation workflow.
• Result Browsing And Citations: verifying result pages and citing sources.
• Sample Applications: realistic prompt-to-output examples.