Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"max_credits",
"input"
],
"properties": {
"input": {
"type": "object",
"properties": {
"niche": {
"type": "object",
"required": [
"description"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"jobs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"market": {
"type": "string",
"maxLength": 100
},
"topics": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"industry": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"language": {
"type": "string",
"maxLength": 20
},
"problems": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"audiences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"default": [],
"maxItems": 11
},
"exclusions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"communities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 10
},
"competitors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"competitor_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"competitor_handles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 40
},
"customer_interests": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"product_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"adjacent_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
},
"scope": {
"type": "array",
"items": {
"enum": [
"global",
"core",
"adjacent"
],
"type": "string"
},
"default": [
"global",
"core",
"adjacent"
],
"maxItems": 3,
"minItems": 1
},
"filters": {
"type": "object",
"default": {
"limit": 20,
"lookback_hours": 72
},
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"region": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"signals": {
"type": "array",
"items": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1
},
"language": {
"type": "string",
"pattern": "^[a-z]{2}(?:-[A-Z]{2})?$"
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1
},
"categories": {
"type": "array",
"items": {
"enum": [
"COFFEE_BREWING",
"CONTENT_CREATION",
"CUSTOMER_DISCOVERY",
"SOFTWARE_DEVELOPMENT",
"PRODUCTIVITY",
"FITNESS",
"GARDENING",
"COOKING",
"SKINCARE",
"TRAVEL",
"AI",
"ECOMMERCE",
"FINANCE",
"EDUCATION",
"ENTERTAINMENT",
"SUSTAINABILITY",
"MARKETING",
"SALES",
"HEALTHCARE",
"HEALTH_WELLNESS",
"HOME_SERVICES",
"REAL_ESTATE",
"FASHION",
"BEAUTY",
"PETS",
"GAMING",
"PARENTING",
"AUTOMOTIVE",
"LEGAL",
"RESTAURANTS",
"SPORTS",
"CRYPTO",
"CAREERS",
"HOME_DECOR",
"WEDDINGS",
"OUTDOORS",
"PHOTOGRAPHY",
"CRAFTS_DIY",
"CYBERSECURITY",
"NONPROFIT",
"MUSIC_CREATION",
"DRINKS",
"GENERAL"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1
},
"compare_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"history_days": {
"type": "integer",
"maximum": 90,
"minimum": 1
},
"content_types": {
"type": "array",
"items": {
"enum": [
"VIDEO",
"CONVERSATION",
"SEARCH",
"ARTICLE"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"lookback_hours": {
"type": "integer",
"default": 72,
"maximum": 720,
"minimum": 1
},
"observed_market": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"evidence_quality": {
"type": "array",
"items": {
"enum": [
"ATTRIBUTED_METADATA",
"PERMITTED_TEXT",
"INSPECTED_MEDIA"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
}
},
"additionalProperties": false
},
"product": {
"enum": [
"customers",
"niche",
"competitors",
"formats",
"search"
],
"type": "string"
},
"channels": {
"type": "array",
"items": {
"enum": [
"search",
"ai_search",
"conversations",
"video"
],
"type": "string"
},
"default": [
"search",
"ai_search",
"conversations",
"video"
],
"maxItems": 4,
"minItems": 1
},
"question": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"context_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"include_global": {
"type": "boolean",
"default": true
},
"include_adjacent": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"x-mcp-header": "request-id"
},
"max_credits": {
"type": "integer",
"maximum": 1000,
"minimum": 0
}
},
"additionalProperties": false
}