ai-tracker-mcp 1.0.0

package/README.md

@@ -0,0 +1,41 @@
+# AI Tracker MCP server
+
+Pull your AI-visit analytics from [AI Tracker](https://ai-tracker-weld.vercel.app) into Claude
+(Desktop or Code) and any MCP client.
+
+## Tools
+- `list_sites` — your tracked sites
+- `get_summary(site_id, days?)` — metrics + change vs previous period
+- `get_top_pages(site_id, days?, limit?)` — pages with the most AI visits
+- `get_platforms(site_id, days?)` — which AIs visited (ChatGPT, Claude, Perplexity, …)
+- `get_timeseries(site_id, days?, bucket?)` — trend data
+- `get_recent_hits(site_id, limit?)` — raw hit log
+
+## Setup
+
+1. In AI Tracker → **Account → API & MCP access**, generate a token.
+2. Add to your MCP config (Claude Desktop: `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "ai-tracker": {
+      "command": "npx",
+      "args": ["-y", "ai-tracker-mcp"],
+      "env": {
+        "AITRACKER_API_URL": "https://ai-tracker-weld.vercel.app",
+        "AITRACKER_TOKEN": "aitk_your_token_here"
+      }
+    }
+  }
+}
+```
+
+3. Restart Claude. Ask: *"Which pages on my site are getting the most AI visits this month?"*
+
+## Run locally
+```bash
+cd mcp-server
+npm install
+AITRACKER_API_URL=https://ai-tracker-weld.vercel.app AITRACKER_TOKEN=aitk_... node index.mjs
+```

package/index.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * AI Tracker MCP server.
+ * Exposes your AI-visit analytics as MCP tools for Claude and any MCP client.
+ *
+ * Env:
+ *   AITRACKER_API_URL  e.g. https://ai-tracker-weld.vercel.app
+ *   AITRACKER_TOKEN    an API token from Account → API & MCP access
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const BASE = (process.env.AITRACKER_API_URL || "").replace(/\/$/, "");
+const TOKEN = process.env.AITRACKER_TOKEN || "";
+
+if (!BASE || !TOKEN) {
+  console.error("AI Tracker MCP: set AITRACKER_API_URL and AITRACKER_TOKEN env vars.");
+  process.exit(1);
+}
+
+async function api(path) {
+  const res = await fetch(`${BASE}/api/v1${path}`, {
+    headers: { Authorization: `Bearer ${TOKEN}` },
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`AI Tracker API ${res.status}: ${body}`);
+  }
+  return res.json();
+}
+
+const ok = (data) => ({ content: [{ type: "text", text: JSON.stringify(data, null, 2) }] });
+
+const server = new McpServer({ name: "ai-tracker", version: "1.0.0" });
+
+server.tool(
+  "list_sites",
+  "List all websites tracked in this AI Tracker account (id, name, domain, platform).",
+  {},
+  async () => ok(await api("/sites"))
+);
+
+server.tool(
+  "get_summary",
+  "Get headline AI-visit metrics for a site over the last N days, with change vs the previous period. AI counts are IP-VERIFIED only (total, live user fetches, AI search crawls, training scrapes). Also returns `unverified` (claimed an AI user-agent but the source IP could not be confirmed) and `traditional_search_crawls` (Googlebot — a readability proxy, NOT counted as an AI visit).",
+  { site_id: z.string(), days: z.number().optional() },
+  async ({ site_id, days = 28 }) => ok(await api(`/sites/${site_id}/summary?days=${days}`))
+);
+
+server.tool(
+  "get_top_pages",
+  "Get the pages on a site receiving the most AI visits over the last N days (with share %).",
+  { site_id: z.string(), days: z.number().optional(), limit: z.number().optional() },
+  async ({ site_id, days = 28, limit = 25 }) =>
+    ok(await api(`/sites/${site_id}/breakdown?dim=path&days=${days}&limit=${limit}`))
+);
+
+server.tool(
+  "get_platforms",
+  "Get the breakdown of which AI platforms (ChatGPT, Claude, Perplexity, etc.) visited a site over the last N days.",
+  { site_id: z.string(), days: z.number().optional() },
+  async ({ site_id, days = 28 }) =>
+    ok(await api(`/sites/${site_id}/breakdown?dim=platform&days=${days}`))
+);
+
+server.tool(
+  "get_timeseries",
+  "Get the verified AI-visit time series for a site (per day or per hour) for charting trends. Each point also carries `traditional_search_crawls` (Googlebot — not an AI visit).",
+  { site_id: z.string(), days: z.number().optional(), bucket: z.enum(["day", "hour"]).optional() },
+  async ({ site_id, days = 28, bucket = "day" }) =>
+    ok(await api(`/sites/${site_id}/timeseries?days=${days}&bucket=${bucket}`))
+);
+
+server.tool(
+  "get_recent_hits",
+  "Get the most recent raw AI-visit log entries for a site (time, platform, bot, type, URL, IP, country, `verified` flag, referrer, HTTP status).",
+  { site_id: z.string(), limit: z.number().optional() },
+  async ({ site_id, limit = 100 }) =>
+    ok(await api(`/sites/${site_id}/hits?limit=${limit}`))
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("AI Tracker MCP server running.");

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "ai-tracker-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for AI Tracker — pull your AI-visit analytics into Claude and any MCP client.",
+  "type": "module",
+  "bin": {
+    "ai-tracker-mcp": "index.mjs"
+  },
+  "files": ["index.mjs", "README.md"],
+  "engines": { "node": ">=18" },
+  "keywords": ["mcp", "model-context-protocol", "ai-tracker", "analytics", "claude", "ai-crawlers", "gptbot", "claudebot"],
+  "homepage": "https://ai-tracker-weld.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/builtbyish/ai-tracker.git",
+    "directory": "mcp-server"
+  },
+  "author": "Built By Ish",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  }
+}