webshop-query-parser

This skill extracts key constraints and product requirements from a user's shopping query. It should be triggered when the agent receives a new shopping instruction, to identify product attributes (e.g., 'gluten free'), price limits (e.g., 'lower than 140.00 dollars'), and other specifications. The skill outputs a structured set of search criteria to guide subsequent product discovery.

promptBeginner5 min to valuemarkdown

0 views

Feb 12, 2026

name: webshop-query-parser description: This skill extracts key constraints and product requirements from a user's shopping query. It should be triggered when the agent receives a new shopping instruction, to identify product attributes (e.g., 'gluten free'), price limits (e.g., 'lower than 140.00 dollars'), and other specifications. The skill outputs a structured set of search criteria to guide subsequent product discovery.

Instructions

When to Use

Activate this skill immediately when a new shopping instruction is received from the user, before any search or click actions are performed.

Core Task

Parse the user's natural language instruction to extract structured search criteria. Your goal is to identify:

Product Type/Name: The primary item the user wants (e.g., "popcorn").
Key Attributes: Descriptive features like "gluten free", "organic", "vegan", etc.
Price Constraints: Any upper or lower price limits (e.g., "lower than 140.00 dollars").
Other Specifications: Brand, size, quantity, or other qualifying terms.

Procedure

Run the Parser: Execute the bundled script
```
parse_query.py
```
on the user's instruction.
Review & Refine: Examine the script's output. If the instruction is complex or ambiguous, use your judgment to refine the criteria. For example, ensure price limits are correctly interpreted as numeric ranges.
Formulate Search Strategy: Use the extracted criteria to plan the initial web search. Combine the Product Type with the most critical Key Attributes to form effective initial search keywords.
- Example: For "i need gluten free popcorn, and price lower than 140.00 dollars", the script will output
```
{'product': 'popcorn', 'attributes': ['gluten free'], 'price_max': 140.0}
```
  . Your initial search should be
```
search[gluten free popcorn]
```
  .

Output

After parsing, hold the structured criteria in memory. Use it to:

Guide the formulation of
```
search[keywords]
```
actions.
Evaluate product listings and details during
```
click
```
actions to check for constraint compliance (especially price).
Inform your reasoning in the
```
Thought:
```
part of your response.

Notes

Keep the initial search query concise but precise. Prioritize must-have attributes from the user's instruction.
The price filter is often not available as a direct web action; you must manually check prices in the search results and product details.
If the initial search yields no results, consider broadening the search by removing less critical attributes one at a time, but always respect hard constraints like "gluten free" if specified.

Core Task

Parse the user's natural language instruction to extract structured search criteria. Your goal is to identify:

Product Type/Name: The primary item the user wants (e.g., "popcorn").

Key Attributes: Descriptive features like "gluten free", "organic", "vegan", etc.

Price Constraints: Any upper or lower price limits (e.g., "lower than 140.00 dollars").

Other Specifications: Brand, size, quantity, or other qualifying terms.

Procedure

Run the Parser: Execute the bundled script

parse_query.py

on the user's instruction.

Review & Refine: Examine the script's output. If the instruction is complex or ambiguous, use your judgment to refine the criteria. For example, ensure price limits are correctly interpreted as numeric ranges.

Formulate Search Strategy: Use the extracted criteria to plan the initial web search. Combine the Product Type with the most critical Key Attributes to form effective initial search keywords.

Example: For "i need gluten free popcorn, and price lower than 140.00 dollars", the script will output
```
{'product': 'popcorn', 'attributes': ['gluten free'], 'price_max': 140.0}
```
. Your initial search should be
```
search[gluten free popcorn]
```
.

Notes

Keep the initial search query concise but precise. Prioritize must-have attributes from the user's instruction.

The price filter is often not available as a direct web action; you must manually check prices in the search results and product details.

If the initial search yields no results, consider broadening the search by removing less critical attributes one at a time, but always respect hard constraints like "gluten free" if specified.

webshop-query-parser

Instructions

When to Use

Core Task

Procedure

Output

Notes

Related Skills

System Prompt

Enterprise Sponsorship

Advertiser

Instructions

When to Use

Core Task

Procedure

Output

Notes