Skip to content
TakoAPI
Back to skills

posthog-query

by quinlanjager

Marketing & Sales
—Not yet rated
Your rating

Brief

Run SQL queries against PostHog product analytics data using the PostHog CLI.

Description

What This Skill Does

Runs HogQL (ClickHouse-compatible SQL) queries against PostHog product analytics data via the CLI. Returns results as JSON lines to stdout. Supports filtering by event type, URL, timestamp, and any stored event properties.

Queries analytics data from the terminal without opening the PostHog dashboard, making it straightforward to pipe results into scripts or agents.

When to Use It

  • Count pageviews for a specific URL over the past week
  • Check which browsers users are on for a given event
  • Pull the 10 most recent events from your PostHog project
  • Track daily signups or feature-click trends over a date range
  • Audit event volume around a product change or deploy

Example Workflow

INPUT

User asks: How many pageviews did we get per day over the last 7 days?

AGENT
  1. 1

    Authenticate with PostHog using posthog-cli login

  2. 2

    Construct a HogQL query grouping pageview events by date over the last 7 days

  3. 3

    Run the query with posthog-cli exp query run

  4. 4

    Parse the JSON lines output and format the daily counts

OUTPUT

A list of dates with corresponding pageview counts, e.g. {"date": "2026-03-11", "pageviews": 4821}

Requirements

  • PostHog account
  • PostHog API key with query:read scope
  • posthog-cli installed globally via npm install -g posthog-cli

Installation

clawhub install quinlanjager/posthog-query

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links