clickmax-sales-insights

As tools abaixo aparecem com os nomes que o MCP da Clickmax registra. Se o seu cliente de IA prefixar nomes de tool (mcp__<servidor>__, mcp_<servidor>_, ou outro), use o nome já prefixado que aparecer na sua lista de tools.

When this applies

Use this skill for ready-made sales insights that need aggregation across many transactions: ranking the best-selling offers/products by revenue and quantity in a window, the attach rate of order bumps, and period-over-period sales movement (revenue, average ticket, sales count with the delta versus the previous comparable window). These answers require server-side aggregation — prefer the insight operations here over paging raw sales rows and re-summing them by hand.

Not this skill:

• headline KPIs, filter discovery, paginated my-sales/transactions browsing, or the recoverable-revenue reading -> clickmax-payments-dashboard-analysis
• why sales are failing, grouped by reason with the recoverable value per reason -> clickmax-failure-diagnosis
• customer subscription lifecycle mutation -> clickmax-seller-subscriptions

Key assumptions

• All three insights read realized (paid) sales only, in a default 30-day window when the user gives no explicit period.
• insights_top_offers groups by offer by default; pass a product grouping when the user asks about products rather than individual offers. revenue uses the same sales-value expression as the dashboard, so it reconciles with the my-sales revenue for the same period.
• insights_order_bump_attach reports attach rate as paid orders that included the bump divided by paid orders of the main offer the bump is attached to — one row per (bump, main offer) pair. It is a rate over eligible orders, not a share of revenue; for the revenue share of bumps use the dashboard skill instead.
• insights_trend compares the current window against the immediately preceding window of the same length. It does not cover conversion rate (traffic is not part of the sales domain) — answer revenue, average ticket, and sales count only, and say conversion is out of scope if asked.