beaconed_products_list
Filter and search your Shopify product catalog by status, readiness score, grade, or pending optimizations to inspect product lists and identify items needing SEO improvements.
Instructions
GET /api/v1/products — list products with optional filters for status, score, grade, and search query
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "beaconed_products_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search by product title | |
| page | No | Page number (1-based) | |
| grade | No | Filter by readiness grade | |
| status | No | Filter by Shopify product status | |
| per_page | No | Items per page (max 100) | |
| max_score | No | Maximum readiness score (0-100) | |
| min_score | No | Minimum readiness score (0-100) | |
| needs_optimization | No | Only return products with pending optimizations |