Claude
Skills
Sign in
Back

product-discovery

Included with Lifetime
$97 forever

# Product Discovery

General

What this skill does

# Product Discovery

Search and discover products across the entire e-commerce market or within a specific company.

## When to use

When the user wants to find specific products, explore what's selling, discover new launches, or browse a catalog.

## Workflow

### Category discovery
Use `get_product_types` (FREE) to find valid category filter values before searching.
- Call with no args for root categories
- Pass `parent_product_type_id` to drill into subcategories
- Use the resulting `product_type_id` as the `product_type` filter

### Market-wide search
Use `search_market_products` to search across ALL tracked companies. Costs 1 credit per product.
- `title_search`: search by product name (e.g., 'tank top', 'winter jacket') — matches product titles
- `keyword`: search by product tags (e.g., 'recycled', 'wireless') — searches tags, NOT titles
- `product_type`: filter by category (use `get_product_types` to find IDs)
- `brand`: filter by brand name
- `min_price` / `max_price`: price range filters
- `sort_by`: `sales_revenue` (default), `sales_volume`, `price`, or `launch_date`
- `sort_direction`: `desc` (default) or `asc`
- `start_date` / `end_date`: control the sales data window

### Company-specific search
Use `get_company_products` with a `company_id` for the same capabilities scoped to one company.
- Find the `company_id` first with `search_companies` (FREE)
- Same filters and sorting as market-wide search

### Pagination
Both tools support pagination:
- `page_size`: 1-100 (default 25)
- `page`: 0-indexed page number
- Response includes `has_more` and `total_count` for navigation

## Tips

- Use `title_search` to find products by name, `keyword` for tag-based filtering
- Use `sort_by: "launch_date"` with `sort_direction: "desc"` for newest products
- Use `sort_by: "sales_revenue"` for bestsellers
- Combine `keyword` with `product_type` for precise filtering
- Check `has_more` in the response to know if there are additional pages

Related in General