Website analytics

See where people go

analytics_paths · Reads only · Markdown

Where visits went after a page and where they came from, or the commonest journeys through the site.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Where do people go after the Tabor page, and where did they come from?

Your agent callsanalytics_pathsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "site": "halversoncycle.example",
  "page": "/bikes/tabor",
  "period": "30d"
}
What comes back
{
  "site": "halversoncycle.example",
  "period": {
    "from": "2026-09-15",
    "to": "2026-10-14"
  },
  "page": "/bikes/tabor",
  "views": 3,
  "next": [
    {
      "page": "/cart",
      "views": 2,
      "percent": 66.7
    },
    {
      "page": "/bikes/willamette-8",
      "views": 1,
      "percent": 33.3
    }
  ],
  "previous": [
    {
      "page": "/",
      "views": 2,
      "percent": 66.7
    },
    {
      "page": "(came from outside)",
      "views": 1,
      "percent": 33.3
    }
  ]
}

Use it when

Someone asks what people do after (or before) a page, or how visitors move through the site.

What it does

With a page: where visits went next (or left the site) and where they were before it. Without one: the commonest journeys, the first four pages of visits.

What comes back

With a page: how many views it had and the pages visits went to next or came from before, each with its share. Without one: the commonest journeys over the first four pages of a visit. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
siteRequiredstringThe site's domain (e.g. halversoncycle.example) or its site_id. 4 to 253 characters.
pagestringLike /pricing; * for any part. Up to 500 characters.
periodstringOne of: today,yesterday,7d,30d,90d,month,last_month,12mo,custom. Default: 30d.
fromstringWith period custom: the first day, 2026-10-01. Up to 10 characters.
tostringWith period custom: the last day. Up to 10 characters.
filtersobjectNarrow the stats: page and entry_page ("/blog/*", * for any part), goal (a goal's name), event, channel (Direct, Organic search, Paid search, Organic social, Paid social, AI assistants, Email, Referral, Affiliates, Display, Paid other, Other campaigns), source ("Google", "Direct"), referrer, campaign, medium, term, content, country ("DE"), device (desktop, tablet, mobile), browser, os. Example: {"channel": "Organic search", "device": "mobile"}.
limitinteger1 to 50. Default: 10.

The call

Over MCP, call analytics_paths on https://api.conecto.chat/mcp/analytics. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/analytics_paths \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"site":"halversoncycle.example","page":"/bikes/tabor","period":"30d"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No site the business counts has that domain or site_id.Call analytics_list_sites and use a domain from it.
invalid_input400The period, the from and to dates, a page pattern or a filter is not valid.Fix the argument the message names. A custom period needs from and to as dates, like 2026-10-01.
rate_limited429The business ran more analytics reports this minute than its limit allows.Wait a minute, then call again.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md