skills.rest
Heatmap-com-Inc
Heatmap-com-IncOFFICIAL
Explore all skills by this author →
GitHub

heatmap-data-model

Maps Heatmap MCP tools and GraphQL filters into executable analytics query recipes.

Updated May 6, 2026
Search Tags:#analytics#graphql#mcp#funnel analysis#cro#heatmap#revenue per session
One-click install
npx skills add https://github.com/Heatmap-com-Inc/heatmap-claude-skills --skill heatmap-data-model-heatmap-com-inc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: heatmap-data-model
Source: https://github.com/Heatmap-com-Inc/heatmap-claude-skills/tree/main/skills/heatmap-data-model
Command: npx skills add https://github.com/Heatmap-com-Inc/heatmap-claude-skills --skill heatmap-data-model-heatmap-com-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analysts using the Heatmap MCP often don't know which of the 13 tools to call, what arguments each accepts, or how to interpret raw JSON-string responses, so analytical questions never become executed queries. ## Core Features & Use Cases - Complete tool reference: Documents all 13 MCP tools with required and optional arguments, output shapes, and the SharedAnalyticsFilterInput filter set. - Seven canonical recipes: Ready-to-run query patterns for page-level RPS ranking, element-level RPC audits, quadrant segmentation, funnel drop-off diagnosis, journey continuation, click-to-revenue heatmap drills, and split-test validation. - Metrics dictionary and gotchas: Maps book terms (RPS, RPC, AOV, CR) to exact API fields and flags pitfalls like unparsed JSON-string fields and derived RPC. - Use Case: Ask "which pages drive the most revenue per session" and get a concrete get_pageview_analytics call with correct metrics, sorting, and interpretation rules. ## Quick Start Ask the assistant to pull your page-by-page revenue per session ranking for the last 28 days using the Heatmap MCP.

Frequently Asked Questions about heatmap-data-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Heatmap analytics data with the MCP tools?▼

Bootstrap by calling viewer_access, then list_sites, then get_site_pages to learn valid site and page IDs. After that, call tools like get_pageview_analytics or get_session_analytics with a site_id, date_range, and optional filters.

How do I calculate revenue per click for page elements?▼

Revenue per click is not a native API field; compute it from get_raw_event_analytics rows as revenue divided by value, where value is the click count. Elements with many clicks and near-zero revenue are Conversion Killers.

Can I segment Heatmap data by new versus returning users and device?▼

Yes, SharedAnalyticsFilterInput supports new_user, returning_user, and device fields as server-side filters on most tools. Run one call per quadrant combination rather than aggregating sitewide data and segmenting client-side.

Why does get_pageview_analytics return unusable table_rows data?▼

The table_rows, series_rows, and totals fields are returned as raw JSON strings, not parsed objects. Call JSON.parse on them before iterating, otherwise iteration silently fails or throws a type error.

What funnel events does the Heatmap funnel tool support?▼

get_funnels accepts only the FunnelEventName enum values: CART_VIEWED, CHECKOUT_STARTED, ADD_TO_CART, HOMEPAGE_VIEWED, PRODUCT_VIEWED, CHECKOUT_COMPLETED, and COLLECTION_VIEWED. Other steps must use PAGE_VIEW type with a page filter.

Related Skills

Explore More Data & Analytics Skills→
x-cmdx-cmd
4.6k

x-tping

Test TCP port connectivity and visualize results with heatmaps and bar charts.

Official
Basic
stefan-georgistefan-georgi
13

funnel-audit

Audit DTC sales funnels for conversion leaks and output a prioritized Fix Priority Matrix.

Community
Advanced
assimovtassimovt
54

metrics-framework

Define product metrics with a North Star, input/output tree, and counter-metrics.

Community
Intermediate
nathanvalenathanvale

last-30-days

Research engagement-ranked discussions across Reddit, X, and the web.

Community
Advanced