@pofky/asc-mcp 1.0.1 → 1.1.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/dist/index.js +14 -0
- package/dist/index.js.map +1 -1
- package/dist/tools/competitor-snapshot.d.ts +24 -0
- package/dist/tools/competitor-snapshot.d.ts.map +1 -0
- package/dist/tools/competitor-snapshot.js +118 -0
- package/dist/tools/competitor-snapshot.js.map +1 -0
- package/dist/tools/keyword-insights.d.ts +25 -0
- package/dist/tools/keyword-insights.d.ts.map +1 -0
- package/dist/tools/keyword-insights.js +140 -0
- package/dist/tools/keyword-insights.js.map +1 -0
- package/dist/tools/metadata-diff.d.ts +20 -0
- package/dist/tools/metadata-diff.d.ts.map +1 -0
- package/dist/tools/metadata-diff.js +168 -0
- package/dist/tools/metadata-diff.js.map +1 -0
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -14,6 +14,9 @@ const sales_report_js_1 = require("./tools/sales-report.js");
|
|
|
14
14
|
const release_preflight_js_1 = require("./tools/release-preflight.js");
|
|
15
15
|
const daily_briefing_js_1 = require("./tools/daily-briefing.js");
|
|
16
16
|
const release_notes_js_1 = require("./tools/release-notes.js");
|
|
17
|
+
const keyword_insights_js_1 = require("./tools/keyword-insights.js");
|
|
18
|
+
const competitor_snapshot_js_1 = require("./tools/competitor-snapshot.js");
|
|
19
|
+
const metadata_diff_js_1 = require("./tools/metadata-diff.js");
|
|
17
20
|
function getConfig() {
|
|
18
21
|
const keyId = process.env.ASC_KEY_ID;
|
|
19
22
|
const issuerId = process.env.ASC_ISSUER_ID;
|
|
@@ -87,6 +90,17 @@ async function main() {
|
|
|
87
90
|
since_tag: zod_1.z.string().optional().describe("Git tag to diff from (default: latest tag)"),
|
|
88
91
|
max_commits: zod_1.z.number().optional().describe("Max commits to include (default 50)"),
|
|
89
92
|
}, safe((args) => (0, release_notes_js_1.releaseNotes)(args, tier)));
|
|
93
|
+
server.tool("keyword_insights", "Analyze your app's keywords against search competition. Shows difficulty, competing apps, and budget usage. Uses iTunes Search API.", {
|
|
94
|
+
app_id: zod_1.z.string().regex(/^\d+$/, "App ID must be numeric").describe("App Store Connect app ID"),
|
|
95
|
+
extra_keywords: zod_1.z.string().optional().describe("Extra comma-separated keywords to analyze beyond current metadata"),
|
|
96
|
+
}, safe((args) => (0, keyword_insights_js_1.keywordInsights)(client, args, tier)));
|
|
97
|
+
server.tool("competitor_snapshot", "Look up any app on the App Store: ratings, reviews, version, price, category, release notes. Search by name or App Store ID.", {
|
|
98
|
+
query: zod_1.z.string().describe('App name (e.g. "Medisafe") or numeric App Store ID'),
|
|
99
|
+
country: zod_1.z.string().optional().describe("Two-letter country code (default: us)"),
|
|
100
|
+
}, safe((args) => (0, competitor_snapshot_js_1.competitorSnapshot)(args, tier)));
|
|
101
|
+
server.tool("metadata_diff", "Compare metadata between your live and pending app versions. Shows what changed in descriptions, keywords, and release notes across locales.", {
|
|
102
|
+
app_id: zod_1.z.string().regex(/^\d+$/, "App ID must be numeric").describe("App Store Connect app ID"),
|
|
103
|
+
}, safe((args) => (0, metadata_diff_js_1.metadataDiff)(client, args, tier)));
|
|
90
104
|
const transport = new stdio_js_1.StdioServerTransport();
|
|
91
105
|
await server.connect(transport);
|
|
92
106
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { Tier } from "../types.js";
|
|
2
|
+
export declare const competitorSnapshotDefinition: {
|
|
3
|
+
name: string;
|
|
4
|
+
description: string;
|
|
5
|
+
inputSchema: {
|
|
6
|
+
type: "object";
|
|
7
|
+
properties: {
|
|
8
|
+
query: {
|
|
9
|
+
type: string;
|
|
10
|
+
description: string;
|
|
11
|
+
};
|
|
12
|
+
country: {
|
|
13
|
+
type: string;
|
|
14
|
+
description: string;
|
|
15
|
+
};
|
|
16
|
+
};
|
|
17
|
+
required: string[];
|
|
18
|
+
};
|
|
19
|
+
};
|
|
20
|
+
export declare function competitorSnapshot(args: {
|
|
21
|
+
query: string;
|
|
22
|
+
country?: string;
|
|
23
|
+
}, tier: Tier): Promise<string>;
|
|
24
|
+
//# sourceMappingURL=competitor-snapshot.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"competitor-snapshot.d.ts","sourceRoot":"","sources":["../../src/tools/competitor-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAoBxC,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;CAmBxC,CAAC;AAgEF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACzC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAkDjB"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.competitorSnapshotDefinition = void 0;
|
|
4
|
+
exports.competitorSnapshot = competitorSnapshot;
|
|
5
|
+
exports.competitorSnapshotDefinition = {
|
|
6
|
+
name: "competitor_snapshot",
|
|
7
|
+
description: "Get a competitive snapshot of any app on the App Store. Shows ratings, reviews count, version history, pricing, and category. Use to compare your app against competitors. Accepts app name (search) or numeric App Store ID (lookup).",
|
|
8
|
+
inputSchema: {
|
|
9
|
+
type: "object",
|
|
10
|
+
properties: {
|
|
11
|
+
query: {
|
|
12
|
+
type: "string",
|
|
13
|
+
description: 'App name to search for (e.g. "Medisafe") or numeric App Store ID (e.g. "573916946").',
|
|
14
|
+
},
|
|
15
|
+
country: {
|
|
16
|
+
type: "string",
|
|
17
|
+
description: "Two-letter country code for regional data (default: us).",
|
|
18
|
+
},
|
|
19
|
+
},
|
|
20
|
+
required: ["query"],
|
|
21
|
+
},
|
|
22
|
+
};
|
|
23
|
+
async function lookupById(id, country) {
|
|
24
|
+
const url = `https://itunes.apple.com/lookup?id=${id}&country=${country}`;
|
|
25
|
+
const resp = await fetch(url);
|
|
26
|
+
if (!resp.ok)
|
|
27
|
+
return null;
|
|
28
|
+
const data = (await resp.json());
|
|
29
|
+
return data.results[0] || null;
|
|
30
|
+
}
|
|
31
|
+
async function searchByName(term, country) {
|
|
32
|
+
const url = new URL("https://itunes.apple.com/search");
|
|
33
|
+
url.searchParams.set("term", term);
|
|
34
|
+
url.searchParams.set("entity", "software");
|
|
35
|
+
url.searchParams.set("country", country);
|
|
36
|
+
url.searchParams.set("limit", "5");
|
|
37
|
+
const resp = await fetch(url.toString());
|
|
38
|
+
if (!resp.ok)
|
|
39
|
+
return [];
|
|
40
|
+
const data = (await resp.json());
|
|
41
|
+
return data.results;
|
|
42
|
+
}
|
|
43
|
+
function formatSize(bytes) {
|
|
44
|
+
const b = parseInt(bytes, 10);
|
|
45
|
+
if (isNaN(b))
|
|
46
|
+
return "?";
|
|
47
|
+
if (b > 1_000_000_000)
|
|
48
|
+
return `${(b / 1_000_000_000).toFixed(1)} GB`;
|
|
49
|
+
if (b > 1_000_000)
|
|
50
|
+
return `${(b / 1_000_000).toFixed(0)} MB`;
|
|
51
|
+
return `${(b / 1_000).toFixed(0)} KB`;
|
|
52
|
+
}
|
|
53
|
+
function formatApp(app) {
|
|
54
|
+
let out = `### ${app.trackName}\n\n`;
|
|
55
|
+
out += `| Field | Value |\n`;
|
|
56
|
+
out += `|-------|-------|\n`;
|
|
57
|
+
out += `| **App Store ID** | ${app.trackId} |\n`;
|
|
58
|
+
out += `| **Bundle ID** | ${app.bundleId} |\n`;
|
|
59
|
+
out += `| **Seller** | ${app.sellerName} |\n`;
|
|
60
|
+
out += `| **Category** | ${app.primaryGenreName} |\n`;
|
|
61
|
+
out += `| **Price** | ${app.formattedPrice} |\n`;
|
|
62
|
+
out += `| **Rating** | ${app.averageUserRating?.toFixed(1) || "?"} stars (${(app.userRatingCount || 0).toLocaleString()} ratings) |\n`;
|
|
63
|
+
out += `| **Version** | ${app.version} |\n`;
|
|
64
|
+
out += `| **Last Updated** | ${(app.currentVersionReleaseDate || "").split("T")[0]} |\n`;
|
|
65
|
+
out += `| **Size** | ${formatSize(app.fileSizeBytes)} |\n`;
|
|
66
|
+
out += `| **Content Rating** | ${app.trackContentRating} |\n`;
|
|
67
|
+
if (app.releaseNotes) {
|
|
68
|
+
out += `\n**Latest Release Notes:**\n`;
|
|
69
|
+
// Truncate long release notes
|
|
70
|
+
const notes = app.releaseNotes.length > 500
|
|
71
|
+
? app.releaseNotes.slice(0, 500) + "..."
|
|
72
|
+
: app.releaseNotes;
|
|
73
|
+
out += `> ${notes.replace(/\n/g, "\n> ")}\n`;
|
|
74
|
+
}
|
|
75
|
+
return out;
|
|
76
|
+
}
|
|
77
|
+
async function competitorSnapshot(args, tier) {
|
|
78
|
+
if (tier !== "pro") {
|
|
79
|
+
return ("Competitor snapshot requires a Pro license ($9/mo).\n" +
|
|
80
|
+
"Get your license at: https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu\n\n" +
|
|
81
|
+
"Set ASC_LICENSE_KEY in your MCP server config to unlock.");
|
|
82
|
+
}
|
|
83
|
+
const country = args.country || "us";
|
|
84
|
+
const query = args.query.trim();
|
|
85
|
+
// Check if query is a numeric ID
|
|
86
|
+
const isId = /^\d+$/.test(query);
|
|
87
|
+
let result = `## Competitor Snapshot\n\n`;
|
|
88
|
+
if (isId) {
|
|
89
|
+
const app = await lookupById(query, country);
|
|
90
|
+
if (!app) {
|
|
91
|
+
return `No app found with ID ${query} in the ${country.toUpperCase()} store.`;
|
|
92
|
+
}
|
|
93
|
+
result += formatApp(app);
|
|
94
|
+
}
|
|
95
|
+
else {
|
|
96
|
+
const apps = await searchByName(query, country);
|
|
97
|
+
if (apps.length === 0) {
|
|
98
|
+
return `No apps found matching "${query}" in the ${country.toUpperCase()} store.`;
|
|
99
|
+
}
|
|
100
|
+
result += `Found ${apps.length} app(s) matching "${query}" (${country.toUpperCase()} store):\n\n`;
|
|
101
|
+
for (const app of apps) {
|
|
102
|
+
result += formatApp(app);
|
|
103
|
+
result += "\n";
|
|
104
|
+
}
|
|
105
|
+
// Comparison summary if multiple results
|
|
106
|
+
if (apps.length > 1) {
|
|
107
|
+
result += `### Quick Comparison\n\n`;
|
|
108
|
+
result += `| App | Rating | Reviews | Price | Last Update |\n`;
|
|
109
|
+
result += `|-----|--------|---------|-------|-------------|\n`;
|
|
110
|
+
for (const app of apps) {
|
|
111
|
+
result += `| ${app.trackName.slice(0, 30)} | ${app.averageUserRating?.toFixed(1) || "?"} | ${(app.userRatingCount || 0).toLocaleString()} | ${app.formattedPrice} | ${(app.currentVersionReleaseDate || "").split("T")[0]} |\n`;
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
result += `\n*Data from iTunes Search API (${country.toUpperCase()} store). Ratings and reviews are all-time totals.*\n`;
|
|
116
|
+
return result;
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=competitor-snapshot.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"competitor-snapshot.js","sourceRoot":"","sources":["../../src/tools/competitor-snapshot.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { ASCClient } from "../client.js";
|
|
2
|
+
import type { Tier } from "../types.js";
|
|
3
|
+
export declare const keywordInsightsDefinition: {
|
|
4
|
+
name: string;
|
|
5
|
+
description: string;
|
|
6
|
+
inputSchema: {
|
|
7
|
+
type: "object";
|
|
8
|
+
properties: {
|
|
9
|
+
app_id: {
|
|
10
|
+
type: string;
|
|
11
|
+
description: string;
|
|
12
|
+
};
|
|
13
|
+
extra_keywords: {
|
|
14
|
+
type: string;
|
|
15
|
+
description: string;
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
required: string[];
|
|
19
|
+
};
|
|
20
|
+
};
|
|
21
|
+
export declare function keywordInsights(client: ASCClient, args: {
|
|
22
|
+
app_id: string;
|
|
23
|
+
extra_keywords?: string;
|
|
24
|
+
}, tier: Tier): Promise<string>;
|
|
25
|
+
//# sourceMappingURL=keyword-insights.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"keyword-insights.d.ts","sourceRoot":"","sources":["../../src/tools/keyword-insights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAsBxC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;CAmBrC,CAAC;AAoBF,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAiIjB"}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.keywordInsightsDefinition = void 0;
|
|
4
|
+
exports.keywordInsights = keywordInsights;
|
|
5
|
+
exports.keywordInsightsDefinition = {
|
|
6
|
+
name: "keyword_insights",
|
|
7
|
+
description: "Analyze your app's App Store keywords against search competition. Shows which keywords have high competition, suggests gaps, and compares your keyword budget usage. Uses the public iTunes Search API for competition data.",
|
|
8
|
+
inputSchema: {
|
|
9
|
+
type: "object",
|
|
10
|
+
properties: {
|
|
11
|
+
app_id: {
|
|
12
|
+
type: "string",
|
|
13
|
+
description: "Your App Store Connect app ID. Use list_apps to find it.",
|
|
14
|
+
},
|
|
15
|
+
extra_keywords: {
|
|
16
|
+
type: "string",
|
|
17
|
+
description: "Optional comma-separated keywords to analyze beyond what's in your current metadata (e.g. 'habit tracker,daily planner').",
|
|
18
|
+
},
|
|
19
|
+
},
|
|
20
|
+
required: ["app_id"],
|
|
21
|
+
},
|
|
22
|
+
};
|
|
23
|
+
async function searchItunes(term, country = "us", limit = 10) {
|
|
24
|
+
const url = new URL("https://itunes.apple.com/search");
|
|
25
|
+
url.searchParams.set("term", term);
|
|
26
|
+
url.searchParams.set("entity", "software");
|
|
27
|
+
url.searchParams.set("country", country);
|
|
28
|
+
url.searchParams.set("limit", String(limit));
|
|
29
|
+
const resp = await fetch(url.toString());
|
|
30
|
+
if (!resp.ok) {
|
|
31
|
+
throw new Error(`iTunes Search API error: ${resp.status}`);
|
|
32
|
+
}
|
|
33
|
+
return (await resp.json());
|
|
34
|
+
}
|
|
35
|
+
async function keywordInsights(client, args, tier) {
|
|
36
|
+
if (tier !== "pro") {
|
|
37
|
+
return ("Keyword insights require a Pro license ($9/mo).\n" +
|
|
38
|
+
"Get your license at: https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu\n\n" +
|
|
39
|
+
"Set ASC_LICENSE_KEY in your MCP server config to unlock.");
|
|
40
|
+
}
|
|
41
|
+
// 1. Get current keywords from ASC
|
|
42
|
+
const versionsResp = await client.get(`/v1/apps/${args.app_id}/appStoreVersions`, {
|
|
43
|
+
"fields[appStoreVersions]": "versionString,appStoreState",
|
|
44
|
+
limit: "3",
|
|
45
|
+
});
|
|
46
|
+
const versions = Array.isArray(versionsResp.data)
|
|
47
|
+
? versionsResp.data
|
|
48
|
+
: [versionsResp.data];
|
|
49
|
+
if (versions.length === 0) {
|
|
50
|
+
return "No versions found for this app.";
|
|
51
|
+
}
|
|
52
|
+
const versionId = versions[0].id;
|
|
53
|
+
let currentKeywords = "";
|
|
54
|
+
try {
|
|
55
|
+
const locResp = await client.get(`/v1/appStoreVersions/${versionId}/appStoreVersionLocalizations`, {
|
|
56
|
+
"fields[appStoreVersionLocalizations]": "locale,keywords,description",
|
|
57
|
+
limit: "5",
|
|
58
|
+
});
|
|
59
|
+
const locs = Array.isArray(locResp.data) ? locResp.data : [locResp.data];
|
|
60
|
+
// Use first locale with keywords
|
|
61
|
+
for (const loc of locs) {
|
|
62
|
+
if (loc.attributes.keywords) {
|
|
63
|
+
currentKeywords = loc.attributes.keywords;
|
|
64
|
+
break;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
// Continue without current keywords
|
|
70
|
+
}
|
|
71
|
+
// 2. Parse keywords to analyze
|
|
72
|
+
const keywordsToAnalyze = [];
|
|
73
|
+
if (currentKeywords) {
|
|
74
|
+
keywordsToAnalyze.push(...currentKeywords.split(",").map((k) => k.trim()).filter(Boolean));
|
|
75
|
+
}
|
|
76
|
+
if (args.extra_keywords) {
|
|
77
|
+
keywordsToAnalyze.push(...args.extra_keywords.split(",").map((k) => k.trim()).filter(Boolean));
|
|
78
|
+
}
|
|
79
|
+
if (keywordsToAnalyze.length === 0) {
|
|
80
|
+
return ("No keywords found in your app metadata and no extra_keywords provided.\n" +
|
|
81
|
+
"Pass extra_keywords to analyze specific terms (e.g. 'habit tracker,daily planner').");
|
|
82
|
+
}
|
|
83
|
+
// 3. Analyze each keyword against iTunes Search
|
|
84
|
+
let result = `## Keyword Insights for App ${args.app_id}\n\n`;
|
|
85
|
+
if (currentKeywords) {
|
|
86
|
+
result += `**Current keywords** (${currentKeywords.length}/100 chars):\n`;
|
|
87
|
+
result += `\`${currentKeywords}\`\n\n`;
|
|
88
|
+
const remaining = 100 - currentKeywords.length;
|
|
89
|
+
if (remaining > 10) {
|
|
90
|
+
result += `You have **${remaining} characters** of keyword budget unused. Consider adding more keywords.\n\n`;
|
|
91
|
+
}
|
|
92
|
+
else if (remaining < 0) {
|
|
93
|
+
result += `**WARNING**: Keywords exceed the 100-character limit by ${-remaining} chars. Apple will truncate.\n\n`;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
result += `### Competition Analysis\n\n`;
|
|
97
|
+
result += `| Keyword | Top App | Top Rating | Top Reviews | Competing Apps | Difficulty |\n`;
|
|
98
|
+
result += `|---------|---------|-----------|-------------|---------------|------------|\n`;
|
|
99
|
+
// Rate limit: max 20 searches per call to be respectful
|
|
100
|
+
const limited = keywordsToAnalyze.slice(0, 20);
|
|
101
|
+
for (const keyword of limited) {
|
|
102
|
+
try {
|
|
103
|
+
const searchResp = await searchItunes(keyword, "us", 10);
|
|
104
|
+
const count = searchResp.resultCount;
|
|
105
|
+
const top = searchResp.results[0];
|
|
106
|
+
let difficulty = "LOW";
|
|
107
|
+
if (top) {
|
|
108
|
+
if (top.userRatingCount > 50000)
|
|
109
|
+
difficulty = "VERY HIGH";
|
|
110
|
+
else if (top.userRatingCount > 10000)
|
|
111
|
+
difficulty = "HIGH";
|
|
112
|
+
else if (top.userRatingCount > 1000)
|
|
113
|
+
difficulty = "MEDIUM";
|
|
114
|
+
}
|
|
115
|
+
if (top) {
|
|
116
|
+
result += `| ${keyword} | ${top.trackName.slice(0, 25)} | ${top.averageUserRating?.toFixed(1) || "?"} | ${top.userRatingCount || 0} | ${count}+ | ${difficulty} |\n`;
|
|
117
|
+
}
|
|
118
|
+
else {
|
|
119
|
+
result += `| ${keyword} | (none) | - | - | 0 | LOW |\n`;
|
|
120
|
+
}
|
|
121
|
+
// Small delay to be respectful to the API
|
|
122
|
+
await new Promise((r) => setTimeout(r, 200));
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
result += `| ${keyword} | (error) | - | - | ? | ? |\n`;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
// 4. Summary and recommendations
|
|
129
|
+
result += `\n### Recommendations\n\n`;
|
|
130
|
+
result += `- Keywords with VERY HIGH difficulty (top app has 50K+ ratings) are hard to rank for as a new app\n`;
|
|
131
|
+
result += `- Look for MEDIUM or LOW difficulty keywords where top apps have fewer than 10K ratings\n`;
|
|
132
|
+
result += `- Long-tail keywords (3+ words) typically have lower competition\n`;
|
|
133
|
+
result += `- Use all 100 characters of keyword budget. Separate with commas, no spaces after commas\n`;
|
|
134
|
+
result += `- Apple indexes your app name + subtitle + keywords. Don't repeat words across them\n`;
|
|
135
|
+
if (limited.length < keywordsToAnalyze.length) {
|
|
136
|
+
result += `\n*Analyzed ${limited.length} of ${keywordsToAnalyze.length} keywords (capped to respect API rate limits).*\n`;
|
|
137
|
+
}
|
|
138
|
+
return result;
|
|
139
|
+
}
|
|
140
|
+
//# sourceMappingURL=keyword-insights.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"keyword-insights.js","sourceRoot":"","sources":["../../src/tools/keyword-insights.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { ASCClient } from "../client.js";
|
|
2
|
+
import type { Tier } from "../types.js";
|
|
3
|
+
export declare const metadataDiffDefinition: {
|
|
4
|
+
name: string;
|
|
5
|
+
description: string;
|
|
6
|
+
inputSchema: {
|
|
7
|
+
type: "object";
|
|
8
|
+
properties: {
|
|
9
|
+
app_id: {
|
|
10
|
+
type: string;
|
|
11
|
+
description: string;
|
|
12
|
+
};
|
|
13
|
+
};
|
|
14
|
+
required: string[];
|
|
15
|
+
};
|
|
16
|
+
};
|
|
17
|
+
export declare function metadataDiff(client: ASCClient, args: {
|
|
18
|
+
app_id: string;
|
|
19
|
+
}, tier: Tier): Promise<string>;
|
|
20
|
+
//# sourceMappingURL=metadata-diff.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metadata-diff.d.ts","sourceRoot":"","sources":["../../src/tools/metadata-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAkBxC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAclC,CAAC;AAwCF,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACxB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAsJjB"}
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.metadataDiffDefinition = void 0;
|
|
4
|
+
exports.metadataDiff = metadataDiff;
|
|
5
|
+
exports.metadataDiffDefinition = {
|
|
6
|
+
name: "metadata_diff",
|
|
7
|
+
description: "Compare metadata between two app versions (e.g., live vs pending). Shows what changed in descriptions, keywords, promotional text, and 'What's New' across locales. Helps verify changes before submission.",
|
|
8
|
+
inputSchema: {
|
|
9
|
+
type: "object",
|
|
10
|
+
properties: {
|
|
11
|
+
app_id: {
|
|
12
|
+
type: "string",
|
|
13
|
+
description: "Your App Store Connect app ID. Use list_apps to find it.",
|
|
14
|
+
},
|
|
15
|
+
},
|
|
16
|
+
required: ["app_id"],
|
|
17
|
+
},
|
|
18
|
+
};
|
|
19
|
+
async function getLocalizations(client, versionId) {
|
|
20
|
+
const resp = await client.get(`/v1/appStoreVersions/${versionId}/appStoreVersionLocalizations`, {
|
|
21
|
+
"fields[appStoreVersionLocalizations]": "locale,description,keywords,whatsNew,promotionalText,supportUrl,marketingUrl",
|
|
22
|
+
limit: "30",
|
|
23
|
+
});
|
|
24
|
+
const locs = Array.isArray(resp.data) ? resp.data : [resp.data];
|
|
25
|
+
const map = new Map();
|
|
26
|
+
for (const loc of locs) {
|
|
27
|
+
map.set(loc.attributes.locale, loc.attributes);
|
|
28
|
+
}
|
|
29
|
+
return map;
|
|
30
|
+
}
|
|
31
|
+
function diffField(field, oldVal, newVal) {
|
|
32
|
+
const a = (oldVal || "").trim();
|
|
33
|
+
const b = (newVal || "").trim();
|
|
34
|
+
if (a === b)
|
|
35
|
+
return null;
|
|
36
|
+
if (!a && b)
|
|
37
|
+
return ` + **${field}**: added (${b.length} chars)`;
|
|
38
|
+
if (a && !b)
|
|
39
|
+
return ` - **${field}**: REMOVED`;
|
|
40
|
+
if (a.length !== b.length) {
|
|
41
|
+
return ` ~ **${field}**: changed (${a.length} -> ${b.length} chars)`;
|
|
42
|
+
}
|
|
43
|
+
return ` ~ **${field}**: content changed (same length: ${a.length} chars)`;
|
|
44
|
+
}
|
|
45
|
+
async function metadataDiff(client, args, tier) {
|
|
46
|
+
if (tier !== "pro") {
|
|
47
|
+
return ("Metadata diff requires a Pro license ($9/mo).\n" +
|
|
48
|
+
"Get your license at: https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu\n\n" +
|
|
49
|
+
"Set ASC_LICENSE_KEY in your MCP server config to unlock.");
|
|
50
|
+
}
|
|
51
|
+
// Get all versions
|
|
52
|
+
const versionsResp = await client.get(`/v1/apps/${args.app_id}/appStoreVersions`, {
|
|
53
|
+
"fields[appStoreVersions]": "versionString,platform,appStoreState",
|
|
54
|
+
limit: "10",
|
|
55
|
+
});
|
|
56
|
+
const versions = Array.isArray(versionsResp.data)
|
|
57
|
+
? versionsResp.data
|
|
58
|
+
: [versionsResp.data];
|
|
59
|
+
if (versions.length < 2) {
|
|
60
|
+
if (versions.length === 1) {
|
|
61
|
+
return (`Only one version found (v${versions[0].attributes.versionString}, ${versions[0].attributes.appStoreState}).\n` +
|
|
62
|
+
"Metadata diff requires at least two versions to compare.\n" +
|
|
63
|
+
"Use release_preflight to audit the current version instead.");
|
|
64
|
+
}
|
|
65
|
+
return "No versions found for this app.";
|
|
66
|
+
}
|
|
67
|
+
// Find the right pair: ideally pending vs live
|
|
68
|
+
const liveStates = ["READY_FOR_SALE"];
|
|
69
|
+
const pendingStates = [
|
|
70
|
+
"PREPARE_FOR_SUBMISSION",
|
|
71
|
+
"READY_FOR_REVIEW",
|
|
72
|
+
"WAITING_FOR_REVIEW",
|
|
73
|
+
"IN_REVIEW",
|
|
74
|
+
"DEVELOPER_REJECTED",
|
|
75
|
+
];
|
|
76
|
+
const liveVersion = versions.find((v) => liveStates.includes(v.attributes.appStoreState));
|
|
77
|
+
const pendingVersion = versions.find((v) => pendingStates.includes(v.attributes.appStoreState));
|
|
78
|
+
// Fall back to comparing the two most recent versions
|
|
79
|
+
const olderVersion = liveVersion || versions[1];
|
|
80
|
+
const newerVersion = pendingVersion || versions[0];
|
|
81
|
+
if (olderVersion.id === newerVersion.id) {
|
|
82
|
+
return "Could not find two distinct versions to compare. Only one active version exists.";
|
|
83
|
+
}
|
|
84
|
+
let result = `## Metadata Diff\n\n`;
|
|
85
|
+
result += `**Comparing**: v${olderVersion.attributes.versionString} (${olderVersion.attributes.appStoreState}) `;
|
|
86
|
+
result += `-> v${newerVersion.attributes.versionString} (${newerVersion.attributes.appStoreState})\n\n`;
|
|
87
|
+
// Fetch localizations for both
|
|
88
|
+
let olderLocs;
|
|
89
|
+
let newerLocs;
|
|
90
|
+
try {
|
|
91
|
+
olderLocs = await getLocalizations(client, olderVersion.id);
|
|
92
|
+
}
|
|
93
|
+
catch (err) {
|
|
94
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
95
|
+
return `Could not fetch localizations for v${olderVersion.attributes.versionString}: ${msg}`;
|
|
96
|
+
}
|
|
97
|
+
try {
|
|
98
|
+
newerLocs = await getLocalizations(client, newerVersion.id);
|
|
99
|
+
}
|
|
100
|
+
catch (err) {
|
|
101
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
102
|
+
return `Could not fetch localizations for v${newerVersion.attributes.versionString}: ${msg}`;
|
|
103
|
+
}
|
|
104
|
+
// Compare each locale
|
|
105
|
+
const allLocales = new Set([...olderLocs.keys(), ...newerLocs.keys()]);
|
|
106
|
+
let totalChanges = 0;
|
|
107
|
+
let localesWithChanges = 0;
|
|
108
|
+
const fields = [
|
|
109
|
+
"description",
|
|
110
|
+
"keywords",
|
|
111
|
+
"whatsNew",
|
|
112
|
+
"promotionalText",
|
|
113
|
+
"supportUrl",
|
|
114
|
+
"marketingUrl",
|
|
115
|
+
];
|
|
116
|
+
for (const locale of [...allLocales].sort()) {
|
|
117
|
+
const older = olderLocs.get(locale);
|
|
118
|
+
const newer = newerLocs.get(locale);
|
|
119
|
+
if (!older && newer) {
|
|
120
|
+
result += `### ${locale} (NEW locale added)\n`;
|
|
121
|
+
for (const field of fields) {
|
|
122
|
+
const val = newer[field];
|
|
123
|
+
if (val) {
|
|
124
|
+
result += ` + **${field}**: ${String(val).length} chars\n`;
|
|
125
|
+
totalChanges++;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
localesWithChanges++;
|
|
129
|
+
result += "\n";
|
|
130
|
+
continue;
|
|
131
|
+
}
|
|
132
|
+
if (older && !newer) {
|
|
133
|
+
result += `### ${locale} (REMOVED)\n\n`;
|
|
134
|
+
localesWithChanges++;
|
|
135
|
+
totalChanges++;
|
|
136
|
+
continue;
|
|
137
|
+
}
|
|
138
|
+
if (!older || !newer)
|
|
139
|
+
continue;
|
|
140
|
+
// Both exist, diff each field
|
|
141
|
+
const diffs = [];
|
|
142
|
+
for (const field of fields) {
|
|
143
|
+
const d = diffField(field, older[field], newer[field]);
|
|
144
|
+
if (d) {
|
|
145
|
+
diffs.push(d);
|
|
146
|
+
totalChanges++;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
if (diffs.length > 0) {
|
|
150
|
+
result += `### ${locale} (${diffs.length} change${diffs.length > 1 ? "s" : ""})\n`;
|
|
151
|
+
for (const d of diffs) {
|
|
152
|
+
result += d + "\n";
|
|
153
|
+
}
|
|
154
|
+
result += "\n";
|
|
155
|
+
localesWithChanges++;
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
if (totalChanges === 0) {
|
|
159
|
+
result += "**No metadata differences found** between these versions.\n";
|
|
160
|
+
result += "The versions may differ only in binary/build, not metadata.\n";
|
|
161
|
+
}
|
|
162
|
+
else {
|
|
163
|
+
result += `---\n`;
|
|
164
|
+
result += `**Summary**: ${totalChanges} change${totalChanges > 1 ? "s" : ""} across ${localesWithChanges} locale${localesWithChanges > 1 ? "s" : ""} (${allLocales.size} total locales checked)\n`;
|
|
165
|
+
}
|
|
166
|
+
return result;
|
|
167
|
+
}
|
|
168
|
+
//# sourceMappingURL=metadata-diff.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metadata-diff.js","sourceRoot":"","sources":["../../src/tools/metadata-diff.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pofky/asc-mcp",
|
|
3
|
-
"version": "1.0
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "MCP server for Apple App Store Connect API - check review status, read customer reviews, download sales reports, pre-submission audit, daily briefings. Works with Claude Code, Cursor, Windsurf, or any AI coding agent. Free tier included.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"bin": {
|