Docs
Find the agents in your traffic.
Install in a few minutes, read the reports, and ask your own AI tools about it.
Ask the docs
Answers come from these docs only, written by Claude (Anthropic). Your question is sent to answer it, and isn't stored.
Start
Install
- Next.jsInstall the Next.js package: a three-line proxy file and one environment variable.
- Vercel (not Next.js)One middleware file for static, Vite or Astro sites on Vercel: every request, including agents that never run JavaScript.
- Cloudflare WorkerPut a Cloudflare Worker in front of Webflow, Framer, Shopify, WordPress or any site.
- Google Tag ManagerInstall with a Tag Manager template, and send your GA4 events to Punchline by the same names.
- Browser snippetOne line of HTML for Squarespace, Wix and other hosted builders.
Use
- ReportsOverview, realtime, acquisition, pages and audience, what each number means, and how they differ from GA4.
- Agent contentWhat agents read, whether they got it, whether assistants sent people, and what to try.
- AccountsAgent intent for sales: which companies' agents researched you, what they read, and how to send it to your CRM.
- Handoff linksConnect a cloud agent's cart, quote or configuration to the person who opens it, and to what they do next.
- Serve agents markdownHand AI assistants a markdown version of the same page from your edge install. Same facts, different format.
- Events and goalsTrack events from the page, your servers or no-code triggers, and see conversions for people vs agents.
- URL parametersKeep referral codes and ad click IDs (by presence) without collecting personal data; set channel and partner with rules.
- Ask PunchlineAsk about your site in plain words; every answer shows the queries behind it.
- AlertsDaily digests by email or Slack: thresholds, changes from the usual, and new agent operators.
- Plans and billingWhat each plan includes, what counts as a page view, upgrading, limits, and what happens when a plan doesn't include something.
- Your teamInvite people as viewers, admins or owners; what each role can do; how invite links work.
Integrations
- All integrationsEverything Punchline connects to: installs, GA4, CRMs, ad platforms, warehouses, webhooks, Slack and AI assistants.
- Compare with GA4How Google Analytics' numbers compare with Punchline's, and why they differ.
- HubSpot and SalesforceBring deals and opportunities in to see the revenue behind agent research, and write account signals back.
- Ad conversion uploadsOpt in to send people's conversions to Google Ads and Meta, with click IDs kept apart and deleted after up to 90 days.
- BigQuery and SnowflakeFour tables written to your warehouse every day: setup, schedule, columns and example queries.
- WebhooksThe daily alert digest as signed JSON: payload, signature verification in Node.js and Python, and CRM recipes.
API
- API overviewYour first request, the query model, every endpoint at a glance, exports and managing your site.
- Keys and authenticationCreate keys, scopes, one key per site, rotation, and signing in from AI assistants.
- Query cookbookReady-made query bodies for common questions: agent share, AI companies, assistants, conversions, campaigns.
- Limits and conventionsDates, pagination, rate limits, idempotency, sizes, data freshness, privacy thresholds and versioning.
- TypeScript SDKA typed client generated from the OpenAPI spec: setup, examples, errors and every method.
- Connect your AI assistantUse Punchline from Claude, ChatGPT, Cursor and other MCP clients.
- MCP tools referenceEvery MCP tool and its arguments, generated from the server's own definitions.
- API referenceEvery endpoint, parameter and error code, generated from the OpenAPI spec.
Reference
About
For agents: every page is also plain markdown (add .md to its URL), and /llms-full.txt has all of them in one file.