Volatility Heatmap

What it does

Builds a keyword-by-brand volatility matrix to highlight unstable zones.

Why this is insightful

Instead of one global volatility number, you see exactly where instability is concentrated.

Required API fields

• createdAt
• query.keyword
• rankings.brands[].name
• rankings.brands[].rank

How to use

1. Build time series per keyword+brand.
2. Compute volatility factors.
3. Score 0-100 and render matrix.

Expected output

• volatility_heatmap[keyword][brand]
• top unstable pairs
• stability summary

Copy-ready skill prompt

Use this as a full copy/paste prompt in your AI tool:

Skill: Volatility Heatmap
Goal: Run this analysis on FullMention data only.
Data policy:
- Do one controlled ingestion pull from FullMention API.
- Store dataset locally (file/local DB) and analyze offline.
- No repeated API fetch loops during analysis.
Execution contract:
- Provide ingestion_plan, max_api_calls, cache_key, dataset_timestamp, analysis_mode=offline_only.
Required fields:
- Use the required API fields listed on this page.
Output requirements:
- Return summary, key metrics, and evidence_map with source_field_paths and sample_result_ids.
- Include limitations and confidence score rationale.