hooklayer
Qué hace este MCP
Analyzes short-form creators and videos, researches trends and viral templates, scores hooks and scripts, tracks creator changes, and generates content blueprints and remixes.
Herramientas
Esquema de entrada
{'type': 'object', 'required': ['handle'], 'properties': {'since': {'type': 'string', 'description': 'Optional ISO date (e.g. "2026-04-01"). Filter the candidate video pool to those posted on/after this date. Useful when the user asks "show me what they\'ve done THIS month" — the route returns honest empty + warning when the filter matches 0, no credits charged. Use either `since` or `window`, not both.'}, 'handle': {'type': 'string', 'description': 'Creator handle (with or without @ prefix) or YouTube channel ID. Examples: "@mrbeast", "mrbeast", "UCX6OQ3DkcsbYNE6H8uQQuVA".'}, 'window': {'enum': ['24h', '7d', '30d', '90d', '6m', '12m', 'this-month'], 'type': 'string', 'description': 'Recency sugar — same effect as `since` but takes a friendlier bucket. Maps to a since-cutoff at request time. Use either `since` or `window`, not both.'}, 'platform': {'enum': ['tiktok', 'youtube', 'instagram'], 'type': 'string', 'description': 'Platform to analyze. "tiktok" (default) returns full pipeline with transcripts. "youtube" analyzes recent Shorts via YouTube Data API + Innertube caption extraction — videos with captions disabled or geoblocked resolve to transcript: null. "instagram" (shipped 2026-07-06) fetches the creator\'s reels via ScrapeCreators Instagram API + best-effort reel transcripts on the top 5 — Instagram data lacks lifetime totalLikes so that field defaults to 0.'}, 'recent_only': {'type': 'boolean', 'description': 'When true, hard-cap the candidate pool to videos posted in the last 90 days. Stricter than `window=90d` because it never falls through to archival data on a thin recent corpus.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'profile': {'type': 'object', 'description': 'Creator profile (handle, bio, followers, following, total_likes, total_videos)'}, 'from_payg': {'type': 'boolean', 'description': 'Whether credits came from pay-as-you-go balance'}, 'steal_map': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Actionable elements to replicate from this creator'}, 'viral_dna': {'type': 'object', 'properties': {'viral_dna_score': {'type': 'number'}, 'audience_fatigue': {'type': 'number'}, 'consistency_score': {'type': 'number'}, 'originality_score': {'type': 'number'}, 'replicability_score': {'type': 'number'}}, 'description': 'Five viral DNA scores (0-100 each)'}, 'content_gaps': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Untapped content opportunities the creator is missing'}, 'recent_videos': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top recent videos with view counts, transcripts, and engagement'}, 'headline_insight': {'type': 'object', 'properties': {'wow': {'type': 'string', 'description': "The single most material finding in the account's data: the dimension (video length, hook type, format, posting cadence, or topic) with the largest quantified performance gap, stated with two real numbers from the creator's videos. Not a restated score."}, 'so_what': {'type': 'string', 'description': 'The one concrete change the wow gap implies, stated in a single line.'}, 'confidence': {'enum': ['high', 'medium', 'low'], 'type': 'string', 'description': 'Confidence in the headline insight; lower on thin (<8 videos) or stale (>30 days) samples.'}}, 'description': 'The largest quantified performance gap for this creator, plus its implication. Presentation-neutral data — the caller decides whether and how to surface it.'}, 'pattern_analysis': {'type': 'object', 'description': 'Content pattern breakdown (posting cadence, topic clusters)'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'from_subscription': {'type': 'boolean', 'description': 'Whether credits came from subscription'}, 'recommended_chain': {'type': 'array', 'items': {'type': 'object', 'properties': {'cost': {'type': 'number', 'description': 'Credit cost for this tool call'}, 'tool': {'type': 'string', 'description': 'Exact tool name to call'}, 'params': {'type': 'object', 'description': 'Pre-filled parameters for the tool'}, 'reason': {'type': 'string', 'description': 'Why this step is recommended'}, 'confidence': {'enum': ['high', 'medium', 'low'], 'type': 'string', 'description': 'Signal-derived confidence that this step will produce useful results'}, 'action_class': {'enum': ['research', 'synthesize', 'draft', 'publish', 'account'], 'type': 'string', 'description': 'Authority taxonomy: research (read-only data gathering, lowest authority), synthesize (generate content in-memory, low), draft (save to workspace, medium), publish (post to external platforms, HIGH), account (modify account/billing, HIGHEST). All Hooklayer v1 tools are research or synthesize.'}, 'side_effects': {'type': 'string', 'description': 'Service-side effects this step would cause, stated honestly. HookLayer never modifies TikTok, Instagram, YouTube or TikTok Shop accounts or content. It DOES change internal HookLayer state: every billable tool debits the credit balance and writes a usage record, watch_account persists a creator watch, and get_changes / product_scout persist snapshots and history. Use "none" only for a tool that charges nothing and writes nothing (list_watches).'}, 'expected_output': {'type': 'string', 'description': 'One-line summary of what this tool returns'}}}, 'description': 'Suggested next tool calls with pre-filled parameters — advisory only, agent decides whether to execute'}, 'format_fingerprint': {'type': 'object', 'description': 'Dominant content format patterns (durations, styles, edit types)'}}}
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'market': {'type': 'string', 'description': "2-letter ISO region code or 'GLOBAL'. Defaults to US. Should match the market the product was found in."}, 'product_id': {'type': 'string', 'description': 'TikTok Shop numeric product id, as returned by product_scout in opportunities[].product_id. Supply this or product_url.'}, 'product_url': {'type': 'string', 'description': 'Any TikTok Shop product URL (tiktok.com/shop/pdp/..., shop.tiktok.com/.../pdp/..., /view/product/...). Used when the user pastes a link instead of an id.'}, 'include_competitors': {'type': 'boolean', 'description': 'Default true. Competitor discovery and the cross-product buyer-pain map are the differentiated part of this report; set false only when the caller explicitly wants the single-product read and fewer provider calls. The credit cost is the same either way.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['success'], 'properties': {'region': {'type': 'string'}, 'success': {'type': 'boolean'}, 'economics': {'type': 'object', 'description': 'Price and margin context. Contains no revenue or GMV figure.'}, 'fetched_at': {'type': 'string'}, 'product_id': {'type': 'string'}, 'provenance': {'type': 'object', 'description': 'Endpoints called, provider call count, staleness, and which fields the model wrote.'}, 'buyer_voice': {'type': 'object', 'description': 'Review sample summary including rating histogram and sampled count.'}, 'competition': {'type': 'object', 'description': 'Percentile placement against the peer set, when one was resolvable.'}, 'analyst_read': {'type': 'object', 'description': 'Model-written operator summary grounded in the sections above. Falls back to a deterministic version if the model call fails.'}, 'market_proof': {'type': 'object', 'description': 'Demand evidence section. Carries available / headline / data / evidence / risks / unknowns / confidence.'}, 'buyer_pain_map': {'type': 'object', 'description': 'Themes shared across this product and its competitors, with differentiation candidates. Rates are per-product, so a deeply sampled product does not outweigh a shallowly sampled rival.'}, 'analyst_verdict': {'type': 'object', 'description': 'Deterministic verdict and confidence.'}, 'creator_content': {'type': 'object'}, 'source_coverage': {'type': 'object', 'description': 'Which sections resolved and which did not.'}, 'validation_read': {'type': ['object', 'null'], 'description': 'Extended validation narrative. Null when include_competitors was false.'}, 'content_patterns': {'type': 'object'}, 'current_evidence': {'type': 'object', 'description': 'Composite score from currently observable evidence, with what was unavailable.'}, 'evidence_classes': {'type': 'object', 'properties': {'fact': {'type': 'array', 'items': {'type': 'string'}}, 'analysis': {'type': 'array', 'items': {'type': 'string'}}, 'unavailable': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'Explicit map so the host never has to guess provenance: fact[] came from the provider, analysis[] was derived by HookLayer, unavailable[] had insufficient evidence.'}, 'product_identity': {'type': 'object', 'description': 'title, shopName, category, productUrl, imageUrl.'}, 'credits_remaining': {'type': ['integer', 'null']}, 'recommended_chain': {'type': 'array', 'items': {'type': 'object', 'properties': {'why': {'type': 'string'}, 'tool': {'type': 'string'}, 'params': {'type': 'object'}, 'credits': {'type': 'integer'}}}, 'description': 'Suggested next calls, chosen from the evidence this analysis actually found. SUGGESTIONS ONLY - present them and let the user pick. Do not call them automatically; each one costs the user credits.'}, 'competitor_landscape': {'type': 'object', 'description': 'Comparable products and where they are weak. available:false when competitor discovery did not resolve.'}, 'evidence_interpretation': {'type': 'object', 'description': 'Why Now plus risks split into product / market / data_confidence, each citing the observation that triggered it. Only claims what is observable now; never asserts a trend it has no history for.'}, 'buyer_voice_intelligence': {'type': ['object', 'null'], 'description': "Opportunity-grade review read: sampleComposition, love, painPoints, unmetNeeds, purchaseObjections, returnSignal, fulfilmentComplaints (kept separate from product faults), contradictions, and howToBeatThis. Null when reviews did not resolve - null means no evidence, not 'no complaints'."}}}
Esquema de entrada
{'type': 'object', 'required': ['product', 'product_category', 'niche'], 'properties': {'niche': {'enum': ['Beauty & Skincare', 'Fitness & Health', 'Food & Cooking', 'Fashion & Style', 'Tech & Gadgets', 'Finance & Business', 'Education & Learning', 'Travel & Adventure', 'Comedy & Entertainment', 'Gaming', 'Lifestyle & Wellness', 'Parenting & Family', 'DIY & Crafts', 'Music & Dance', 'Pets & Animals', 'Sports', 'Motivation & Self-Help', 'SaaS & AI Tools'], 'type': 'string', 'description': 'One of the 18 supported niches (Beauty & Skincare, Fitness & Health, Food & Cooking, Fashion & Style, Tech & Gadgets, Finance & Business, Education & Learning, Travel & Adventure, Comedy & Entertainment, Gaming, Lifestyle & Wellness, Parenting & Family, DIY & Crafts, Music & Dance, Pets & Animals, Sports, Motivation & Self-Help, SaaS & AI Tools). Loose names like "beauty" or "fitness" are auto-mapped.'}, 'region': {'type': 'string', 'description': 'Optional 2-letter ISO country code (US, GB, CA, etc.). Threads to niche + trend upstreams.'}, 'product': {'type': 'string', 'description': 'What the brand sent (name + one line, e.g. "Athletic Greens AG1 travel packs — 30-count individual sachets for travel")'}, 'platform': {'enum': ['tiktok', 'instagram'], 'type': 'string', 'description': 'Target platform. Both TikTok and Instagram Reels supported (shipped 2026-07-06). When set to "instagram", the product-corpus lookup runs against Instagram Reels via ScrapeCreators, and the creator context (if creator_handle passed) fetches Instagram reels. Default: tiktok.'}, 'creator_handle': {'type': 'string', 'description': 'Optional creator handle (with or without @). If provided, the blueprint hook and script match THEIR voice patterns from recent videos. Highly recommended — a blueprint without creator context is generic.'}, 'deadline_hours': {'type': 'integer', 'maximum': 168, 'minimum': 1, 'description': 'How many hours until the video must be posted. Default 48. Affects trend-still-alive scoring — a 24-hour deadline needs a trend on the up-slope, not one that just plateaued.'}, 'product_category': {'type': 'string', 'description': 'Umbrella category (e.g. "greens powder", "sunscreen", "protein bar")'}}}
Esquema de salida
{'type': 'object', 'properties': {'as_of': {'type': 'string'}, 'stats': {'type': 'object', 'properties': {'rising_trends': {'type': 'integer'}, 'product_videos': {'type': 'integer'}, 'niche_templates': {'type': 'integer'}, 'creator_context_available': {'type': 'boolean'}}}, 'applied': {'type': 'object', 'description': 'Echo of parameters resolved after canonicalization'}, 'quality': {'type': 'object', 'properties': {'level': {'enum': ['full', 'partial', 'degraded'], 'type': 'string'}, 'reason': {'type': 'string'}}}, 'success': {'type': 'boolean'}, 'blueprint': {'type': 'object', 'properties': {'hook': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'pattern': {'type': 'string'}, 'why_this_hook': {'type': 'string'}, 'trend_still_alive': {'enum': ['up-slope', 'plateau', 'fading', 'unknown'], 'type': 'string'}}}, 'script': {'type': 'object'}, 'verdict': {'enum': ['GO', 'NEEDS_MORE_DATA', 'NO_GO'], 'type': 'string'}, 'hashtags': {'type': 'array', 'items': {'type': 'string'}}, 'risk_flags': {'type': 'array', 'items': {'type': 'string'}}, 'shoot_notes': {'type': 'object'}, 'verdict_reason': {'type': 'string'}, 'why_this_will_land': {'type': 'array', 'items': {'type': 'string'}}, 'manager_talking_points': {'type': 'array', 'items': {'type': 'string'}}}}, 'provenance': {'type': 'object'}, 'credits_remaining': {'type': 'object', 'properties': {'payg': {'type': 'number'}, 'total': {'type': 'number'}, 'subscription': {'type': 'number'}}}}}
Esquema de entrada
{'type': 'object', 'required': ['niche'], 'properties': {'niche': {'enum': ['Beauty & Skincare', 'Fitness & Health', 'Food & Cooking', 'Fashion & Style', 'Tech & Gadgets', 'Finance & Business', 'Education & Learning', 'Travel & Adventure', 'Comedy & Entertainment', 'Gaming', 'Lifestyle & Wellness', 'Parenting & Family', 'DIY & Crafts', 'Music & Dance', 'Pets & Animals', 'Sports', 'Motivation & Self-Help', 'SaaS & AI Tools'], 'type': 'string', 'description': 'One of the 18 supported niches (Beauty & Skincare, Fitness & Health, Food & Cooking, Fashion & Style, Tech & Gadgets, Finance & Business, Education & Learning, Travel & Adventure, Comedy & Entertainment, Gaming, Lifestyle & Wellness, Parenting & Family, DIY & Crafts, Music & Dance, Pets & Animals, Sports, Motivation & Self-Help, SaaS & AI Tools). Loose names like "travel" or "fitness" are accepted but pass the canonical form when possible.'}, 'query': {'type': 'string', 'description': 'Optional angle narrowing within the niche. E.g. niche="Fitness & Health" + query="postpartum strength" returns only postpartum-strength templates, not generic gym. Templates are scored by query-token match against title+description+hashtags; zero-match templates are dropped. Leave empty for niche-wide top templates.'}, 'region': {'type': 'string', 'description': 'Optional 2-letter ISO country code (US, GB, BR, JP, IN, PH, etc.). Threads to YouTube Search regionCode + TikTok niche query. Reddit niche signals are global and ignore this param. Pass when the user wants templates that resonate with a specific local audience.'}, 'window': {'enum': ['24h', '7d', '30d', '90d', 'this-month'], 'type': 'string', 'description': 'Recency filter. Drops example videos older than the window. Note: TikTok hashtag-corpus rows often lack timestamps and are excluded when window is set — surfaces as a quality warning so callers can decide whether to broaden.'}, 'platform': {'enum': ['tiktok', 'instagram'], 'type': 'string', 'description': 'Platform to source templates from. "tiktok" (default) uses the full niche-aggregator (YouTube + Reddit + TikTok hashtags). "instagram" (2026-07-06) is keyword-search-only — the Instagram niche-aggregator isn\'t plumbed yet, so `query` becomes REQUIRED on IG. Output rubric_version signals which path ran: find_viral_template.v1 (main), .v2-keyword-fallback (TikTok fallback), .v3-instagram-keyword-only (IG-only path).'}, 'min_views': {'type': 'integer', 'minimum': 0, 'description': 'Optional filter — only return examples above this view count'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'niche': {'type': 'string', 'description': 'The niche searched'}, 'from_payg': {'type': 'boolean', 'description': 'Whether credits came from pay-as-you-go balance'}, 'templates': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'format': {'type': 'string'}, 'avg_views': {'type': 'number'}, 'hook_pattern': {'type': 'string'}}}, 'description': 'Ranked viral templates with hook patterns and example URLs'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'from_subscription': {'type': 'boolean', 'description': 'Whether credits came from subscription'}}}
Esquema de entrada
{'type': 'object', 'properties': {'handle': {'type': 'string', 'description': 'Creator handle (with or without @). Required if watch_id is not provided.'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string', 'description': 'Platform the tracked creator publishes on. Required if watch_id is not provided.'}, 'watch_id': {'type': 'string', 'description': 'Watch identifier returned by watch_account or list_watches. Preferred over (platform, handle) when you have it — the ownership check is exact.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'status': {'enum': ['changes_found', 'no_meaningful_change', 'baseline_refreshed', 'not_tracked', 'no_baseline'], 'type': 'string', 'description': 'changes_found = meaningful shifts detected; no_meaningful_change = fresh analysis ran, nothing shifted enough to matter; baseline_refreshed = prior snapshot used an incompatible schema, new baseline saved; not_tracked = no active CreatorWatch for that creator; no_baseline = watch exists but has no snapshots yet.'}, 'changes': {'type': 'array', 'items': {'type': 'object', 'properties': {'after': {}, 'delta': {'type': 'number'}, 'before': {}, 'evidence': {'type': 'string'}, 'delta_pct': {'type': 'number'}, 'importance': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'change_type': {'enum': ['viral_dna_shift', 'engagement_shift', 'follower_shift', 'format_shift', 'hook_pattern_shift', 'topic_shift', 'outlier_emergence'], 'type': 'string'}, 'why_it_matters': {'type': 'string'}, 'recommended_action': {'type': 'object', 'properties': {'tool': {'type': 'string'}, 'params': {'type': 'object'}, 'reason': {'type': 'string'}}}}}}, 'creator': {'type': 'string'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}, 'top_action': {'type': 'object', 'properties': {'tool': {'type': 'string'}, 'params': {'type': 'object'}, 'reason': {'type': 'string'}}, 'description': 'Single most useful next tool call given the detected changes. null when nothing meaningful shifted.'}, 'snapshot_count': {'type': 'number', 'description': 'Total snapshots saved for this watch after this call.'}, 'credits_charged': {'type': 'number'}, 'high_importance': {'type': 'number'}, 'medium_importance': {'type': 'number'}, 'meaningful_changes': {'type': 'number', 'description': 'Count of high + medium importance changes.'}, 'current_snapshot_at': {'type': 'string'}, 'previous_snapshot_at': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'total': {'type': 'number'}, 'watches': {'type': 'array', 'items': {'type': 'object', 'properties': {'handle': {'type': 'string'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}, 'watch_id': {'type': 'string'}, 'is_active': {'type': 'boolean'}, 'created_at': {'type': 'string'}, 'updated_at': {'type': 'string'}, 'snapshot_count': {'type': 'number'}, 'last_snapshot_at': {'type': 'string', 'description': 'null when no snapshot exists (rare — only if a persistence race happened)'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['draft', 'reference_samples'], 'properties': {'draft': {'type': 'string', 'description': 'The text to rewrite'}, 'reference_samples': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 3, 'description': 'At least 3 reference samples — TikTok/YouTube/Instagram URLs or raw text'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'from_payg': {'type': 'boolean', 'description': 'Whether credits came from pay-as-you-go balance'}, 'voice_profile': {'type': 'object', 'properties': {'humor': {'type': 'string'}, 'energy': {'type': 'string'}, 'signatures': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Signature phrases and moves'}, 'vocabulary': {'type': 'string'}}, 'description': 'Extracted voice DNA profile'}, 'rewritten_draft': {'type': 'string', 'description': 'The input draft rewritten in the matched voice'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'from_subscription': {'type': 'boolean', 'description': 'Whether credits came from subscription'}, 'prompt_instructions': {'type': 'string', 'description': 'Reusable prompt to replicate this voice'}}}
Esquema de entrada
{'type': 'object', 'required': ['script'], 'properties': {'niche': {'type': 'string', 'description': 'Niche context'}, 'script': {'type': 'string', 'description': 'The draft script to predict on (or a video URL — auto-extracts transcript)'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'blueprint': {'type': 'object', 'description': 'Retention diagnosis with weak seconds identified'}, 'from_payg': {'type': 'boolean', 'description': 'Whether credits came from pay-as-you-go balance'}, 'viral_dna': {'type': 'object', 'description': 'Hook type, structure, emotional triggers breakdown'}, 'share_reason': {'type': 'string', 'description': 'Why viewers would share this content'}, 'target_emotion': {'type': 'string', 'description': 'Primary emotion the content targets'}, 'virality_score': {'type': 'number', 'description': 'Overall virality prediction (0-100)'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'from_subscription': {'type': 'boolean', 'description': 'Whether credits came from subscription'}}}
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'sort': {'type': 'string', 'description': 'Order the results: momentum, creator_adoption, price_asc, price_desc, reviews, rating, sold, discount, opportunity. History-backed sorts are refused up front when history is unavailable rather than silently falling back.'}, 'limit': {'type': 'integer', 'description': 'Max products to return. Default 20, hard cap 20. This is a ceiling, not a target — fewer rows means the provider had fewer matching products, never that results were withheld.'}, 'niche': {'type': 'string', 'description': "Niche or category to search (e.g. 'Beauty & Skincare', 'Fitness & Wellness'). At least one of niche or query is required."}, 'query': {'type': 'string', 'description': "Free-text product keywords (e.g. 'wireless earbuds'). Widens the search corpus. May be combined with niche."}, 'market': {'type': 'string', 'description': "2-letter ISO region code (US, GB, BR, ...) or 'GLOBAL'. Defaults to US. Only regions ScrapeCreators covers for TikTok Shop return usable data."}, 'category': {'type': 'string', 'description': 'Strict category-breadcrumb filter applied to returned rows (case-insensitive substring). Rows whose category is unknown are dropped when this is set. Distinct from niche, which is a search hint rather than a gate.'}, 'max_sold': {'type': 'integer', 'description': 'Maximum provider-reported cumulative sold count. Strict: unknown is dropped.'}, 'min_sold': {'type': 'integer', 'description': 'Minimum provider-reported cumulative sold count. This is a lifetime total, not a sales rate. Strict: unknown is dropped.'}, 'price_max': {'type': 'number', 'description': 'Maximum price in the market currency.'}, 'price_min': {'type': 'number', 'description': 'Minimum price in the market currency.'}, 'max_rating': {'type': 'number', 'description': 'Maximum average rating 0-5. Pair with min_rating to isolate a mid-tier band rather than only top-rated listings. Strict: unknown rating is dropped.'}, 'min_rating': {'type': 'number', 'description': 'Minimum average rating 0-5. Strict: rows with unknown rating are dropped.'}, 'max_reviews': {'type': 'integer', 'description': 'Maximum provider-reported review count - the usual way to find products before they are saturated with social proof. Strict: rows whose review count could not be retrieved are dropped rather than assumed to be zero.'}, 'min_reviews': {'type': 'integer', 'description': 'Minimum provider-reported review count. Review counts are fetched per candidate, so this filter reflects real provider data. Strict: rows whose review count could not be retrieved are dropped rather than assumed to be zero.'}, 'max_discount': {'type': 'number', 'description': 'Maximum discount percentage 0-100. Strict: unknown is dropped.'}, 'min_discount': {'type': 'number', 'description': 'Minimum discount percentage 0-100 off the listed original price. Strict: unknown is dropped.'}, 'min_momentum': {'type': 'number', 'description': 'Minimum momentum component 0-100. Momentum needs stored history; when the history layer has not seen these products yet the request is refused up front with executed:false rather than charged and returned empty.'}, 'max_saturation': {'type': 'number', 'description': 'Maximum saturation component 0-100. Saturation needs video-to-product linkage that the current pipeline does not extract, so this is accepted for forward compatibility and reported as unsupported rather than silently applied.'}, 'max_competition': {'type': 'number', 'description': 'Maximum competition tolerated, 0-100, expressed intuitively (lower = less competition accepted).'}, 'opportunity_stage': {'type': 'string', 'description': "Comma-separated stages to keep: emerging, promising, crowded, mature, cooling. Use 'emerging,promising' for the usual 'find breakout products' request."}, 'min_creator_adoption': {'type': 'number', 'description': 'Minimum creator-adoption component 0-100 (distinct creators per day with confirmed showcase links). Needs stored history; cold-start products report insufficient_data for this component.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['success'], 'properties': {'niche': {'type': ['string', 'null']}, 'query': {'type': ['string', 'null']}, 'region': {'type': 'string'}, 'success': {'type': 'boolean'}, 'executed': {'type': 'boolean', 'description': 'Present and false when the request needed stored history that is unavailable. Nothing was charged; drop the history-backed filter or sort and retry.'}, 'provenance': {'type': 'object'}, 'generated_at': {'type': 'string', 'description': 'ISO timestamp'}, 'opportunities': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': ['number', 'null']}, 'region': {'type': 'string'}, 'shop_id': {'type': ['string', 'null']}, 'currency': {'type': ['string', 'null']}, 'image_url': {'type': ['string', 'null']}, 'shop_name': {'type': ['string', 'null']}, 'avg_rating': {'type': ['number', 'null']}, 'product_id': {'type': 'string'}, 'opportunity': {'type': 'object', 'properties': {'risks': {'type': 'array', 'items': {'type': 'string'}}, 'score': {'type': ['number', 'null'], 'description': '0-100 composite. Null when status is insufficient_data.'}, 'status': {'enum': ['emerging', 'promising', 'crowded', 'mature', 'cooling', 'early_read', 'insufficient_data'], 'type': 'string'}, 'why_now': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Evidence-cited reasons the composite landed where it did.'}, 'components': {'type': 'object', 'description': '9 components, each {value|null, status, confidence|null, reason}.'}, 'confidence': {'type': 'number'}, 'insufficient_signals': {'type': 'array', 'items': {'type': 'object', 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['insufficient_data', 'unavailable'], 'type': 'string'}, 'component': {'type': 'string'}}}, 'description': 'Every component that could not contribute, so partial coverage is disclosed honestly.'}}, 'description': 'Score plus the evidence behind it. Never surface score without components / why_now / risks / insufficient_signals.'}, 'product_url': {'type': ['string', 'null'], 'description': 'TikTok Shop canonical URL, validated before it leaves the server. Null when unavailable.'}, 'product_title': {'type': ['string', 'null']}, 'history_coverage': {'type': 'object', 'properties': {'review_snapshots': {'type': 'integer'}, 'product_snapshots': {'type': 'integer'}, 'newest_snapshot_age_days': {'type': ['number', 'null']}, 'oldest_snapshot_age_days': {'type': ['number', 'null']}, 'creator_product_snapshots': {'type': 'integer'}}, 'description': 'How much stored history the engine actually saw for this product.'}, 'product_category': {'type': ['string', 'null']}, 'provider_reported': {'type': 'object', 'properties': {'sold_count': {'type': ['integer', 'null'], 'description': 'Cumulative lifetime units, not a rate. Never multiply by price to imply revenue.'}, 'review_count': {'type': ['integer', 'null']}, 'commission_rate': {'type': ['number', 'null']}}, 'description': 'Facts supplied by TikTok. Null means the provider did not expose the field - it does NOT mean zero, and must never be reported to the user as "none" or "no reviews".'}, 'discount_percentage': {'type': ['number', 'null']}}}}, 'query_context': {'type': 'object', 'description': 'The filters actually applied, echoed back.'}, 'source_coverage': {'type': 'object', 'description': 'What the engine managed to read: shop search, product hydration, history depth, counts.'}, 'credits_remaining': {'type': ['integer', 'null']}, 'recommended_chain': {'type': 'array', 'items': {'type': 'object', 'properties': {'why': {'type': 'string', 'description': 'Grounded reason this step is worth taking, safe to show the user verbatim.'}, 'tool': {'type': 'string'}, 'params': {'type': 'object'}, 'credits': {'type': 'integer'}}}, 'description': 'Suggested next calls, chosen from what this result actually contained. SUGGESTIONS ONLY - present them and let the user pick. Do not call them automatically; each one costs the user credits.'}, 'degradation_reasons': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Why coverage was partial, when it was. Surface these rather than presenting a degraded result as complete.'}, 'skipped_intelligence_filters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filters that could not be enforced for this request.'}}}
Esquema de entrada
{'type': 'object', 'required': ['text', 'platform'], 'properties': {'text': {'type': 'string', 'description': 'The hook to score (3-200 chars typical)'}, 'niche': {'type': 'string', 'description': 'Optional niche context (e.g. "Beauty & Skincare", "Finance & Business")'}, 'platform': {'enum': ['tiktok', 'reels', 'shorts'], 'type': 'string', 'description': 'Target platform — affects pattern matching'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'why': {'type': 'string', 'description': 'One-sentence verdict explaining the score'}, 'score': {'type': 'number', 'description': 'Hook quality score (0-100)'}, 'rewrites': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Three rewritten versions at higher quality'}, 'breakdown': {'type': 'object', 'properties': {'urgency': {'type': 'number'}, 'curiosity': {'type': 'number'}, 'specificity': {'type': 'number'}, 'emotional_pull': {'type': 'number'}, 'pattern_alignment': {'type': 'number'}}, 'description': 'Sub-scores (0-100) for five quality dimensions'}, 'from_payg': {'type': 'boolean', 'description': 'Whether credits came from pay-as-you-go balance'}, 'strengths': {'type': 'array', 'items': {'type': 'string'}, 'description': 'What the hook does well'}, 'percentile': {'type': 'number', 'description': 'Percentile rank vs all scored hooks'}, 'weaknesses': {'type': 'array', 'items': {'type': 'string'}, 'description': 'What could be improved'}, 'pattern_match': {'type': 'string', 'description': 'Matched viral pattern name'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'from_subscription': {'type': 'boolean', 'description': 'Whether credits came from subscription'}}}
Esquema de entrada
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max videos to return after filtering. Default 12, max 20.'}, 'niche': {'type': 'string', 'description': 'Optional — only return videos whose description contains niche-related tokens. Loose niche strings work ("fitness", "Beauty & Skincare").'}, 'query': {'type': 'string', 'description': 'Free-text search term. Examples: "morning routine", "iphone case", "passive income".'}, 'region': {'type': 'string', 'description': 'ISO country code (US, GB, BR, PH, JP, etc.). Note: corpus coverage varies by region — small regions may return zero results and a degraded quality flag.'}, 'window': {'enum': ['24h', '7d', '30d', 'this-month'], 'type': 'string', 'description': 'Recency filter. Maps to the closest ScrapeCreators date bucket AND applies a client-side cutoff for defense-in-depth.'}, 'platform': {'enum': ['tiktok', 'instagram'], 'type': 'string', 'description': 'Which platform to search. "tiktok" (default) hits ScrapeCreators TikTok keyword search. "instagram" (2026-07-06) hits Instagram Reels search — note IG upstream ignores region/date_posted params, so region enforcement is client-side only (region_verified_count in the response tells you how many results verifiably matched).'}, 'min_views': {'type': 'integer', 'minimum': 0, 'description': 'Optional view-count floor. Default 0.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'videos': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'likes': {'type': 'number'}, 'saves': {'type': 'number'}, 'views': {'type': 'number'}, 'author': {'type': 'object', 'properties': {'nickname': {'type': 'string'}, 'username': {'type': 'string'}}}, 'shares': {'type': 'number'}, 'comments': {'type': 'number'}, 'duration': {'type': 'number'}, 'hashtags': {'type': 'array', 'items': {'type': 'string'}}, 'posted_at': {'type': 'string'}, 'thumbnail': {'type': 'string'}, 'description': {'type': 'string'}, 'engagement_score': {'type': 'number'}}}}, 'applied': {'type': 'object', 'description': 'Echo of the filters actually applied — useful for debugging when results look surprising'}, 'quality': {'type': 'object', 'properties': {'level': {'enum': ['full', 'partial', 'degraded'], 'type': 'string'}, 'reason': {'type': 'string'}}}, 'from_payg': {'type': 'boolean'}, 'filtered_count': {'type': 'number', 'description': 'Videos returned after filtering + cap'}, 'upstream_count': {'type': 'number', 'description': 'Videos returned by upstream before any filtering'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'from_subscription': {'type': 'boolean'}}}
Esquema de entrada
{'type': 'object', 'properties': {'niche': {'enum': ['Beauty & Skincare', 'Fitness & Health', 'Food & Cooking', 'Fashion & Style', 'Tech & Gadgets', 'Finance & Business', 'Education & Learning', 'Travel & Adventure', 'Comedy & Entertainment', 'Gaming', 'Lifestyle & Wellness', 'Parenting & Family', 'DIY & Crafts', 'Music & Dance', 'Pets & Animals', 'Sports', 'Motivation & Self-Help', 'SaaS & AI Tools'], 'type': 'string', 'description': 'One of the 18 supported niches (Beauty & Skincare, Fitness & Health, Food & Cooking, Fashion & Style, Tech & Gadgets, Finance & Business, Education & Learning, Travel & Adventure, Comedy & Entertainment, Gaming, Lifestyle & Wellness, Parenting & Family, DIY & Crafts, Music & Dance, Pets & Animals, Sports, Motivation & Self-Help, SaaS & AI Tools). Loose names like "travel" or "fitness" are accepted but pass the canonical form when possible. Omit for broadly applicable trends.'}, 'region': {'type': 'string', 'description': 'Optional 2-letter ISO country code (US, GB, BR, JP, IN, PH, etc.). Threads to Google Trends geo + YouTube regionCode. Defaults to US when omitted. Reddit signals are global and ignore this param.'}, 'deadline_hours': {'type': 'integer', 'maximum': 168, 'minimum': 1, 'description': 'Optional (2026-07-06 magic-genie ritual): how many hours until the video posts. When set, each rising trend gets a trend_status (up-slope | plateau | fading | unknown) AND a deadline_verdict (safe | risky | no-go) so managers can answer "will this trend still be alive when the video posts?" without eyeballing the growth label. Use this on every brief-just-landed call — it turns trend_pulse from "what\'s trending" into "what\'s SAFE to bet on for MY post window."'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'niche': {'type': 'string', 'description': 'The niche these trends apply to'}, 'rising': {'type': 'array', 'items': {'type': 'object', 'properties': {'type': {'type': 'string'}, 'title': {'type': 'string'}, 'growth': {'type': 'string', 'description': 'Qualitative growth label ("Rising", "Early signal", "Accelerating"). NOT a numeric percentage — the upstream does not compute "+178%"-style rates. Use signal_strength as the quantitative anchor.'}, 'suggestion': {'type': 'string'}}}, 'description': 'Rising opportunities (format/hook/style) with qualitative growth labels + signal_strength numeric anchor (0-1) + suggestions'}, 'from_payg': {'type': 'boolean', 'description': 'Whether credits came from pay-as-you-go balance'}, 'saturated': {'type': 'array', 'items': {'type': 'object', 'properties': {'type': {'type': 'string'}, 'title': {'type': 'string'}, 'status': {'type': 'string'}}}, 'description': 'Saturated patterns to avoid'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'from_subscription': {'type': 'boolean', 'description': 'Whether credits came from subscription'}}}
Esquema de entrada
{'type': 'object', 'anyOf': [{'required': ['source_url']}, {'required': ['transcript']}], 'properties': {'niche': {'type': 'string', 'description': 'Optional niche hint'}, 'my_topic': {'type': 'string', 'description': 'DEPRECATED alias for target_topic. Legacy clients only. Normalized internally.'}, 'platform': {'enum': ['tiktok', 'reels', 'shorts'], 'type': 'string', 'description': 'Target platform for the remix. Adjusts pacing and CTA style if provided.'}, 'source_url': {'type': 'string', 'description': 'TikTok/YouTube/Instagram URL — transcript will be auto-extracted'}, 'transcript': {'type': 'string', 'description': 'Pre-extracted transcript (alternative to source_url, faster)'}, 'target_topic': {'type': 'string', 'description': 'What the remix should be about. Default: same niche as original.'}, 'target_product': {'type': 'string', 'description': 'The product the remix should promote. When provided, the generator will NOT invent product names, prices, timelines, features, or customer stories. Combined with verified_product_facts, this forces on-topic + grounded output.'}, 'verified_product_facts': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Facts the generator is allowed to cite about target_product (e.g. "runs inside ChatGPT and Claude", "14 tools for viral research"). Every specific product claim in the generated script is checked against this list — unsupported claims populate unsupported_claims[] and downgrade quality. If target_product is passed WITHOUT verified_product_facts, the response will land at degraded quality (generation cannot be grounded).'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'overlays': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Text overlay suggestions per scene'}, 'from_payg': {'type': 'boolean', 'description': 'Whether credits came from pay-as-you-go balance'}, 'verify_hook': {'type': 'object', 'description': 'The hook plus a suggested follow-up: the caller may pass it to score_hook for a structurally-independent score (the script generator deliberately does NOT self-rate). Informational only, not an instruction to call anything.'}, 'camera_shots': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Phone-native camera direction per scene'}, 'fresh_script': {'type': 'object', 'properties': {'cta': {'type': 'string', 'description': 'Call-to-action closing'}, 'hook': {'type': 'string', 'description': 'Opening hook line'}, 'scenes': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Scene-by-scene script with voiceover, visuals, and timing'}}, 'description': 'Complete scene-by-scene script mirroring the source structure'}, 'cta_archetype': {'enum': ['result_close', 'soft_bio_pointer', 'genuine_question', 'pinned_comment', 'comment_gate'], 'type': 'string', 'description': 'Which CTA archetype the generator picked. Comment_gate is the failure-mode default for AI script generators; rotation tells you whether the prompt is working.'}, 'ugc_authenticity': {'type': 'object', 'properties': {'level': {'enum': ['native', 'ad_leaning'], 'type': 'string', 'description': 'Honest signal of whether the generator drifted ad-ward'}, 'reasons': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of detected drift reasons (e.g. "hook is 22 words", "CTA is comment-gate")'}}, 'description': 'Tripwire for ad-shaped drift. Detected via regex on the produced script, not the model self-grade. If level=ad_leaning, surface to the user before shipping.'}, 'credits_remaining': {'type': 'number', 'description': 'Credits remaining after this call'}, 'extracted_formula': {'type': 'string', 'description': 'The viral DNA formula extracted from the source'}, 'from_subscription': {'type': 'boolean', 'description': 'Whether credits came from subscription'}, 'structural_skeleton': {'type': 'string', 'description': 'Which structural skeleton the generator used (confession_to_result, mistake_to_correction, etc). Surfaces rotation across the fleet.'}}}
Esquema de entrada
{'type': 'object', 'required': ['handle', 'platform'], 'properties': {'handle': {'type': 'string', 'description': 'Creator handle (with or without @ prefix). Examples: "@mrbeast", "mrbeast".'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string', 'description': 'Platform the creator publishes on. Same platforms as analyze_account.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'status': {'enum': ['tracked', 'already_tracked'], 'type': 'string'}, 'creator': {'type': 'string', 'description': 'Normalized "@handle" the watch is stored under'}, 'message': {'type': 'string'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}, 'watch_id': {'type': 'string'}, 'data_age_days': {'type': 'number', 'description': 'Age in days of the newest video in the baseline'}, 'snapshot_count': {'type': 'number', 'description': 'Total snapshots stored for this watch so far'}, 'baseline_source': {'enum': ['watch_snapshot', 'analysis_cache', 'fresh'], 'type': 'string', 'description': 'watch_snapshot = existing CreatorWatch already had a fresh snapshot (0 credits); analysis_cache = recent analyze_account response reused to build a new baseline (0 credits); fresh = analyze_account invoked, 5 credits charged.'}, 'credits_charged': {'type': 'number'}, 'baseline_created_at': {'type': 'string', 'description': 'ISO timestamp of the baseline snapshot'}}}
Cambios recientes en herramientas
Servidores MCP similares
mcp
Searches YouTube sponsors and channels, identifies sponsorship relationships, and supports advertiser and creator discovery and a…
Shorti
Finds short-form video trends and formats, explains how videos were made, and supports creator checks and brand campaign planning.
Cadencz
Uses website context to plan, draft, schedule, publish and analyze social media posts across connected channels.
autowhisper-mcp
Uses an AI marketing workspace to generate, review, publish, and measure advertising and social content across connected platform…
ContentIn — LinkedIn Ghostwriter
Creates LinkedIn post ideas and drafts in a user's voice, stores content, attaches images, schedules or publishes posts, and retr…
Post Kit
Drafts platform-specific social posts and short-form video scripts, adapts posts for markets and languages, and creates animated …
AI Content Repurposer Tool: URL to 9 Formats
Transforms URLs or text into platform-specific content such as social posts, video titles, and captions.
Multi Upload Tool
Schedules and publishes videos across TikTok, YouTube, Instagram, and other social networks.