| name | searchcans-product-serp-brief |
| description | Create a localized product-search evidence brief from Google Shopping, Google web results, Google Images, and optional Reader extracts of explicit merchant URLs. Use for e-commerce category research, competitor assortment discovery, product-page planning, and market-specific merchandising briefs. |
| metadata | {"author":"SearchCans","version":"1.1.0","tags":["serp-api","google-shopping-api","google-images-api","ecommerce","product-research"]} |
SearchCans Product SERP Brief
Turn one product query into a current, market-specific observation pack. It gathers Shopping, web, and image results together so an agent can compare product listings, merchant names, search intent, and visual search presence without claiming a universal catalog or a live price database.
Define the product question
Confirm the query, target country and language, and the decision it supports. Use a specific product/category query rather than a vague “best” query when the output will inform assortment or page planning.
python scripts/product_serp_brief.py "portable espresso maker" \
--country us --language en --max-products 10 \
--read-url "https://merchant.example/product" \
--out product-brief.json
--read-url is deliberately explicit: do not automatically fetch Google Shopping product links or merchant pages. Add only URLs relevant to the investigation and within the requested source budget.
Use prices and assets responsibly
merchant_observations.observed_numeric_price_range describes parsable values displayed on one Google Shopping SERP in the selected market. It is time-stamped, not currency-normalized, and never a price, stock, shipping, review, or availability guarantee.
Image URLs and thumbnails are discovery references only. Their appearance does not grant permission to download, reuse, train on, or republish an asset.
Use the report template to separate:
- Market/query and collection limits.
- Observed product/merchant/price patterns.
- Search and visual page-type signals.
- Page-level claims backed by successful Reader extracts.
- Gaps and human validation needed before a commercial action.
Let the account set safe scope
The default --account-mode auto checks the Account API once, accounts for three SERP calls plus explicit Reader URLs, caps only the Reader portion if appropriate, and keeps concurrency within reported lanes. Use warn, enforce, or off when the task calls for a different budget policy. The JSON includes only sanitized account-guard fields.
Official website
SearchCans
Resources
scripts/product_serp_brief.py retrieves the localized product evidence pack.references/product-brief-report.md defines the analyst brief and caveats.
