Generates Schema.org Product and FAQPage JSON-LD rich snippets for search engine optimization
Single tool with critical definition gaps. Tool name 'generate_rich_snippets' lacks action verb prefix (should be 'generate_json_ld_rich_snippets' or similar). Description is present (67 chars) but minimal and lacks WHEN/WHY context. Input schema visible with 5 parameters, all typed and with defaults, but parameter descriptions are extremely sparse (e.g., 'The name of the product' for product_title). No output schema documented, response structure is inferred from code only. No error handling guidance. Tool is read-only but lacks explicit idempotentHint annotation. Overall: bare-minimum definition quality unsuitable for production agent use.
Generates Schema.org Product and FAQPage JSON-LD rich snippets.
Tool name lacks action verb prefix. 'generate_rich_snippets' is weak; should be 'generate_json_ld_rich_snippets' or 'create_schema_org_snippets' to clarify intent and distinguish from similar tools.
Tool description is 67 characters, below the 194-char baseline for production tools. Lacks WHEN to use, prerequisites, and what the output enables. Should explain: 'Generates Schema.org-compliant JSON-LD microdata for Product and FAQPage rich snippets. Use this to create search-engine-optimized structured data for e-commerce products. Returns both Product schema (with rating, price, brand) and FAQPage schema (with Q&A pairs). Output is valid for Google Rich Results.'
Parameter descriptions are trivial (e.g., 'The name of the product', 'The brand name'). No format guidance, constraints, or examples. Should specify: product_title (string, 1-200 chars, e.g., 'Roborock Q Revo Robot Vacuum'), brand (string, 1-100 chars), price_usd (number, 0.01 - 999999.99), rating (number, 0 - 5, e.g., 4.7), review_count (integer, 0 - 1000000).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
No output schema documented. Response structure (snippet_id, product_name, schema_product_jsonld, schema_faq_jsonld, validation_status, search_rich_result_eligible) is visible only in code. LLMs cannot plan downstream use without explicit schema. Must document: returns object with fields: snippet_id (string), product_name (string), schema_product_jsonld (string, JSON), schema_faq_jsonld (string, JSON), validation_status (enum: VALID_SCHEMA_ORG_COMPLIANT), search_rich_result_eligible (boolean).
No error handling guidance. Tool lacks try-catch, validation, or recovery hints. If price_usd is negative or review_count exceeds schema limits, no error message guides the LLM to retry with valid values. Should validate inputs and return: 'Invalid price_usd: must be 0.01 - 999999.99. Got: -50.' Also missing idempotentHint annotation (tool is read-only and safe to retry).