Menu
Types a query into a site's search input, submits, and optionally applies one or more filter facets (categories, price ranges, attributes). Common on e-commerce, doc-search, and listing sites.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Signs into a site using credentials provided via `vars` (typically sourced from environment variables) or via a pre-saved Playwright persistent context. Never harvests or stores credentials. See docs/ethics.md.
Detects whether the current page contains a captcha challenge (reCAPTCHA, hCaptcha, Cloudflare Turnstile, GeeTest, etc.). Reports detection and stops. Never attempts to solve. See docs/ethics.md.
Extract structured data from an HTML table, optionally walking through paginated views. Returns a list of row dicts keyed by header cells. The demo skill (used to monitor conference paper lists).
Confirms that the current page has finished loading and is ready for interaction. Detects loading spinners, skeleton screens, and content placeholders. Run before extraction skills.
Fills a multi-step form (stepper wizard) by routing labeled fields to values from `vars`, clicking "Next" between steps, and submitting at the end. Pairs with the `searchable-dropdown` and `date-picker-widget` skills for compound widgets.
Uploads a local file to an HTML5 file input, or triggers a download and captures the resulting path. Composes with multi-step-form for file-attaching workflows.
| name | search-and-filter |
| description | Types a query into a site's search input, submits, and optionally applies one or more filter facets (categories, price ranges, attributes). Common on e-commerce, doc-search, and listing sites. |
| version | 0.1.0 |
| allowed-tools | ["wait_for_dom_ready","fill","click","press_key","try_each","wait"] |
| metadata | {"applies_to":"any-website","url_patterns":["*"],"dom_markers":["input[type='search']","[role='search']","[aria-label*='search' i]"],"flake_rate_target":0.1,"exercised_on":["ebay-search","rei-search","github-search","pypi-search","openalex-search"],"cost_budget":{"deterministic_only":false,"max_vision_calls":2}} |
User wants to search a site for vars.query and optionally apply
filters from vars.filters (a dict of facet-name → value).
The matcher fires this skill on any page with a visible search input.
The recipe above is the search part only. Applying filters is a
composition with click for facet checkboxes — the agent receives the
list of available filters from extract_text and decides which to
toggle.
click against a search button — most sites surface one.<form> elements that submit on a different
path: the recipe's Enter press may navigate to a stale URL.
Document per-site if discovered.press_key key=Escape first if
it's blocking.