url-intent-parser

# Ads URL Parser

## Purpose
Core mission:
- URL parsing, intent extraction, launch brief generation

This skill is specialized for advertising workflows and should output actionable plans rather than generic advice.

## When To Trigger
Use this skill when the user asks for:
- ad execution guidance tied to business outcomes
- growth decisions involving revenue, roas, cpa, or budget efficiency
- platform-level actions for: Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, Shopify Ads, DSP/programmatic
- this specific capability: URL parsing, intent extraction, launch brief generation

High-signal keywords:
- ads, advertising, campaign, growth, revenue, profit
- roas, cpa, roi, budget, bidding, traffic, conversion, funnel
- meta, googleads, tiktokads, youtubeads, amazonads, shopifyads, dsp

## Input Contract
Required:
- url: product, service, or landing page URL
- business_goal: sales, leads, traffic, or awareness
- market_scope: country or language market

Optional:
- target_audience_hint
- offer_and_pricing
- launch_timeline
- current_kpi_baseline

## Output Contract
1. Intake Summary
2. Parsed Offer and Value Proposition
3. Audience and Funnel Hypothesis
4. Channel Recommendation with rationale
5. Launch Hand-off JSON payload

## Workflow
1. Validate URL and infer page type.
2. Extract offer, CTA, and conversion surface.
3. Map user intent to KPI priorities.
4. Draft initial funnel and channel hypothesis.
5. Emit structured launch brief.

## Decision Rules
- If URL is not reachable, request alternate URL and continue with available text.
- If checkout is present, prioritize conversion objective and remarketing.
- If product narrative is unclear, ask one focused clarification question.

## Platform Notes
Primary scope:
- Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, Shopify Ads, DSP/programmatic

Platform behavior guidance:
- Keep recommendations channel-aware; do not collapse all channels into one generic plan...