@sealmetrics/mcp 0.1.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +173 -0
- package/dist/client.d.ts +68 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +225 -0
- package/dist/client.js.map +1 -0
- package/dist/embedded.d.ts +29 -0
- package/dist/embedded.d.ts.map +1 -0
- package/dist/embedded.js +37 -0
- package/dist/embedded.js.map +1 -0
- package/dist/errors.d.ts +10 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +55 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.d.ts +1 -6
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +3809 -780
- package/dist/index.js.map +1 -0
- package/dist/resources/tracking-guide.d.ts +13 -0
- package/dist/resources/tracking-guide.d.ts.map +1 -0
- package/dist/resources/tracking-guide.js +479 -0
- package/dist/resources/tracking-guide.js.map +1 -0
- package/dist/sealmetrics.mcpb +0 -0
- package/dist/server.d.ts +38 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +132 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/alerts.d.ts +5 -0
- package/dist/tools/alerts.d.ts.map +1 -0
- package/dist/tools/alerts.js +80 -0
- package/dist/tools/alerts.js.map +1 -0
- package/dist/tools/audience.d.ts +7 -0
- package/dist/tools/audience.d.ts.map +1 -0
- package/dist/tools/audience.js +146 -0
- package/dist/tools/audience.js.map +1 -0
- package/dist/tools/bots.d.ts +4 -0
- package/dist/tools/bots.d.ts.map +1 -0
- package/dist/tools/bots.js +52 -0
- package/dist/tools/bots.js.map +1 -0
- package/dist/tools/channels.d.ts +5 -0
- package/dist/tools/channels.d.ts.map +1 -0
- package/dist/tools/channels.js +88 -0
- package/dist/tools/channels.js.map +1 -0
- package/dist/tools/content.d.ts +3 -0
- package/dist/tools/content.d.ts.map +1 -0
- package/dist/tools/content.js +47 -0
- package/dist/tools/content.js.map +1 -0
- package/dist/tools/conversions.d.ts +9 -0
- package/dist/tools/conversions.d.ts.map +1 -0
- package/dist/tools/conversions.js +427 -0
- package/dist/tools/conversions.js.map +1 -0
- package/dist/tools/funnel.d.ts +3 -0
- package/dist/tools/funnel.d.ts.map +1 -0
- package/dist/tools/funnel.js +27 -0
- package/dist/tools/funnel.js.map +1 -0
- package/dist/tools/index.d.ts +16 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +83 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/overview.d.ts +3 -0
- package/dist/tools/overview.d.ts.map +1 -0
- package/dist/tools/overview.js +26 -0
- package/dist/tools/overview.js.map +1 -0
- package/dist/tools/pages.d.ts +7 -0
- package/dist/tools/pages.d.ts.map +1 -0
- package/dist/tools/pages.js +307 -0
- package/dist/tools/pages.js.map +1 -0
- package/dist/tools/properties.d.ts +5 -0
- package/dist/tools/properties.d.ts.map +1 -0
- package/dist/tools/properties.js +107 -0
- package/dist/tools/properties.js.map +1 -0
- package/dist/tools/segments.d.ts +4 -0
- package/dist/tools/segments.d.ts.map +1 -0
- package/dist/tools/segments.js +49 -0
- package/dist/tools/segments.js.map +1 -0
- package/dist/tools/setup.d.ts +49 -0
- package/dist/tools/setup.d.ts.map +1 -0
- package/dist/tools/setup.js +347 -0
- package/dist/tools/setup.js.map +1 -0
- package/dist/tools/shared.d.ts +33 -0
- package/dist/tools/shared.d.ts.map +1 -0
- package/dist/tools/shared.js +40 -0
- package/dist/tools/shared.js.map +1 -0
- package/dist/tools/sites.d.ts +4 -0
- package/dist/tools/sites.d.ts.map +1 -0
- package/dist/tools/sites.js +36 -0
- package/dist/tools/sites.js.map +1 -0
- package/dist/tools/tracking.d.ts +3 -0
- package/dist/tools/tracking.d.ts.map +1 -0
- package/dist/tools/tracking.js +220 -0
- package/dist/tools/tracking.js.map +1 -0
- package/dist/tools/traffic.d.ts +10 -0
- package/dist/tools/traffic.d.ts.map +1 -0
- package/dist/tools/traffic.js +273 -0
- package/dist/tools/traffic.js.map +1 -0
- package/dist/tools/webhooks.d.ts +5 -0
- package/dist/tools/webhooks.d.ts.map +1 -0
- package/dist/tools/webhooks.js +101 -0
- package/dist/tools/webhooks.js.map +1 -0
- package/dist/types.d.ts +118 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +22 -0
- package/dist/types.js.map +1 -0
- package/package.json +44 -27
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/** API response envelope. */
|
|
2
|
+
export interface APIResponse<T> {
|
|
3
|
+
success: boolean;
|
|
4
|
+
data: T;
|
|
5
|
+
meta?: Record<string, unknown>;
|
|
6
|
+
timestamp: string;
|
|
7
|
+
}
|
|
8
|
+
/** Paginated API response. */
|
|
9
|
+
export interface PaginatedResponse<T> {
|
|
10
|
+
success: boolean;
|
|
11
|
+
data: T[];
|
|
12
|
+
total: number;
|
|
13
|
+
page: number;
|
|
14
|
+
page_size: number;
|
|
15
|
+
has_next: boolean;
|
|
16
|
+
has_prev: boolean;
|
|
17
|
+
comparison?: Record<string, unknown> | null;
|
|
18
|
+
totals?: Record<string, unknown> | null;
|
|
19
|
+
timestamp: string;
|
|
20
|
+
}
|
|
21
|
+
/** Site info returned by GET /sites. */
|
|
22
|
+
export interface SiteInfo {
|
|
23
|
+
id: string;
|
|
24
|
+
name: string;
|
|
25
|
+
domains: string[];
|
|
26
|
+
timezone: string;
|
|
27
|
+
currency: string;
|
|
28
|
+
is_active: boolean;
|
|
29
|
+
created_at: string;
|
|
30
|
+
}
|
|
31
|
+
export interface SiteListResponse {
|
|
32
|
+
sites: SiteInfo[];
|
|
33
|
+
total: number;
|
|
34
|
+
}
|
|
35
|
+
/** Date range in overview response. */
|
|
36
|
+
export interface DateRange {
|
|
37
|
+
start_date: string;
|
|
38
|
+
end_date: string;
|
|
39
|
+
days: number;
|
|
40
|
+
}
|
|
41
|
+
/** Traffic metrics. */
|
|
42
|
+
export interface TrafficMetrics {
|
|
43
|
+
entrances: number;
|
|
44
|
+
engaged_entrances: number;
|
|
45
|
+
page_views: number;
|
|
46
|
+
microconversions: number;
|
|
47
|
+
conversions: number;
|
|
48
|
+
revenue: string;
|
|
49
|
+
bounce_rate: number;
|
|
50
|
+
pages_per_session: number;
|
|
51
|
+
}
|
|
52
|
+
/** Conversion metrics. */
|
|
53
|
+
export interface ConversionMetrics {
|
|
54
|
+
conversions: number;
|
|
55
|
+
revenue: string;
|
|
56
|
+
microconversions: number;
|
|
57
|
+
conversion_rate: number;
|
|
58
|
+
average_order_value: string;
|
|
59
|
+
}
|
|
60
|
+
/** Time series point. */
|
|
61
|
+
export interface TimeSeriesPoint {
|
|
62
|
+
date: string;
|
|
63
|
+
hour?: number | null;
|
|
64
|
+
day_of_week?: number | null;
|
|
65
|
+
value: number;
|
|
66
|
+
}
|
|
67
|
+
/** Time series data. */
|
|
68
|
+
export interface TimeSeries {
|
|
69
|
+
metric: string;
|
|
70
|
+
points: TimeSeriesPoint[];
|
|
71
|
+
total: number;
|
|
72
|
+
average: number;
|
|
73
|
+
}
|
|
74
|
+
/** Overview response. */
|
|
75
|
+
export interface StatsOverview {
|
|
76
|
+
date_range: DateRange;
|
|
77
|
+
traffic: TrafficMetrics;
|
|
78
|
+
conversions: ConversionMetrics;
|
|
79
|
+
traffic_change?: TrafficMetrics | null;
|
|
80
|
+
conversions_change?: ConversionMetrics | null;
|
|
81
|
+
entrances_series?: TimeSeries;
|
|
82
|
+
engaged_entrances_series?: TimeSeries;
|
|
83
|
+
page_views_series?: TimeSeries;
|
|
84
|
+
conversions_series?: TimeSeries;
|
|
85
|
+
microconversions_series?: TimeSeries;
|
|
86
|
+
revenue_series?: TimeSeries;
|
|
87
|
+
}
|
|
88
|
+
/** Devices breakdown response. */
|
|
89
|
+
export interface DevicesBreakdown {
|
|
90
|
+
by_device: DeviceMetric[];
|
|
91
|
+
by_browser: DeviceMetric[];
|
|
92
|
+
by_os: DeviceMetric[];
|
|
93
|
+
}
|
|
94
|
+
export interface DeviceMetric {
|
|
95
|
+
name: string;
|
|
96
|
+
entrances: number;
|
|
97
|
+
engaged_entrances: number;
|
|
98
|
+
page_views: number;
|
|
99
|
+
conversions: number;
|
|
100
|
+
revenue: string;
|
|
101
|
+
bounce_rate: number;
|
|
102
|
+
}
|
|
103
|
+
/** Funnel response. */
|
|
104
|
+
export interface FunnelStep {
|
|
105
|
+
name: string;
|
|
106
|
+
count: number;
|
|
107
|
+
rate: number;
|
|
108
|
+
dropoff: number;
|
|
109
|
+
}
|
|
110
|
+
export interface FunnelReport {
|
|
111
|
+
steps: FunnelStep[];
|
|
112
|
+
total_entrances: number;
|
|
113
|
+
overall_conversion_rate: number;
|
|
114
|
+
}
|
|
115
|
+
/** Valid period values. */
|
|
116
|
+
export declare const VALID_PERIODS: readonly ["today", "yesterday", "7d", "30d", "90d", "12m", "this_week", "wtd", "last_week", "this_month", "mtd", "last_month", "this_quarter", "qtd", "last_quarter", "this_year", "ytd", "last_year"];
|
|
117
|
+
export type Period = (typeof VALID_PERIODS)[number];
|
|
118
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/** Valid period values. */
|
|
2
|
+
export const VALID_PERIODS = [
|
|
3
|
+
"today",
|
|
4
|
+
"yesterday",
|
|
5
|
+
"7d",
|
|
6
|
+
"30d",
|
|
7
|
+
"90d",
|
|
8
|
+
"12m",
|
|
9
|
+
"this_week",
|
|
10
|
+
"wtd",
|
|
11
|
+
"last_week",
|
|
12
|
+
"this_month",
|
|
13
|
+
"mtd",
|
|
14
|
+
"last_month",
|
|
15
|
+
"this_quarter",
|
|
16
|
+
"qtd",
|
|
17
|
+
"last_quarter",
|
|
18
|
+
"this_year",
|
|
19
|
+
"ytd",
|
|
20
|
+
"last_year",
|
|
21
|
+
];
|
|
22
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgIA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO;IACP,WAAW;IACX,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,WAAW;IACX,KAAK;IACL,WAAW;IACX,YAAY;IACZ,KAAK;IACL,YAAY;IACZ,cAAc;IACd,KAAK;IACL,cAAc;IACd,WAAW;IACX,KAAK;IACL,WAAW;CACH,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,43 +1,60 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sealmetrics/mcp",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "SealMetrics MCP
|
|
5
|
-
"
|
|
3
|
+
"version": "1.3.0",
|
|
4
|
+
"description": "SealMetrics analytics MCP server for Claude Code and Claude Desktop",
|
|
5
|
+
"author": "SealMetrics <dev@sealmetrics.com> (https://sealmetrics.com)",
|
|
6
|
+
"homepage": "https://github.com/adinton/sealmetrics2/tree/main/mcp-server#readme",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "https://github.com/adinton/sealmetrics2.git",
|
|
10
|
+
"directory": "mcp-server"
|
|
11
|
+
},
|
|
12
|
+
"bugs": {
|
|
13
|
+
"url": "https://github.com/adinton/sealmetrics2/issues"
|
|
14
|
+
},
|
|
6
15
|
"type": "module",
|
|
7
16
|
"bin": {
|
|
8
|
-
"sealmetrics-mcp": "dist/index.js"
|
|
17
|
+
"sealmetrics-mcp": "./dist/index.js"
|
|
18
|
+
},
|
|
19
|
+
"files": [
|
|
20
|
+
"dist"
|
|
21
|
+
],
|
|
22
|
+
"engines": {
|
|
23
|
+
"node": ">=18"
|
|
9
24
|
},
|
|
10
25
|
"scripts": {
|
|
11
26
|
"build": "tsc",
|
|
12
|
-
"dev": "
|
|
13
|
-
"
|
|
14
|
-
"
|
|
27
|
+
"dev": "tsx src/index.ts",
|
|
28
|
+
"test": "vitest run",
|
|
29
|
+
"test:watch": "vitest",
|
|
30
|
+
"typecheck": "tsc --noEmit",
|
|
31
|
+
"bundle": "node scripts/bundle.mjs",
|
|
32
|
+
"pack-mcpb": "node scripts/pack-mcpb.mjs",
|
|
33
|
+
"prepare": "npm run build && npm run bundle && chmod +x dist/index.js"
|
|
34
|
+
},
|
|
35
|
+
"dependencies": {
|
|
36
|
+
"@modelcontextprotocol/sdk": "^1.12.1",
|
|
37
|
+
"zod": "^3.25 || ^4.0"
|
|
38
|
+
},
|
|
39
|
+
"devDependencies": {
|
|
40
|
+
"@anthropic-ai/mcpb": "^1.0.0",
|
|
41
|
+
"@sealmetrics/setup-core": "file:../setup-core",
|
|
42
|
+
"@types/node": "^22.0.0",
|
|
43
|
+
"esbuild": "^0.24.0",
|
|
44
|
+
"msw": "^2.7.0",
|
|
45
|
+
"tsx": "^4.0.0",
|
|
46
|
+
"typescript": "^5.7.0",
|
|
47
|
+
"vitest": "4.1.5"
|
|
48
|
+
},
|
|
49
|
+
"overrides": {
|
|
50
|
+
"vite": "^7.3.2"
|
|
15
51
|
},
|
|
16
52
|
"keywords": [
|
|
17
53
|
"mcp",
|
|
18
54
|
"sealmetrics",
|
|
19
55
|
"analytics",
|
|
20
56
|
"claude",
|
|
21
|
-
"ai",
|
|
22
57
|
"model-context-protocol"
|
|
23
58
|
],
|
|
24
|
-
"
|
|
25
|
-
"license": "MIT",
|
|
26
|
-
"dependencies": {
|
|
27
|
-
"@modelcontextprotocol/sdk": "^1.0.0"
|
|
28
|
-
},
|
|
29
|
-
"devDependencies": {
|
|
30
|
-
"@types/node": "^20.0.0",
|
|
31
|
-
"typescript": "^5.0.0"
|
|
32
|
-
},
|
|
33
|
-
"engines": {
|
|
34
|
-
"node": ">=18.0.0"
|
|
35
|
-
},
|
|
36
|
-
"files": [
|
|
37
|
-
"dist"
|
|
38
|
-
],
|
|
39
|
-
"repository": {
|
|
40
|
-
"type": "git",
|
|
41
|
-
"url": "https://github.com/sealmetrics/mcp-server"
|
|
42
|
-
}
|
|
59
|
+
"license": "MIT"
|
|
43
60
|
}
|