Report tools
Branded, expiring report links you can share with a client.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools11 tools
marketing_overview
Read3 creditsOne-call funnel across connected sources: paid (spend, clicks, orders, revenue, ROAS per ad platform from the campaign ledger), organic (Search Console top queries) and site (GA4 sessions, users, conversions). Read only; unconnected sources stay empty.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
site_urlOptional | string | Search Console property; default the selected one |
marketing_insights
Read3 creditsPrioritised, actionable opportunities across connected sources: wasted ad search terms (Google, Microsoft), page-two Search Console queries, low-CTR pages, GA4 landing pages with traffic but no conversions, live campaigns spending without results — each with the tool to act on it. Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (7–90) | — |
portfolio_report
Read2 creditsAgency view: every connected ad account (one per platform) with spend, clicks, orders, revenue, ROAS and CPA, a grand total and the underperforming campaigns (spending with no orders or ROAS below 1). Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
client_report
Read2 creditsClient-ready period report: KPIs (spend, clicks, impressions, orders, revenue, CTR, CPA, ROAS) with % change versus the previous period of the same length, channel breakdown and top campaigns. Read only; for a shareable link use create_shareable_report.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
brand_idOptional | string | only this brand's campaigns |
brand_nameOptional | string | name to head the report; default the brand's name |
instant_audit
Read3 creditsQuick audit of the connected Google Ads / Microsoft Advertising account: money spent on search terms with no conversions, impressions lost to rank, missing conversion tracking — each finding with the tool to fix it. Read live; nothing is invented.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (7–90) | — |
analytics_list_sites
Read0 creditsTecrübe Analytics (first-party, cookieless web analytics — not GA4): the sites this account measures with their tracking snippet, status, whether data is arriving, goals, and this month's usage against the plan (events, sites, retention, session replay). Read only and free.
This tool takes no parameters.
analytics_summary
Read0 creditsTecrübe Analytics summary of a site for a period: sessions (visits), unique visitors, pageviews, bounce rate, average session duration, conversions and conversion rate, revenue, the previous period for comparison, goal results, top sources and pages, and visitors in the last 30 minutes. Use it for 'how is my site doing', traffic and conversion questions. Read only and free.
| Parameter | Type | Description |
|---|---|---|
siteOptional | string | site id or domain (optional when the account measures a single site) |
daysOptional | integer (1–731) | last N days including today (default 30) |
startOptional | string | YYYY-MM-DD (use with end instead of days) |
endOptional | string | YYYY-MM-DD |
include_dailyOptional | boolean | add the daily series (up to 92 days) |
analytics_breakdown
Read0 creditsTecrübe Analytics table for one dimension: sources (referring domains), campaigns (UTM source / medium / campaign, matched to ad campaign spend and cost per conversion when names match), pages, landing_pages, countries, devices, browsers, os, events or goals — with visitors, sessions, pageviews, conversions, revenue, bounce rate and average duration per row. Read only and free.
| Parameter | Type | Description |
|---|---|---|
siteOptional | string | site id or domain (optional when the account measures a single site) |
daysOptional | integer (1–731) | last N days including today (default 30) |
startOptional | string | YYYY-MM-DD (use with end instead of days) |
endOptional | string | YYYY-MM-DD |
dimensionRequired | sources | campaigns | pages | landing_pages | countries | devices | browsers | os | events | goals | — |
limitOptional | integer (1–50) | — |
analytics_realtime
Read0 creditsTecrübe Analytics right now: visitors, pageviews and events in the last 30 minutes (and visitors in the last 5), with the top pages, sources and countries. Read only and free.
| Parameter | Type | Description |
|---|---|---|
siteOptional | string | site id or domain (optional when the account measures a single site) |
analytics_funnel
Read0 creditsTecrübe Analytics conversion funnel: how many sessions reached each of 2–5 ordered steps (a page path such as /cart — a trailing * matches a prefix — or an event name such as purchase), with the rate from the first and from the previous step. At most 92 days. Read only and free.
| Parameter | Type | Description |
|---|---|---|
siteOptional | string | site id or domain (optional when the account measures a single site) |
daysOptional | integer (1–731) | last N days including today (default 30) |
startOptional | string | YYYY-MM-DD (use with end instead of days) |
endOptional | string | YYYY-MM-DD |
stepsRequired | array<object> | — |
web_push_overview
Read0 creditsWeb push of a measured site: whether push is enabled and set up, active / unsubscribed / invalid subscriber counts against the plan limit, this month's notification quota, and the last campaigns with delivered, shown and click numbers. Subscriber addresses are never returned. Read only and free.
| Parameter | Type | Description |
|---|---|---|
siteOptional | string | site id or domain (optional when the account measures a single site) |
Write tools1 tools
create_shareable_report
Write2 creditsCreate a white-label, read-only, expiring link to the period report (spend, orders, revenue, CPA, ROAS, channel breakdown, daily orders, site summary) headed by the brand's own name and logo instead of Tecrübe — for sending to a client. Needs the reporting.whitelabel plan right; otherwise returns an error and charges no credits.
| Parameter | Type | Description |
|---|---|---|
periodOptional | week | month | last 7 or 30 days (default week) |
channelsOptional | array<string> | only these channels, e.g. ['google','meta']; default all |
brand_idOptional | string | brand whose name/logo heads the report; default the main brand |
expires_in_daysOptional | integer (1–90) | default 30 |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.