@pofky/asc-mcp 1.0.1 → 1.2.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 CHANGED
@@ -1,14 +1,17 @@
1
1
  # App Store Connect MCP Server
2
2
 
3
- > **Not another API wrapper.** This MCP server catches rejections before you submit, gives you a morning briefing across all your apps, and writes your release notes from git history. The 5 free tools cover basics. The 3 Pro tools are things no other ASC server does.
3
+ > **The App Store Connect intelligence layer for your coding agent.** 11 tools that think, 3 slash-command workflows, and a bundled Claude Skill. Not another API wrapper.
4
+
5
+ Maintained successor to [JoshuaRileyDev/app-store-connect-mcp-server](https://github.com/JoshuaRileyDev/app-store-connect-mcp-server) (archived Feb 2026). Different angle, same API surface plus more.
4
6
 
5
7
  ```bash
6
8
  npm install -g @pofky/asc-mcp
9
+ asc-mcp install-skill # one-line, optional, for auto-routed review questions
7
10
  ```
8
11
 
9
12
  ## What Makes This Different
10
13
 
11
- Other ASC MCP servers wrap the API and give you 80-293 raw endpoints. This one gives you 8 tools that think:
14
+ Other ASC MCP servers wrap the API and give you 80 to 293 raw endpoints. This one gives you 11 tools plus 3 Prompts plus a Skill that all think:
12
15
 
13
16
  | You say | What happens |
14
17
  |---------|-------------|
@@ -72,11 +75,38 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, **Cline**, and any MCP-com
72
75
  | `release_preflight` | Pre-submission audit: metadata, char limits, screenshots, builds | Catches 40%+ of common rejection causes before you submit |
73
76
  | `daily_briefing` | Morning summary across all apps: status, reviews, rejections | One call replaces 10 minutes of portal clicking |
74
77
  | `release_notes` | Git commits since last tag, categorized for writing "What's New" | Your AI agent writes release notes from your actual changes |
78
+ | `keyword_insights` | Analyze keywords against iTunes search competition, difficulty ratings | See which keywords are worth targeting at a glance |
79
+ | `competitor_snapshot` | Look up any app: ratings, reviews, version, price, release notes | Competitive intelligence without leaving your editor |
80
+ | `metadata_diff` | Compare live vs pending version metadata across all locales | Verify exactly what changed before submitting |
75
81
 
76
- **Coming next:** review response drafting, keyword/ASO insights, competitor snapshots.
82
+ **Coming next (Week 2):** LLM-powered review clustering via MCP Sampling, Elicitation-driven response drafts, rejection-risk scoring against the 2026 corpus.
77
83
 
78
84
  [Get Pro](https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu) | [Retrieve your license key](https://asc-mcp-license.remewdy.workers.dev/key)
79
85
 
86
+ ## Slash Commands (Prompts)
87
+
88
+ Type these in Claude Desktop or Claude Code and the agent runs a pre-built multi-tool workflow:
89
+
90
+ | Slash command | What it does |
91
+ |---------------|--------------|
92
+ | `/asc-weekly-review` | Calls `daily_briefing` then `list_reviews` (low-rating, last 7 days) for every app, clusters themes, returns a single digest with 3-bullet action list. |
93
+ | `/asc-rejection-audit` | Given an `app_id`, calls `release_preflight` + `metadata_diff` + `review_status`, reads the result against the top 2026 rejection drivers (guideline 2.3 metadata, 4.0 design, privacy-AI 5.1.2). Produces Blocking / Likely-flagged / Safe sections. |
94
+ | `/asc-release-go-no-go` | Given an `app_id`, combines preflight + review queue + metadata diff + top competitors in the same category. Returns a direct GO or NO-GO with three supporting reasons. |
95
+
96
+ These are MCP Prompts per the [spec](https://modelcontextprotocol.io/docs/concepts/prompts/). Zero other App Store Connect MCP ships with them.
97
+
98
+ ## Claude Skill (one-line install)
99
+
100
+ After installing the MCP, run:
101
+
102
+ ```bash
103
+ asc-mcp install-skill
104
+ ```
105
+
106
+ This copies a small `asc-review-triage` Skill to `~/.claude/skills/` so Claude automatically picks up review-related questions ("any bad reviews lately?", "what do my users say?", "ratings this week?") and calls the right ASC tools without you having to explain the workflow each time.
107
+
108
+ Works on macOS, Linux, and Windows. To remove: `asc-mcp uninstall-skill`.
109
+
80
110
  ## Real Output Examples
81
111
 
82
112
  **"Run a preflight check before I submit"**
@@ -141,13 +171,15 @@ Lead with the most impactful change. Keep under 4000 chars.
141
171
 
142
172
  | | Raw API wrappers (free) | This server |
143
173
  |---|---|---|
144
- | **Tool count** | 80-293 | 8 |
145
- | **Pre-submission audit** | No | Yes - catches rejections before you submit |
146
- | **Cross-app briefings** | No | Yes - one call, all apps |
147
- | **Git-aware release notes** | No | Yes - reads your project's commit history |
148
- | **Smart review summaries** | No | Yes - sentiment grouping, action items |
149
- | **Setup** | Build from source (Swift/macOS) | `npm install -g` (any OS) |
150
- | **Free tier** | Some | Yes - 3 tools, no account needed |
174
+ | **Tool count** | 80 to 293 | 11 opinionated tools |
175
+ | **MCP Prompts (slash commands)** | No | Yes, 3 pre-built workflows |
176
+ | **Claude Skill bundled** | No | Yes, one-line install |
177
+ | **Pre-submission audit** | No | Yes, catches rejections before you submit |
178
+ | **Cross-app briefings** | No | Yes, one call, all apps |
179
+ | **Git-aware release notes** | No | Yes, reads your project's commit history |
180
+ | **Smart review summaries** | No | Yes, theme clustering, action items |
181
+ | **Setup** | Build from source (Swift or Node) | `npm install -g` (any OS) |
182
+ | **Free tier** | Some | Yes, 3 tools, no account needed |
151
183
 
152
184
  Raw wrappers give you endpoints. This gives you answers.
153
185
 
package/dist/index.js CHANGED
@@ -6,6 +6,8 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
6
6
  const zod_1 = require("zod");
7
7
  const client_js_1 = require("./client.js");
8
8
  const license_js_1 = require("./license.js");
9
+ const prompts_js_1 = require("./prompts.js");
10
+ const skill_installer_js_1 = require("./skill-installer.js");
9
11
  const list_apps_js_1 = require("./tools/list-apps.js");
10
12
  const app_details_js_1 = require("./tools/app-details.js");
11
13
  const review_status_js_1 = require("./tools/review-status.js");
@@ -14,6 +16,10 @@ const sales_report_js_1 = require("./tools/sales-report.js");
14
16
  const release_preflight_js_1 = require("./tools/release-preflight.js");
15
17
  const daily_briefing_js_1 = require("./tools/daily-briefing.js");
16
18
  const release_notes_js_1 = require("./tools/release-notes.js");
19
+ const keyword_insights_js_1 = require("./tools/keyword-insights.js");
20
+ const competitor_snapshot_js_1 = require("./tools/competitor-snapshot.js");
21
+ const metadata_diff_js_1 = require("./tools/metadata-diff.js");
22
+ const SERVER_VERSION = "1.2.0";
17
23
  function getConfig() {
18
24
  const keyId = process.env.ASC_KEY_ID;
19
25
  const issuerId = process.env.ASC_ISSUER_ID;
@@ -39,14 +45,19 @@ async function main() {
39
45
  const client = new client_js_1.ASCClient(config);
40
46
  const tier = await (0, license_js_1.validateLicense)(config.licenseKey);
41
47
  if (tier === "pro") {
42
- console.error("asc-mcp: Pro license active. All tools available.");
48
+ console.error(`asc-mcp ${SERVER_VERSION}: Pro license active. All tools available.`);
43
49
  }
44
50
  else {
45
- console.error("asc-mcp: Free tier (3 tools). Upgrade at https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu");
51
+ console.error(`asc-mcp ${SERVER_VERSION}: Free tier (3 tools). Upgrade at https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu`);
46
52
  }
47
53
  const server = new mcp_js_1.McpServer({
48
54
  name: "asc-mcp",
49
- version: "0.1.0",
55
+ version: SERVER_VERSION,
56
+ }, {
57
+ capabilities: {
58
+ tools: {},
59
+ prompts: {},
60
+ },
50
61
  });
51
62
  // --- Free tools ---
52
63
  /** Wrap a tool handler so API errors return messages instead of crashing. */
@@ -87,9 +98,52 @@ async function main() {
87
98
  since_tag: zod_1.z.string().optional().describe("Git tag to diff from (default: latest tag)"),
88
99
  max_commits: zod_1.z.number().optional().describe("Max commits to include (default 50)"),
89
100
  }, safe((args) => (0, release_notes_js_1.releaseNotes)(args, tier)));
101
+ server.tool("keyword_insights", "Analyze your app's keywords against search competition. Shows difficulty, competing apps, and budget usage. Uses iTunes Search API.", {
102
+ app_id: zod_1.z.string().regex(/^\d+$/, "App ID must be numeric").describe("App Store Connect app ID"),
103
+ extra_keywords: zod_1.z.string().optional().describe("Extra comma-separated keywords to analyze beyond current metadata"),
104
+ }, safe((args) => (0, keyword_insights_js_1.keywordInsights)(client, args, tier)));
105
+ 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.", {
106
+ query: zod_1.z.string().describe('App name (e.g. "Medisafe") or numeric App Store ID'),
107
+ country: zod_1.z.string().optional().describe("Two-letter country code (default: us)"),
108
+ }, safe((args) => (0, competitor_snapshot_js_1.competitorSnapshot)(args, tier)));
109
+ server.tool("metadata_diff", "Compare metadata between your live and pending app versions. Shows what changed in descriptions, keywords, and release notes across locales.", {
110
+ app_id: zod_1.z.string().regex(/^\d+$/, "App ID must be numeric").describe("App Store Connect app ID"),
111
+ }, safe((args) => (0, metadata_diff_js_1.metadataDiff)(client, args, tier)));
112
+ // --- Prompts (slash commands in Claude Desktop / Code) ---
113
+ const prompts = (0, prompts_js_1.registerPrompts)(server);
114
+ console.error(`asc-mcp: ${prompts.length} prompt(s) registered: ${prompts.map((p) => "/" + p.name).join(", ")}`);
90
115
  const transport = new stdio_js_1.StdioServerTransport();
91
116
  await server.connect(transport);
92
117
  }
118
+ function dispatchCli(argv) {
119
+ const cmd = argv[2];
120
+ if (!cmd)
121
+ return null;
122
+ if (cmd === "install-skill")
123
+ return (0, skill_installer_js_1.installSkill)();
124
+ if (cmd === "uninstall-skill")
125
+ return (0, skill_installer_js_1.uninstallSkill)();
126
+ if (cmd === "--version" || cmd === "-v" || cmd === "version") {
127
+ console.log(SERVER_VERSION);
128
+ return 0;
129
+ }
130
+ if (cmd === "--help" || cmd === "-h" || cmd === "help") {
131
+ console.log(`asc-mcp ${SERVER_VERSION}
132
+
133
+ Usage:
134
+ asc-mcp Run as an MCP server on stdio (for Claude Desktop/Code).
135
+ asc-mcp install-skill Install the asc-review-triage Claude Skill.
136
+ asc-mcp uninstall-skill Remove the asc-review-triage Claude Skill.
137
+ asc-mcp version Print version.
138
+ asc-mcp help This help.`);
139
+ return 0;
140
+ }
141
+ return null;
142
+ }
143
+ const cliResult = dispatchCli(process.argv);
144
+ if (cliResult !== null) {
145
+ process.exit(cliResult);
146
+ }
93
147
  main().catch((err) => {
94
148
  console.error("Fatal error:", err);
95
149
  process.exit(1);
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,16 @@
1
+ /**
2
+ * MCP Prompts for @pofky/asc-mcp.
3
+ *
4
+ * Prompts appear as slash commands in Claude Desktop and Claude Code.
5
+ * Each prompt seeds the conversation with a message that coaches Claude
6
+ * on the exact ASC tool sequence to run. This is the "procedural
7
+ * knowledge" layer competing MCPs skip.
8
+ */
9
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
10
+ export interface PromptRegistration {
11
+ name: string;
12
+ title: string;
13
+ description: string;
14
+ }
15
+ export declare function registerPrompts(server: McpServer): PromptRegistration[];
16
+ //# sourceMappingURL=prompts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,EAAE,CA6HvE"}
@@ -0,0 +1,124 @@
1
+ "use strict";
2
+ /**
3
+ * MCP Prompts for @pofky/asc-mcp.
4
+ *
5
+ * Prompts appear as slash commands in Claude Desktop and Claude Code.
6
+ * Each prompt seeds the conversation with a message that coaches Claude
7
+ * on the exact ASC tool sequence to run. This is the "procedural
8
+ * knowledge" layer competing MCPs skip.
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.registerPrompts = registerPrompts;
12
+ const zod_1 = require("zod");
13
+ const APP_ID_SCHEMA = zod_1.z
14
+ .string()
15
+ .regex(/^\d+$/, "App ID must be numeric. Use `list_apps` if you don't know it.")
16
+ .describe("App Store Connect app ID, numeric (use list_apps if unknown)");
17
+ function registerPrompts(server) {
18
+ const registered = [];
19
+ const weekly = server.registerPrompt("asc-weekly-review", {
20
+ title: "Weekly App Store review",
21
+ description: "One-click weekly summary across all your App Store Connect apps: version status, new low-rating reviews in the last 7 days, rejections, and action items. Calls daily_briefing then list_reviews (rating<=3) and synthesizes.",
22
+ }, () => ({
23
+ description: "Weekly review across all apps",
24
+ messages: [
25
+ {
26
+ role: "user",
27
+ content: {
28
+ type: "text",
29
+ text: [
30
+ "Give me a weekly App Store review across all my apps. Use the asc-mcp tools in this exact order and present a single concise summary at the end:",
31
+ "",
32
+ "1. Call `daily_briefing` with `days: 7` to get the situational overview (review status, rejections, action items).",
33
+ "2. Call `list_apps` to get the full list of app IDs if the briefing did not cover every app.",
34
+ "3. For each app that has `status: in_review` or that the briefing flagged, call `review_status` to confirm the current state.",
35
+ "4. For each app, call `list_reviews` with `rating: 3`, `sort: newest`, `limit: 20` to pull low-rating reviews from the last 7 days.",
36
+ "5. Cluster low-rating reviews by theme (bugs, pricing, missing feature, etc.). Keep to 3 to 5 clusters.",
37
+ "6. Produce a final digest with: apps in review, apps rejected, top 3 review themes with counts, and a 3-bullet action list for the coming week.",
38
+ "",
39
+ "Do not invent numbers. If a tool fails, say so and continue with the rest.",
40
+ ].join("\n"),
41
+ },
42
+ },
43
+ ],
44
+ }));
45
+ registered.push({
46
+ name: "asc-weekly-review",
47
+ title: weekly.title ?? "",
48
+ description: weekly.description ?? "",
49
+ });
50
+ const audit = server.registerPrompt("asc-rejection-audit", {
51
+ title: "Pre-submission rejection audit",
52
+ description: "Catch likely rejection causes before you submit. Runs release_preflight, then metadata_diff, then review_status, and reads results against the top 2026 rejection drivers (guideline 2.3 metadata, 4.0 design, privacy-AI 5.1.2).",
53
+ argsSchema: { app_id: APP_ID_SCHEMA },
54
+ }, ({ app_id }) => ({
55
+ description: `Rejection audit for app ${app_id}`,
56
+ messages: [
57
+ {
58
+ role: "user",
59
+ content: {
60
+ type: "text",
61
+ text: [
62
+ `Run a pre-submission rejection audit for App Store Connect app ${app_id}. Use the asc-mcp tools in this order:`,
63
+ "",
64
+ `1. Call \`release_preflight\` with \`app_id: "${app_id}"\` to audit metadata, character limits, screenshots, and build status.`,
65
+ `2. Call \`metadata_diff\` with \`app_id: "${app_id}"\` to see exactly what is changing between the live and pending version across all locales.`,
66
+ `3. Call \`review_status\` with \`app_id: "${app_id}"\` to confirm the current submission state.`,
67
+ "",
68
+ "Read the combined output against the top 2026 rejection drivers:",
69
+ "- Guideline 2.3 (inaccurate metadata: broken links, stale screenshots, placeholder text)",
70
+ "- Guideline 4.0 (design: minimum content, broken flows, missing signup)",
71
+ "- Guideline 5.1.2 (data use, privacy-AI: missing SDK disclosures, tracking permissions)",
72
+ "",
73
+ "Produce a report with three sections: (a) Blocking issues (fix before submit), (b) Likely-flagged items (judgment call), (c) Safe. Quote exact metadata lines that trigger each concern.",
74
+ "",
75
+ "Do not invent rejection reasons. If preflight finds zero issues and metadata_diff is clean, say 'no blocking issues found'.",
76
+ ].join("\n"),
77
+ },
78
+ },
79
+ ],
80
+ }));
81
+ registered.push({
82
+ name: "asc-rejection-audit",
83
+ title: audit.title ?? "",
84
+ description: audit.description ?? "",
85
+ });
86
+ const goNoGo = server.registerPrompt("asc-release-go-no-go", {
87
+ title: "Release go/no-go",
88
+ description: "Decide whether to ship a release today. Combines release_preflight, review_status, metadata_diff, and competitor_snapshot to produce a single GO or NO-GO recommendation with reasoning.",
89
+ argsSchema: { app_id: APP_ID_SCHEMA },
90
+ }, ({ app_id }) => ({
91
+ description: `Go/no-go decision for app ${app_id}`,
92
+ messages: [
93
+ {
94
+ role: "user",
95
+ content: {
96
+ type: "text",
97
+ text: [
98
+ `Decide whether to ship a release today for App Store Connect app ${app_id}. Use the asc-mcp tools in this order:`,
99
+ "",
100
+ `1. Call \`release_preflight\` with \`app_id: "${app_id}"\`.`,
101
+ `2. Call \`review_status\` with \`app_id: "${app_id}"\`.`,
102
+ `3. Call \`metadata_diff\` with \`app_id: "${app_id}"\`.`,
103
+ `4. Call \`app_details\` with \`app_id: "${app_id}"\` to read category and name.`,
104
+ "5. Call `competitor_snapshot` with the same category's top two competitors (use what you know) to see if anyone else just shipped a bigger release today.",
105
+ "",
106
+ "Produce a single GO or NO-GO with three supporting bullets:",
107
+ "- Preflight verdict (blocking issues y/n)",
108
+ "- Queue verdict (is the existing version still in review? if yes, hold)",
109
+ "- Market window (did a big competitor ship today? if yes, consider holding one day)",
110
+ "",
111
+ "Be direct. If unsure, say NO-GO and explain why. Do not hedge.",
112
+ ].join("\n"),
113
+ },
114
+ },
115
+ ],
116
+ }));
117
+ registered.push({
118
+ name: "asc-release-go-no-go",
119
+ title: goNoGo.title ?? "",
120
+ description: goNoGo.description ?? "",
121
+ });
122
+ return registered;
123
+ }
124
+ //# sourceMappingURL=prompts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * `asc-mcp install-skill` and `asc-mcp uninstall-skill` subcommands.
3
+ *
4
+ * Copies (or removes) the bundled `asc-review-triage` Claude Skill to
5
+ * ~/.claude/skills/asc-review-triage/ so Claude Desktop and Claude Code
6
+ * auto-load it.
7
+ */
8
+ export declare function installSkill(): number;
9
+ export declare function uninstallSkill(): number;
10
+ //# sourceMappingURL=skill-installer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-installer.d.ts","sourceRoot":"","sources":["../src/skill-installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuCH,wBAAgB,YAAY,IAAI,MAAM,CA0CrC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAgBvC"}
@@ -0,0 +1,104 @@
1
+ "use strict";
2
+ /**
3
+ * `asc-mcp install-skill` and `asc-mcp uninstall-skill` subcommands.
4
+ *
5
+ * Copies (or removes) the bundled `asc-review-triage` Claude Skill to
6
+ * ~/.claude/skills/asc-review-triage/ so Claude Desktop and Claude Code
7
+ * auto-load it.
8
+ */
9
+ var __importDefault = (this && this.__importDefault) || function (mod) {
10
+ return (mod && mod.__esModule) ? mod : { "default": mod };
11
+ };
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.installSkill = installSkill;
14
+ exports.uninstallSkill = uninstallSkill;
15
+ const node_fs_1 = __importDefault(require("node:fs"));
16
+ const node_path_1 = __importDefault(require("node:path"));
17
+ const node_os_1 = __importDefault(require("node:os"));
18
+ const SKILL_NAME = "asc-review-triage";
19
+ function targetDir() {
20
+ return node_path_1.default.join(node_os_1.default.homedir(), ".claude", "skills", SKILL_NAME);
21
+ }
22
+ function sourceDir() {
23
+ // When compiled, __dirname maps to dist/. The skills/ dir ships at
24
+ // the package root, one level up. CommonJS build uses __dirname.
25
+ return node_path_1.default.resolve(__dirname, "..", "skills", SKILL_NAME);
26
+ }
27
+ function ensureDir(dir) {
28
+ node_fs_1.default.mkdirSync(dir, { recursive: true });
29
+ }
30
+ function copyDirRecursive(src, dest) {
31
+ ensureDir(dest);
32
+ const written = [];
33
+ const entries = node_fs_1.default.readdirSync(src, { withFileTypes: true });
34
+ for (const entry of entries) {
35
+ const s = node_path_1.default.join(src, entry.name);
36
+ const d = node_path_1.default.join(dest, entry.name);
37
+ if (entry.isDirectory()) {
38
+ written.push(...copyDirRecursive(s, d));
39
+ }
40
+ else if (entry.isFile()) {
41
+ node_fs_1.default.copyFileSync(s, d);
42
+ written.push(d);
43
+ }
44
+ }
45
+ return written;
46
+ }
47
+ function installSkill() {
48
+ const src = sourceDir();
49
+ const dest = targetDir();
50
+ if (!node_fs_1.default.existsSync(src)) {
51
+ console.error(`[asc-mcp] skill source not found at ${src}`);
52
+ console.error("[asc-mcp] this is a packaging bug, please open an issue.");
53
+ return 1;
54
+ }
55
+ try {
56
+ console.log(`Installing ${SKILL_NAME} skill for Claude Desktop / Claude Code.`);
57
+ console.log("");
58
+ console.log(`Writing to ${dest}`);
59
+ const homeClaude = node_path_1.default.join(node_os_1.default.homedir(), ".claude");
60
+ const homeClaudeExisted = node_fs_1.default.existsSync(homeClaude);
61
+ const skillsParentExisted = node_fs_1.default.existsSync(node_path_1.default.dirname(dest));
62
+ ensureDir(dest);
63
+ const written = copyDirRecursive(src, dest);
64
+ console.log(` ${homeClaudeExisted ? " " : "+"} ~/.claude/ ${homeClaudeExisted ? "already existed" : "created"}`);
65
+ console.log(` ${skillsParentExisted ? " " : "+"} ~/.claude/skills/ ${skillsParentExisted ? "already existed" : "created"}`);
66
+ for (const f of written) {
67
+ console.log(` + ${node_path_1.default.relative(node_os_1.default.homedir(), f)}`);
68
+ }
69
+ console.log("");
70
+ console.log("Done. The skill is now active.");
71
+ console.log("");
72
+ console.log("Next: in Claude Desktop or Claude Code, try asking");
73
+ console.log(' "any bad reviews on my app lately?"');
74
+ console.log("Claude will auto-load the skill and call the right tools.");
75
+ console.log("");
76
+ console.log("If Claude does not pick it up, restart the client once.");
77
+ console.log("To remove: asc-mcp uninstall-skill");
78
+ return 0;
79
+ }
80
+ catch (err) {
81
+ const msg = err instanceof Error ? err.message : String(err);
82
+ console.error(`[asc-mcp] install failed: ${msg}`);
83
+ return 1;
84
+ }
85
+ }
86
+ function uninstallSkill() {
87
+ const dest = targetDir();
88
+ if (!node_fs_1.default.existsSync(dest)) {
89
+ console.log(`No ${SKILL_NAME} skill found at ${dest}. Nothing to do.`);
90
+ return 0;
91
+ }
92
+ try {
93
+ node_fs_1.default.rmSync(dest, { recursive: true, force: true });
94
+ console.log(`Removed ${dest}`);
95
+ console.log("Restart Claude Desktop or Claude Code to unload the skill.");
96
+ return 0;
97
+ }
98
+ catch (err) {
99
+ const msg = err instanceof Error ? err.message : String(err);
100
+ console.error(`[asc-mcp] uninstall failed: ${msg}`);
101
+ return 1;
102
+ }
103
+ }
104
+ //# sourceMappingURL=skill-installer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-installer.js","sourceRoot":"","sources":["../src/skill-installer.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,7 +1,7 @@
1
1
  {
2
2
  "name": "@pofky/asc-mcp",
3
- "version": "1.0.1",
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.",
3
+ "version": "1.2.0",
4
+ "description": "The App Store Connect intelligence layer for your coding agent. 11 tools, 3 slash-command Prompts, and a bundled Claude Skill. Works with Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP-compatible client. Free tier included.",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
7
7
  "asc-mcp": "dist/index.js",
@@ -57,6 +57,7 @@
57
57
  },
58
58
  "files": [
59
59
  "dist/",
60
+ "skills/",
60
61
  "README.md",
61
62
  "LICENSE"
62
63
  ]
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: asc-review-triage
3
+ description: Use this skill whenever the user asks about App Store reviews, ratings, customer feedback, low-star reviews, reviewer sentiment, or what users are saying about an iOS or macOS app. Queries the asc-mcp server to pull and analyze reviews. Trigger on phrases like "any bad reviews", "what do my users say", "reviews this week", "1-star", "2-star", "3-star", "customer feedback", "ratings trend", "reviewer sentiment".
4
+ ---
5
+
6
+ # App Store review triage
7
+
8
+ When the user asks about reviews, ratings, or customer feedback for their App Store apps, follow this procedure using the `asc-mcp` tools.
9
+
10
+ ## Step 1. Identify the app
11
+
12
+ If the user specified an app name or ID, use it. Otherwise:
13
+
14
+ 1. Call `list_apps` to get the full list.
15
+ 2. If there is only one app, use it.
16
+ 3. If there are several, ask the user which app they mean. Do not guess.
17
+
18
+ ## Step 2. Pull reviews
19
+
20
+ Call `list_reviews` with:
21
+
22
+ - `app_id`: the app ID from step 1
23
+ - `rating`: 3 (covers 1, 2, and 3 star reviews when sorted correctly)
24
+ - `sort`: `newest`
25
+ - `limit`: 20 for a quick scan, up to 100 for a deep dive
26
+
27
+ If the user specifically asked about 1-star reviews only, set `rating: 1`. If they asked about all reviews (positive and negative), call `list_reviews` without a rating filter.
28
+
29
+ ## Step 3. Confirm review status
30
+
31
+ Call `review_status` with the same `app_id`. This tells the user whether a new version is in review or waiting, which often correlates with review-score dips.
32
+
33
+ ## Step 4. Summarize
34
+
35
+ Produce a concise summary with:
36
+
37
+ - Total reviews in the window
38
+ - Breakdown by rating (1, 2, 3, 4, 5)
39
+ - 3 to 5 themes, each with a review-count and one representative quote
40
+ - Any single review flagged as potentially actionable (specific bug report, feature request, competitor mention)
41
+ - The current review-queue status from step 3
42
+
43
+ ## Guardrails
44
+
45
+ - Do not invent reviews. Quote only what `list_reviews` returned.
46
+ - Do not post a reply. This skill reads only. Drafting or posting responses is a separate Pro feature not in this skill.
47
+ - If `list_reviews` returns nothing, say so plainly.
48
+ - If the user does not have a Pro license (free tier), `list_reviews` will error. Explain the free-tier limit and link to https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu.
49
+
50
+ ## Example usage
51
+
52
+ User: "Any bad reviews on my meditation app this week?"
53
+
54
+ Claude:
55
+ 1. Calls `list_apps`, finds one app called "Meditation Timer".
56
+ 2. Calls `list_reviews` with that app ID, rating 3, newest first, limit 20.
57
+ 3. Calls `review_status`.
58
+ 4. Returns: "7 reviews in the last 7 days, average 2.3 stars. 3 themes: crashes on iOS 18.2 (4 reviews), missing dark mode (2 reviews), confusion over premium tier (1 review). The version 2.4.1 submission is currently In Review (submitted 2 days ago)."