Seal Copilot

Get traffic broken down by device type (desktop/mobile/tablet), browser (Chrome, Safari, Firefox...), and operating system (Windows, macOS, iOS, Android...). Returns all three breakdowns in a single call.

Read one page of the official SealMetrics documentation as plain text, fetched live from docs.sealmetrics.com. Pass the `path` returned by search_docs (e.g. 'getting-started/quick-start') or a full docs.sealmetrics.com URL.

Get funnel analysis showing conversion rates between steps. Returns step-by-step data including visitor count, conversion rate, and dropoff at each stage. Useful for finding where users drop off in multi-step flows.

Get landing page performance: entrances, bounce rate, conversions. Landing pages are the first page users see when entering the site. High bounce rates indicate poor landing page experience. Supports multi-value filters (country, device_type, browser, os, channel_group, UTMs) as arrays of strings — e.g. country=['ES','PT'] to filter to two countries. Pass include=['channel_group'] to also break down by channel group. The two are orthogonal — combine them as needed.

Get landing page metrics grouped by content grouping. Shows aggregate performance per content group (e.g. blog, product, category).

Call this FIRST whenever the user asks for a marketing report, a weekly/monthly/quarterly performance summary, a channel or campaign analysis, conversion or acquisition insights, or "how is my marketing doing / why are my sales down / where should I invest". It returns the STEP-BY-STEP METHOD (a playbook) to analyze SealMetrics marketing performance — not the data itself. After reading it, follow the steps by calling the read-only data tools (get_overview, get_channels, get_traffic_sources, get_conversions, get_landing_pages, …) to fetch the real numbers and produce the report. Diagnose marketing performance for a SealMetrics site and explain *why* the numbers move. Generalist marketing analysis (acquisition, channels, landing pages, conversions, traffic quality) with strong bias toward causal explanation and concrete next actions for Founders, CEOs and CMOs.

Get detailed breakdown for a specific microconversion type. Shows metrics segmented by source, medium, campaign, country, device, browser, and OS.

Get microconversions (smaller engagement events) broken down by type: add_to_cart, newsletter_signup, pdf_download, etc. Shows count and trends per event type. **For per-event detail use `get_microconversions_raw`.**

Returns raw microconversion rows from /stats/microconversions/raw (one row per event, with timestamp_utc and timestamp_local). Use for one-row-per-event detail of microconversions (add_to_cart, newsletter_signup, etc.). Custom `properties` are excluded by default — pass `include_properties=true` to receive them. Date range capped at 31 days; page_size capped at 100 to control token usage.

Get traffic broken down by operating system: Windows, macOS, iOS, Android, Linux, etc. Shows entrances and pageviews per OS with pagination.

Get dashboard KPIs: pageviews, entrances, bounce rate, conversions, revenue. Includes time series data and optional period-over-period comparison. This is the best starting point for understanding a site's performance.

Get metrics per page URL path: pageviews and entrances. Useful for finding most popular pages and content performance. For bounce rate by entry page, use get_landing_pages instead — bounce is not interpretable at page granularity. Supports multi-value filters (country, device_type, browser, os, channel_group, UTMs) as arrays of strings — e.g. device_type=['mobile'] to filter to mobile only. Pass include=['device'] to also break down metrics by device. The two are orthogonal — combine them as needed.

Get a complete property breakdown with pivot-table style data. Shows all values for a property key with their counts and revenue — ideal for analyzing product or category performance.

Get property values with counts, grouped by a UTM parameter. Paginated. Use to see which values a specific property key has and how they distribute across traffic sources.

Get detailed information about a specific site: name, domains, timezone, configuration, and tracking status. Use list_sites first to find available site IDs.

Get traffic and conversions broken down by UTM term (keyword). Shows which search keywords or ad terms drive the most traffic. Supports filtering by source, medium, and campaign.

Get top campaigns ranked by entrances. Returns a compact list of the top N campaigns (utm_campaign) — ideal for quick rankings.

Get top channels ranked by entrances. Returns a compact list of the top N channels (Paid Search, Organic, Social, etc.) — ideal for quick rankings.

Get top landing pages ranked by entrances. Returns a compact list of the top N landing pages — ideal for quick rankings.

Get top pages ranked by page views. Returns a compact list of the top N pages — ideal for quick rankings and summaries.

Get top referrer domains ranked by entrances. Shows which external sites send the most traffic.

Get top traffic sources ranked by entrances. Returns a compact list of the top N sources (utm_source) without pagination — ideal for quick rankings and summaries.

Get top UTM terms (keywords) ranked by entrances. Returns a compact list of the top N terms — ideal for quick keyword rankings.

Get the tracking pixel code for a site and the full JavaScript API reference for implementing pageviews, conversions, microconversions, and content grouping. Returns the site-specific <script> tag plus implementation guide with examples for e-commerce, SaaS, blog, and React/Next.js.

Get traffic broken down by medium (utm_medium): organic, cpc, email, referral, social, etc. Useful for understanding which marketing channels drive traffic.

Get traffic broken down by source (utm_source): google, facebook, twitter, direct, etc. Shows entrances, pageviews, conversions, and revenue per source.

Call this FIRST whenever the user reports a SealMetrics problem or asks a setup/data question: console errors ("sealmetrics is not defined"), missing conversions or microconversions, tags fired from Google Tag Manager before the tracker loads, duplicate or inflated pageviews (SPAs, virtual pageviews), content grouping doubts, channel rules that never match / traffic stuck in Unassigned, payment-gateway referrer questions, or numbers that don't match another analytics tool (GA4, e-commerce platform). It returns the validated symptom→cause→fix guide; find the matching symptom, apply its answer, and use the verification tools it lists to confirm with the user's real data. Validated symptom→cause→fix answers for the most common SealMetrics setup and data questions - tags firing before the tracker loads, lost conversions/microconversions, duplicate pageviews in SPAs or Tag Manager setups, channel rules that never match (traffic stuck in Unassigned), payment-gateway and login/SSO domains showing up as traffic sources, numbers that do not match another analytics tool, and live browser checks of whether the tag actually loads on a page.

List channel group rules configured for a site. Shows how traffic is classified into channels (Paid Search, Organic, Social, etc.) based on UTM parameters and referrer patterns.

Get the list of available microconversion type names for a site. Use this to discover what microconversion types exist before querying details.

Get the list of available custom property keys from conversions and/or microconversions. Use this to discover what property keys exist before querying values or breakdowns.

List all sites (web properties) accessible with your API key. Returns site IDs, names, and domains. Use this to find the site_id needed for other tools.

Search the available SealMetrics analytics reports for the connected site. Returns report references; pass a result id to `fetch` to get the data. Mention a time range in the query (e.g. 'last 7 days') to scope the reports.

Search the official SealMetrics documentation (docs.sealmetrics.com), fetched LIVE so it is never stale. Use it when the user asks how a SealMetrics feature works or how to set something up: tracker installation (WordPress, WooCommerce, Shopify, Magento, PrestaShop, Google Tag Manager, React/Next.js/Vue SPAs), conversion and microconversion tracking, UTM/campaign tagging, reports and metrics definitions, API usage, account settings, or privacy/GDPR/consentless questions. Returns matching pages (title, path, description); then call get_doc with a result's path to read the full page. For problem symptoms (errors, numbers that don't match, tags not firing) call get_troubleshooting_guide FIRST — this tool is for reference/how-to content.

Classify a source/medium/campaign combination exactly like the tracking pixel would (same RE2 semantics, lowercase matching, custom rules before defaults). Returns the resulting channel and the rule that matched. Set include_inactive=true to also evaluate draft (not live) custom rules — use it to verify a draft before a human publishes it in the dashboard.