storelift-mcp 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vomcore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,7 +4,7 @@ App Store & Google Play ranking data as an MCP server. Ask your assistant which
 keywords you dropped on, who outranks you, and whether AI assistants mention
 your app at all — without opening a dashboard.
 
-Backed by [Storelift](https://storelift.vomcore.com), which measures keyword
+Backed by [Storelift](https://storelift.net), which measures keyword
 ranks, rivals and AI visibility nightly. **No store credentials required** —
 ranks are read from the public storefront.
 
@@ -65,7 +65,7 @@ single measurement.
 | Variable | Default | Purpose |
 |---|---|---|
 | `STORELIFT_API_KEY` | — | required; the server exits with a message if unset |
-| `STORELIFT_API` | `https://storelift.vomcore.com` | override the API base |
+| `STORELIFT_API` | `https://storelift.net` | override the API base |
 
 No dependencies — a single file speaking JSON-RPC over stdio. Runs with
 `node index.mjs` just as well as through `npx`.

package/index.mjs

@@ -20,38 +20,66 @@
 // BAĞIMLILIK YOK: stdio üzerinden JSON-RPC elle konuşuluyor. Tek dosya, npm
 // kurulumu gerektirmeden `node index.mjs` ile de çalışır.
 
-const BASE = process.env.STORELIFT_API || "https://storelift.vomcore.com";
+import { createRequire } from "node:module";
+
+const BASE = process.env.STORELIFT_API || "https://storelift.net";
 const KEY = process.env.STORELIFT_API_KEY;
+// Sürüm TEK YERDEN: elle yazılan serverInfo.version, package.json 1.0.1'e
+// çıkınca 1.0.0'da kalıp istemciye yanlış sürüm bildiriyordu.
+const { version: VERSION } = createRequire(import.meta.url)("./package.json");
 
+// DIŞA DÖNÜK METİNLER İNGİLİZCE. Kod yorumları Türkçe (depo dili), ama araç
+// açıklamaları ve hata metinleri MCP dizinlerinde ve yabancı bir kullanıcının
+// araç panelinde görünüyor — orada Türkçe, ürünü küçültür.
 if (!KEY) {
-  console.error("STORELIFT_API_KEY tanımlı değil. Ayarlar → API anahtarları'ndan bir anahtar üret.");
+  // ⚠️ PLAN DA YAZILIYOR. Eski metin yalnız "Settings → API keys" diyordu;
+  // Public API STUDIO'ya açık (api/index.mjs › PLANS: free/pro `api: false`).
+  // Ücretsiz plandaki biri o yönergeyi izleyip anahtar üretemeyince paketi
+  // bozuk sanıyordu — README plan şartını söylüyordu ama çalışan program
+  // söylemiyordu, ve kullanıcı README'yi değil hata metnini okuyor.
+  console.error(
+    "STORELIFT_API_KEY is not set.\n" +
+    "Generate one at Storelift → Settings → API keys (requires the Studio plan).\n" +
+    "https://storelift.net/pricing"
+  );
   process.exit(1);
 }
 
+/* Sunucunun hata KODLARI kısa ve makine için ("plan_required"). Model onu
+   olduğu gibi kullanıcıya anlatınca ortaya "ERROR: plan_required" çıkıyor ve
+   kimse ne yapacağını bilmiyor. En sık karşılaşılacak üç durum burada insan
+   cümlesine çevriliyor; çevrilmeyen kod olduğu gibi geçiyor (uydurma bir
+   açıklama, hiç açıklama olmamasından kötüdür). */
+const HATA_METNI = {
+  plan_required: "The Public API is available on the Studio plan. Upgrade at https://storelift.net/pricing",
+  invalid_api_key: "This API key is not valid. Generate a new one at Storelift → Settings → API keys.",
+  missing_api_key: "No API key was sent. Set STORELIFT_API_KEY in your MCP server config.",
+};
+
 async function api(path) {
   const res = await fetch(BASE + path, { headers: { "x-api-key": KEY } });
   const body = await res.json().catch(() => ({}));
-  if (!res.ok) throw new Error(body.error || `HTTP ${res.status}`);
+  if (!res.ok) throw new Error(HATA_METNI[body.error] || body.error || `HTTP ${res.status}`);
   return body;
 }
 
 const TOOLS = [
   {
     name: "list_apps",
-    description: "Storelift hesabındaki izlenen uygulamaları listeler (id, ad, ülkeler, kelimeler).",
+    description: "List the apps tracked in this Storelift account (id, name, countries, keywords). Call this first — every other tool needs an appId from here.",
     inputSchema: { type: "object", properties: {} },
     run: () => api("/v1/apps"),
   },
   {
     name: "get_keywords",
     description:
-      "Bir uygulamanın bir ülkedeki kelime sıralarını verir. ÜÇ DURUM AYRIDIR: measured=false ölçülemedi, rank=null ölçüldü ama ilk sonuçlarda yok, rank=sayı sıra. Bunları birbirine karıştırma.",
+      "Keyword ranks for one app in one App Store / Google Play country. THREE STATES ARE DISTINCT: measured=false means the query could not be measured, rank=null means it was measured but the app is absent from the top results, rank=<number> is the rank. Never collapse them into one — counting an unmeasured day as zero produces a false answer.",
     inputSchema: {
       type: "object",
       properties: {
-        appId: { type: "string", description: "list_apps'ten gelen uygulama kimliği" },
-        country: { type: "string", description: "ülke kodu, ör. tr" },
-        platform: { type: "string", enum: ["ios", "android"] },
+        appId: { type: "string", description: "app id from list_apps" },
+        country: { type: "string", description: "country code, e.g. tr, us (defaults to the app's first country)" },
+        platform: { type: "string", enum: ["ios", "android"], description: "defaults to ios" },
       },
       required: ["appId"],
     },
@@ -60,10 +88,14 @@ const TOOLS = [
   {
     name: "get_rivals",
     description:
-      "Aramada uygulamanın ÜSTÜNDE çıkan uygulamalar. Her rakip için hangi kelimede kaçıncı olduğu ve bizim sıramız birlikte döner (ourRank null ise o kelimede hiç görünmüyoruz).",
+      "Apps that rank ABOVE this app in search. For each rival you get the keywords it beats you on, its rank there (theirRank) and yours (ourRank) — ourRank null means the app does not appear for that keyword at all.",
     inputSchema: {
       type: "object",
-      properties: { appId: { type: "string" }, country: { type: "string" }, platform: { type: "string", enum: ["ios", "android"] } },
+      properties: {
+        appId: { type: "string", description: "app id from list_apps" },
+        country: { type: "string", description: "country code, e.g. tr, us" },
+        platform: { type: "string", enum: ["ios", "android"], description: "defaults to ios" },
+      },
       required: ["appId"],
     },
     run: (a) => api(`/v1/apps/${a.appId}/rivals?country=${a.country || ""}&platform=${a.platform || "ios"}`),
@@ -71,14 +103,28 @@ const TOOLS = [
   {
     name: "get_ai_visibility",
     description:
-      "Asistanlara sorulan doğal sorularda uygulamanın anılıp anılmadığı — motor başına (Claude/ChatGPT/Gemini). Bu bir sıralama değil gözlemdir; tek ölçüm kanıt değildir, eğilime bak.",
-    inputSchema: { type: "object", properties: { appId: { type: "string" }, country: { type: "string" } }, required: ["appId"] },
+      "Whether AI assistants name this app when asked natural questions about its category — reported per engine (Claude / ChatGPT / Gemini), never averaged. This is an OBSERVATION, not a ranking: a model's knowledge is frozen at a date and the answer is not identical every time, so read the trend rather than a single measurement.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        appId: { type: "string", description: "app id from list_apps" },
+        country: { type: "string", description: "country code, e.g. tr, us" },
+      },
+      required: ["appId"],
+    },
     run: (a) => api(`/v1/apps/${a.appId}/ai?country=${a.country || ""}`),
   },
   {
     name: "get_history",
-    description: "Bir ülkedeki kelime sıra geçmişi. Seri noktaları [gün, sıra] biçiminde; sıra null ise o gün ilk sonuçlarda yoktuk.",
-    inputSchema: { type: "object", properties: { appId: { type: "string" }, country: { type: "string" } }, required: ["appId"] },
+    description: "Keyword rank history for one country. Series points are [day, rank]; a null rank means the app was absent from the top results that day, which is not the same as a bad rank.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        appId: { type: "string", description: "app id from list_apps" },
+        country: { type: "string", description: "country code, e.g. tr, us" },
+      },
+      required: ["appId"],
+    },
     run: (a) => api(`/v1/apps/${a.appId}/history?country=${a.country || ""}`),
   },
 ];
@@ -93,7 +139,7 @@ async function handle(req) {
     return ok(id, {
       protocolVersion: "2024-11-05",
       capabilities: { tools: {} },
-      serverInfo: { name: "storelift", version: "1.0.0" },
+      serverInfo: { name: "storelift", version: VERSION },
     });
   }
   if (method === "notifications/initialized") return; // bildirim, yanıt beklemez
@@ -102,17 +148,17 @@ async function handle(req) {
   }
   if (method === "tools/call") {
     const tool = TOOLS.find((t) => t.name === params?.name);
-    if (!tool) return err(id, `bilinmeyen araç: ${params?.name}`);
+    if (!tool) return err(id, `unknown tool: ${params?.name}`);
     try {
       const data = await tool.run(params.arguments || {});
       return ok(id, { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] });
     } catch (e) {
       // Hata metni araca DÖNÜYOR, sessizce yutulmuyor: model "veri yok" ile
       // "okuyamadım" arasındaki farkı görmezse yanlış sonuç anlatır.
-      return ok(id, { content: [{ type: "text", text: `HATA: ${e.message}` }], isError: true });
+      return ok(id, { content: [{ type: "text", text: `ERROR: ${e.message}` }], isError: true });
     }
   }
-  if (id !== undefined) err(id, `desteklenmeyen metot: ${method}`);
+  if (id !== undefined) err(id, `unsupported method: ${method}`);
 }
 
 let buf = "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storelift-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "App Store & Google Play keyword ranks, rivals and AI visibility as an MCP server",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "index.mjs",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "keywords": [
     "mcp",
@@ -22,7 +23,7 @@
     "keyword-rank",
     "ai-visibility"
   ],
-  "homepage": "https://storelift.vomcore.com",
+  "homepage": "https://storelift.net",
   "bugs": {
     "email": "hello@vomcore.com"
   },