magaza-mcp 0.3.0 → 0.4.0

package/AGENTS.md

@@ -157,8 +157,8 @@ npx -y magaza-mcp kaydet --magazalar appstore,play --salt-okunur
 ```
 
 Bu modda yazma yapan araçlar (`appstore__yorum_yanitla`,
-`appstore__metin_guncelle`, fiyat/abonelik/yaş derecelendirme araçları,
-`play__yorum_yanitla`) listeye hiç girmez; 32 araç 24'e düşer. `magaza__cagir` listede kalır — katalogdaki okuma uçlarına da o
+`appstore__metin_guncelle`, fiyat/abonelik/yaş derecelendirme araçları, Play yayın araçları,
+`play__yorum_yanitla`) listeye hiç girmez; 39 araç 26'ya düşer. `magaza__cagir` listede kalır — katalogdaki okuma uçlarına da o
 araçtan gidiliyor — ama veri değiştiren bir operasyon istendiğinde reddeder.
 
 Komut mevcut ayarlara dokunmaz: yalnızca `magaza-mcp` girdisini ekler veya
@@ -227,15 +227,23 @@ npx magaza-mcp kur
 
 ### Yüklü araçlar günlük işi görür
 
-İki mağaza da açıkken 32 araç yüklenir: 16 tane `appstore__`, 10 tane `play__`,
+İki mağaza da açıkken 39 araç yüklenir: 17 tane `appstore__`, 16 tane `play__`,
 3 tane iki mağazayı birden sorgulayan `magaza__`, 3 tane de aşağıdaki erişim
 aracı. Tek mağazalı kurulumda çapraz araçlar hiç oluşmaz: yalnızca App Store'da
-19, yalnızca Play'de 13 araç yüklenir. Araç tanımlarının tamamı bağlamda
-yaklaşık **6.000 token** yer kaplar.
+20, yalnızca Play'de 19 araç yüklenir. Araç tanımlarının tamamı bağlamda
+yaklaşık **8.500 token** yer kaplar.
 
 Abonelik ve IAP fiyatı, abonelik kurulumu, satış ülkeleri ve yaş
 derecelendirmesi için hazır `appstore__` araçları var. Bunları
 `magaza__cagir` ile ülke ülke yapma: hazır araç 175 ülkeyi tek istekte yazar.
+Kullanıcı "ülkelere göre fiyatlandır" derse önce `appstore__fiyat_analizi` ile
+öneri al, kullanıcıya göster, onaylarsa çıktıdaki `ozel_fiyatlar`'ı
+`appstore__abonelik_fiyat_ayarla`'ya ver. Play'de aynısı `play__fiyat_analizi` →
+`play__abonelik_fiyat_ayarla`.
+
+Play'de sürüm yayınlama (AAB yükleme dahil), rollout yüzdesi, kanallar arası
+taşıma, mağaza metni ve görsel için hazır `play__` araçları var; bunları
+`magaza__cagir` ile edit oturumu açıp kapatarak yapma.
 
 Hangi araçların yüklü olduğunu `npx -y magaza-mcp araclar` ile görebilirsin.
 

package/README.md

@@ -62,8 +62,8 @@ directly to Apple and Google, and your keys never leave your Keychain.
 | [🧑‍💻 Manual setup](#-manual-setup) | If you're not using an assistant |
 | [🧩 Do the two stores mix up?](#-do-the-two-stores-mix-up) | No — here's why |
 | [💬 What you can ask](#-what-you-can-ask) | Example prompts |
-| [🧰 Tools](#-tools) | Full list of all 32 tools |
-| [🌐 Full API access](#-full-api-access) | 1,440 operations, ~6,000 tokens |
+| [🧰 Tools](#-tools) | Full list of all 39 tools |
+| [🌐 Full API access](#-full-api-access) | 1,440 operations, ~8,500 tokens |
 | [🔑 Required permissions](#-required-permissions) | What Apple and Google require |
 | [🔒 Security](#-security) | Keys, approval gates, telemetry |
 | [🩺 Troubleshooting](#-troubleshooting) | Common errors |
@@ -274,10 +274,10 @@ model, and cost zero tokens.
 
 | Setup | Tools loaded |
 | --- | --- |
-| Both stores | 32 |
-| App Store only | 19 |
-| Play only | 13 |
-| Read-only (both stores) | 24 |
+| Both stores | 39 |
+| App Store only | 20 |
+| Play only | 19 |
+| Read-only (both stores) | 26 |
 
 **3. Cross-store tools only exist when both stores are enabled.** In a
 single-store setup they're never created at all — they'd have no meaning.
@@ -336,7 +336,7 @@ These tools only load when both stores are connected.
 </details>
 
 <details>
-<summary><b>App Store Connect — 16 tools</b> (<code>appstore__</code>)</summary>
+<summary><b>App Store Connect — 17 tools</b> (<code>appstore__</code>)</summary>
 
 <br>
 
@@ -353,7 +353,8 @@ These tools only load when both stores are connected.
 | `appstore__testflight_gruplari` | Shows TestFlight beta groups, how many testers are in each, public invite links, and quotas. |
 | `appstore__metin_guncelle` ✎ | Updates the store text of the version in preparation: release notes, description, keywords, promotional text. |
 | `appstore__satis_raporu` | Downloads the sales/download report as TSV: daily, weekly, monthly, or yearly; sales, pre-order, installs, subscriptions, subscription events, subscribers, and offer code reports. |
-| `appstore__abonelik_fiyat_ayarla` ✎ | Sets a subscription's price in **every country at once**: give one price (e.g. USA 9.99), Apple's equalization table fills in all ~175 countries and they're written in a single request. |
+| `appstore__abonelik_fiyat_ayarla` ✎ | Sets a subscription's price in **every country at once**: give one price (e.g. USA 9.99), Apple's equalization table fills in all ~175 countries and they're written in a single request. Add country-specific prices on top (`{"TUR": "349.99"}`), or change only those countries and leave the rest alone. |
+| `appstore__fiyat_analizi` | Regional pricing suggestion, writes nothing: starts from Apple's equalized price and applies a softened discount based on each country's purchasing power (World Bank). Never raises a price, never cuts more than half, leaves rich countries alone. The output plugs straight into `abonelik_fiyat_ayarla`. |
 | `appstore__iap_fiyat_ayarla` ✎ | Sets a one-time purchase's price from a single base country; Apple fills in the rest. |
 | `appstore__abonelik_ulkeleri` ✎ | Makes a subscription available in every country (or the ones you list) in one request. |
 | `appstore__abonelik_kur` ✎ | Creates a subscription from scratch behind one approval: group → subscription → localized names → availability → prices in all countries. |
@@ -362,7 +363,7 @@ These tools only load when both stores are connected.
 </details>
 
 <details>
-<summary><b>Google Play — 10 tools</b> (<code>play__</code>)</summary>
+<summary><b>Google Play — 16 tools</b> (<code>play__</code>)</summary>
 
 <br>
 
@@ -377,7 +378,13 @@ These tools only load when both stores are connected.
 | `play__urunler` | Lists one-time products; tries both the new (`oneTimeProducts`) and legacy (`inappproducts`) models. |
 | `play__satin_alma_dogrula` | Verifies a purchase token: subscription status, acknowledgment status, expiry date, whether it's a test purchase. |
 | `play__iade_edilenler` | Lists cancelled, refunded, or charged-back purchases; turns the refund reason and source into something readable. Google only returns the last 30 days. |
-| `play__cokme_orani` | Fetches Android vitals crash rate day by day, along with the number of distinct users in the measurement. |
+| `play__cokme_orani` | Android vitals: crash and ANR rates (including the user-perceived rates Play uses for its bad-behavior thresholds), whether a threshold is exceeded, and the most frequent crash clusters with stack traces. Can be narrowed to one version code. |
+| `play__surum_yayinla` ✎ | Uploads an AAB/APK and releases it to a track in one approval: upload → assign to track → release notes → commit. Give a percentage for a staged rollout (e.g. production 10%). If anything fails, nothing is committed. |
+| `play__yayin_yonet` ✎ | Manages a track: change the rollout %, halt, resume, complete, promote a release to another track (internal → production), or update only the release notes. The preview shows the track before and after. |
+| `play__listeleme_guncelle` ✎ | Reads or updates store listing text (title, short and full description, video) for every language in one edit. |
+| `play__gorsel_yukle` ✎ | Uploads screenshots, the icon, or the feature graphic, optionally replacing the existing ones. |
+| `play__abonelik_fiyat_ayarla` ✎ | Sets a base plan's price in every country at once from a USD price (Google's own conversion), with optional country-specific prices on top, or changes only the countries you list. |
+| `play__fiyat_analizi` | Regional pricing suggestion for Play, writes nothing: same purchasing-power logic as the App Store version, rounded to natural-looking local prices. |
 
 </details>
 
@@ -425,7 +432,7 @@ any of them.
 
 | | Tools | Paid on every message |
 | --- | --- | --- |
-| **magaza-mcp** | 32 | **~6,000 tokens** |
+| **magaza-mcp** | 39 | **~8,500 tokens** |
 | If all were separate tools | 1,440 | ~210,000 tokens |
 
 > [!NOTE]
@@ -482,7 +489,7 @@ some analytics reports need higher privileges.
   the client's approval UI.
 - **Read-only mode.** `--salt-okunur` (or `SALT_OKUNUR=1`) removes every
   write-capable tool from the list entirely: the model can't see them or call
-  them. 32 tools become 24. `magaza__cagir` stays in the list because it's
+  them. 39 tools become 26. `magaza__cagir` stays in the list because it's
   also the single gateway for read endpoints in the catalog — but it refuses
   write operations when read-only mode is on.
 - **Path parameters are validated.** IDs passed to tools are encoded before
@@ -500,8 +507,10 @@ some analytics reports need higher privileges.
 - **No telemetry.** No analytics, error reports, or usage data are sent.
   Network traffic only goes to `api.appstoreconnect.apple.com`,
   `androidpublisher.googleapis.com`, `playdeveloperreporting.googleapis.com`,
-  and `oauth2.googleapis.com` for tokens. There's no server in the middle;
-  data flows directly between your machine and Apple/Google.
+  and `oauth2.googleapis.com` for tokens. The one exception is
+  the two `fiyat_analizi` tools, which read public purchasing-power figures from
+  `api.worldbank.org` (no key, nothing of yours is sent). There's no server in
+  the middle; data flows directly between your machine and Apple/Google.
 
 ---
 

package/README.tr.md

@@ -62,8 +62,8 @@ Google ile konuşur, anahtarın Anahtar Zinciri'nden dışarı çıkmaz.
 | [🧑‍💻 Elle kurulum](#-elle-kurulum) | Asistan kullanmıyorsan |
 | [🧩 İki mağaza karışır mı?](#-iki-mağaza-karışır-mı) | Hayır — nedeni burada |
 | [💬 Ne sorabilirsin](#-ne-sorabilirsin) | Örnek komutlar |
-| [🧰 Araçlar](#-araçlar) | 32 aracın tam listesi |
-| [🌐 Tam API erişimi](#-tam-api-erişimi) | 1440 operasyon, ~6.000 token |
+| [🧰 Araçlar](#-araçlar) | 39 aracın tam listesi |
+| [🌐 Tam API erişimi](#-tam-api-erişimi) | 1440 operasyon, ~8.500 token |
 | [🔑 Gereken izinler](#-gereken-izinler) | Apple ve Google tarafında ne şart |
 | [🔒 Güvenlik](#-güvenlik) | Anahtarlar, onay kapıları, telemetri |
 | [🩺 Sorun giderme](#-sorun-giderme) | Sık karşılaşılan hatalar |
@@ -270,10 +270,10 @@ belleğe bile alınmaz, modele gösterilmez, token harcamaz.
 
 | Kurulum | Yüklenen araç |
 | --- | --- |
-| İki mağaza | 32 |
-| Yalnızca App Store | 19 |
-| Yalnızca Play | 13 |
-| Salt-okunur (iki mağaza) | 24 |
+| İki mağaza | 39 |
+| Yalnızca App Store | 20 |
+| Yalnızca Play | 19 |
+| Salt-okunur (iki mağaza) | 26 |
 
 **3. Çapraz araçlar yalnızca iki mağaza da açıkken var olur.** Tek mağazalı
 kurulumda hiç oluşturulmazlar — anlamları olmadığı için.
@@ -333,7 +333,7 @@ Bu araçlar yalnızca iki mağaza da bağlıyken yüklenir.
 </details>
 
 <details>
-<summary><b>App Store Connect — 16 araç</b> (<code>appstore__</code>)</summary>
+<summary><b>App Store Connect — 17 araç</b> (<code>appstore__</code>)</summary>
 
 <br>
 
@@ -350,7 +350,8 @@ Bu araçlar yalnızca iki mağaza da bağlıyken yüklenir.
 | `appstore__testflight_gruplari` | TestFlight beta gruplarını, her gruptaki test kullanıcı sayısını, genel davet linklerini ve kotalarını gösterir. |
 | `appstore__metin_guncelle` ✎ | Hazırlanmakta olan sürümün mağaza metinlerini günceller: sürüm notları, açıklama, anahtar kelimeler, tanıtım metni. |
 | `appstore__satis_raporu` | Satış/indirme raporunu TSV olarak indirir: günlük, haftalık, aylık veya yıllık; satış, ön sipariş, yükleme, abonelik, abonelik olayı, abone ve teklif kodu raporları. |
-| `appstore__abonelik_fiyat_ayarla` ✎ | Aboneliğin fiyatını **bütün ülkelerde tek seferde** ayarlar: bir fiyat verirsin (örn. USA 9.99), Apple'ın eşitleme tablosu ~175 ülkenin karşılığını çıkarır, hepsi tek istekte yazılır. |
+| `appstore__abonelik_fiyat_ayarla` ✎ | Aboneliğin fiyatını **bütün ülkelerde tek seferde** ayarlar: bir fiyat verirsin (örn. USA 9.99), Apple'ın eşitleme tablosu ~175 ülkenin karşılığını çıkarır, hepsi tek istekte yazılır. Üstüne ülkeye özel fiyat ekleyebilirsin (`{"TUR": "349.99"}`) ya da yalnızca o ülkeleri değiştirip gerisine dokunmazsın. |
+| `appstore__fiyat_analizi` | Bölgesel fiyat önerir, hiçbir şey yazmaz: Apple'ın eşit fiyatından yola çıkıp ülkenin alım gücüne (Dünya Bankası) göre yumuşatılmış indirim uygular. Fiyat asla artmaz, yarıdan fazla düşmez, zengin ülkelere dokunulmaz. Çıktısı doğrudan `abonelik_fiyat_ayarla`'ya verilir. |
 | `appstore__iap_fiyat_ayarla` ✎ | Tek seferlik satın almanın fiyatını tek bir taban ülkeden ayarlar; gerisini Apple doldurur. |
 | `appstore__abonelik_ulkeleri` ✎ | Aboneliği bütün ülkelerde (ya da verdiklerinde) tek istekte satışa açar. |
 | `appstore__abonelik_kur` ✎ | Sıfırdan abonelik kurar, tek onayla: grup → abonelik → dil metinleri → satış ülkeleri → bütün ülkelerde fiyat. |
@@ -359,7 +360,7 @@ Bu araçlar yalnızca iki mağaza da bağlıyken yüklenir.
 </details>
 
 <details>
-<summary><b>Google Play — 10 araç</b> (<code>play__</code>)</summary>
+<summary><b>Google Play — 16 araç</b> (<code>play__</code>)</summary>
 
 <br>
 
@@ -374,7 +375,13 @@ Bu araçlar yalnızca iki mağaza da bağlıyken yüklenir.
 | `play__urunler` | Tek seferlik ürünleri listeler; yeni (`oneTimeProducts`) ve eski (`inappproducts`) modelin ikisini de dener. |
 | `play__satin_alma_dogrula` | Bir satın alma token'ını doğrular: abonelik durumu, onay durumu, bitiş tarihi, test satın alması mı. |
 | `play__iade_edilenler` | İptal edilmiş, iade edilmiş veya geri alınmış satın almaları listeler; iade sebebini ve kaynağını okunur hale getirir. Google yalnızca son 30 günü verir. |
-| `play__cokme_orani` | Android vitals çökme oranını, ölçüme giren farklı kullanıcı sayısıyla birlikte günlük olarak getirir. |
+| `play__cokme_orani` | Android vitals: çökme ve ANR oranları (Play'in kötü davranış eşiğinde baktığı "algılanan" oranlar dahil), eşik aşıldı mı, en sık çökme kümeleri ve stack trace'leri. Tek bir sürüm koduna daraltılabilir. |
+| `play__surum_yayinla` ✎ | AAB/APK'yı yükleyip bir kanala yayınlar, tek onayla: yükle → kanala ata → sürüm notları → commit. Yüzde verirsen kademeli yayın (örn. production %10). Bir adım düşerse hiçbir şey commit edilmez. |
+| `play__yayin_yonet` ✎ | Kanalı yönetir: rollout yüzdesini değiştir, durdur, sürdür, tamamla, sürümü başka kanala taşı (internal → production) ya da yalnızca sürüm notlarını güncelle. Önizlemede kanalın önceki ve sonraki hali görünür. |
+| `play__listeleme_guncelle` ✎ | Mağaza metinlerini (başlık, kısa ve tam açıklama, video) okur ya da bütün dillerde tek oturumda günceller. |
+| `play__gorsel_yukle` ✎ | Ekran görüntüsü, ikon veya öne çıkan görsel yükler; istersen eskilerini önce siler. |
+| `play__abonelik_fiyat_ayarla` ✎ | Bir temel planın fiyatını USD fiyattan bütün ülkelerde tek seferde ayarlar (Google'ın kendi çevirisiyle); üstüne ülkeye özel fiyat eklenebilir ya da yalnızca verdiğin ülkeler değişir. |
+| `play__fiyat_analizi` | Play için bölgesel fiyat önerir, hiçbir şey yazmaz: App Store'dakiyle aynı alım gücü mantığı, mağazada doğal görünen yerel fiyatlara yuvarlanır. |
 
 </details>
 
@@ -420,7 +427,7 @@ hiçbirini kullanmasan bile her mesajda yeniden ödenir.
 
 | | Araç | Her mesajda ödenen |
 | --- | --- | --- |
-| **magaza-mcp** | 32 | **~6.000 token** |
+| **magaza-mcp** | 39 | **~8.500 token** |
 | Hepsi ayrı araç olsaydı | 1440 | ~210.000 token |
 
 > [!NOTE]
@@ -472,8 +479,8 @@ analitik raporlar daha yüksek yetki ister.
   onayladıktan sonra `onayla=true` ile tekrarlandığında yürür. Bu **sunucu
   tarafında** uygulanır — istemcinin onay arayüzüne bağlı değildir.
 - **Salt-okunur mod.** `--salt-okunur` (veya `SALT_OKUNUR=1`) yazma yapan
-  araçları listeden tamamen çıkarır: model onları göremez, çağıramaz. 32 araç
-  24'e düşer. `magaza__cagir` listede kalır çünkü okuma uçlarının da tek
+  araçları listeden tamamen çıkarır: model onları göremez, çağıramaz. 39 araç
+  26'ya düşer. `magaza__cagir` listede kalır çünkü okuma uçlarının da tek
   kapısıdır — ama yazma operasyonu istendiğinde reddeder.
 - **Yol parametreleri doğrulanır.** Araçlara verilen kimlikler URL'e girmeden
   önce kodlanır; `.` ve `..` gibi yol gezinme denemeleri reddedilir. Mutlak
@@ -490,8 +497,11 @@ analitik raporlar daha yüksek yetki ister.
 - **Telemetri yok.** Hiçbir analitik, hata raporu veya kullanım verisi
   gönderilmez. Ağ trafiği yalnızca `api.appstoreconnect.apple.com`,
   `androidpublisher.googleapis.com`, `playdeveloperreporting.googleapis.com` ve
-  token için `oauth2.googleapis.com` adreslerine gider. Araya giren bir sunucu
-  yoktur; veri doğrudan senin makinenle Apple ve Google arasında akar.
+  token için `oauth2.googleapis.com` adreslerine gider. Tek istisna iki
+  `fiyat_analizi` aracı: herkese açık alım gücü verisini
+  `api.worldbank.org`'dan okur (anahtarsız, senden hiçbir veri gitmez). Araya
+  giren bir sunucu yoktur; veri doğrudan senin makinenle Apple ve Google
+  arasında akar.
 
 ---
 

package/dist/src/araclar/alim-gucu.js

@@ -0,0 +1,50 @@
+/**
+ * Ülkelerin fiyat seviyesi — bölgesel fiyat önerileri için.
+ *
+ * App Store ve Play analiz araçları ortak kullanır.
+ */
+let _alimGucu;
+/**
+ * Dünya Bankası'ndan ülkelerin fiyat seviyesi verisini çeker.
+ *
+ * Hane tüketimi PPP çevrim katsayısı / resmi kur: ABD = 1, Türkiye ≈ 0.45,
+ * Hindistan ≈ 0.23. Anahtarsız, herkese açık veri; bizden hiçbir şey gitmez.
+ */
+export function alimGucuVerisi() {
+    const getir = async (gosterge) => {
+        const yanit = await fetch(`https://api.worldbank.org/v2/country/all/indicator/${gosterge}?format=json&mrnev=1&per_page=500`, { signal: AbortSignal.timeout(10_000) });
+        const [, veri] = (await yanit.json());
+        if (!Array.isArray(veri))
+            throw new Error(`Dünya Bankası ${gosterge} verisi gelmedi.`);
+        return new Map(veri
+            .filter((x) => x?.value != null && x?.countryiso3code)
+            // Apple ülkeleri 3 harfle (TUR), Play 2 harfle (TR) yazıyor; ikisini de anahtar yapıyoruz.
+            .flatMap((x) => {
+            const kayit = { deger: Number(x.value), yil: String(x.date) };
+            return [[x.countryiso3code, kayit], [x.country?.id, kayit]];
+        })
+            .filter(([u]) => !!u));
+    };
+    _alimGucu ??= Promise.all([getir("PA.NUS.PRVT.PP"), getir("PA.NUS.FCRF")])
+        .then(([ppp, kur]) => ({ ppp, kur }))
+        .catch((hata) => {
+        _alimGucu = undefined;
+        throw new Error(`Alım gücü verisi alınamadı (api.worldbank.org): ${hata.message}`);
+    });
+    return _alimGucu;
+}
+/**
+ * Bir ülkenin fiyat seviyesi (ABD = 1).
+ *
+ * Mağaza avroyla satıyorsa avro kuru kullanılır: avroya yeni geçen ülkelerde
+ * (Bulgaristan 2026) PPP avroya çevrilmiş ama kur serisi eski parada kalmış,
+ * oran yarıya düşüyordu. İki seri farklı yıldansa (Arjantin'de PPP 2021, kur
+ * 2025) oran anlamsız; o ülke atlanır.
+ */
+export function fiyatSeviyesi(v, ulke, para) {
+    const p = v.ppp.get(ulke);
+    const k = para === "EUR" ? v.kur.get("DEU") : v.kur.get(ulke);
+    if (!p || !k || k.yil !== p.yil || !(k.deger > 0))
+        return undefined;
+    return p.deger / k.deger;
+}

package/dist/src/araclar/appstore-yazma.js

@@ -6,10 +6,14 @@
  * 175 ülke × (önizleme + onay) ≈ 350 araç çağrısı. Buradaki araçlar döngüyü
  * sunucuda koşturur; model yalnızca bir önizleme ve bir onay görür.
  *
+ * appstore__fiyat_analizi da burada: yazmaz, ama ülkeye özel fiyat önerisini
+ * abonelik_fiyat_ayarla'nın doğrudan kabul ettiği biçimde üretir.
+ *
  * Yollar ve gövdeler Apple OpenAPI 4.5'e karşı doğrulandı; standart
  * aboneliğin planType'ı canlı hesapta UPFRONT okundu.
  */
 import { cagir, tumunuGetir } from "../istemci/apple.js";
+import { alimGucuVerisi, fiyatSeviyesi } from "./alim-gucu.js";
 import { kimlik, metin, onayIste, onaySemasi, parca, ulkeKodu } from "./appstore.js";
 /** Fiyat noktası uçları tek sayfada 8000 kayda izin verir (ABD'de ~800 nokta). */
 const FIYAT_SAYFASI = 8000;
@@ -328,6 +332,79 @@ async function beyanOku(appInfoId) {
     return yanit?.data;
 }
 /* ------------------------------------------------------------------ */
+/* Ülkeye özel fiyat                                                   */
+/* ------------------------------------------------------------------ */
+/**
+ * Birden çok ülkenin fiyat basamaklarını getirir.
+ *
+ * `filter[territory]` liste kabul ediyor; ülke başına ~800-850 basamak var,
+ * 9 ülke tek 8000'lik sayfaya sığıyor. 120 ülke = 14 istek, altışar paralel.
+ */
+async function ulkeNoktalari(aboneId, ulkeler) {
+    const gruplar = [];
+    for (let i = 0; i < ulkeler.length; i += 9)
+        gruplar.push(ulkeler.slice(i, i + 9));
+    const sonuc = new Map();
+    for (let i = 0; i < gruplar.length; i += 6) {
+        const sayfalar = await Promise.all(gruplar.slice(i, i + 6).map((grup) => tumunuGetir(`/v1/subscriptions/${parca(aboneId, "abonelik_id")}/pricePoints`, {
+            "filter[territory]": grup.join(","),
+            include: "territory",
+            "fields[subscriptionPricePoints]": "customerPrice,proceeds,territory",
+            "fields[territories]": "currency",
+        }, FIYAT_SAYFASI * 2, FIYAT_SAYFASI)));
+        for (const { data, included } of sayfalar) {
+            const paralar = new Map();
+            for (const t of included)
+                if (t?.type === "territories")
+                    paralar.set(t.id, t.attributes?.currency);
+            for (const n of data) {
+                const u = n.relationships?.territory?.data?.id;
+                if (!u)
+                    continue;
+                if (!sonuc.has(u))
+                    sonuc.set(u, []);
+                sonuc.get(u).push({
+                    ulke: u,
+                    nokta: n.id,
+                    fiyat: n.attributes?.customerPrice,
+                    gelir: n.attributes?.proceeds,
+                    para: paralar.get(u),
+                });
+            }
+        }
+    }
+    return sonuc;
+}
+function enYakin(noktalar, hedef) {
+    return noktalar.reduce((a, b) => Math.abs(Number(b.fiyat) - hedef) < Math.abs(Number(a.fiyat) - hedef) ? b : a);
+}
+/**
+ * Ülkeye özel fiyatları geçerli basamaklara oturtur.
+ *
+ * Apple keyfi fiyat kabul etmiyor ("150 TL" yok, 149.99 var); en yakın
+ * basamak seçilir ve önizlemede istenenle birlikte gösterilir.
+ */
+async function ozelSatirlar(aboneId, ham) {
+    if (!ham || typeof ham !== "object" || Array.isArray(ham)) {
+        throw new Error("ozel_fiyatlar bir nesne olmalı, örn. {\"TUR\": \"349.99\", \"IND\": \"499\"}.");
+    }
+    const istenen = new Map();
+    for (const [u, f] of Object.entries(ham))
+        istenen.set(ulkeKodu(u), fiyatSayisi(f, `${u} fiyatı`));
+    const noktalar = await ulkeNoktalari(aboneId, [...istenen.keys()]);
+    const satirlar = [];
+    const notlar = [];
+    for (const [u, f] of istenen) {
+        const liste = noktalar.get(u);
+        if (!liste?.length)
+            throw new Error(`${u} için fiyat basamağı bulunamadı; ülke kodu doğru mu (3 harf, örn. TUR)?`);
+        const s = enYakin(liste, f);
+        satirlar.push(s);
+        notlar.push(`${u}: ${s.fiyat} ${s.para ?? ""}`.trim() + (Number(s.fiyat) !== f ? ` (istenen ${f}, en yakın basamak)` : ""));
+    }
+    return { satirlar, notlar };
+}
+/* ------------------------------------------------------------------ */
 /* Araçlar                                                             */
 /* ------------------------------------------------------------------ */
 // Tip birleşimi (string|number) bazı istemcilerin şema denetiminden geçmiyor;
@@ -342,17 +419,26 @@ export function appstoreYazmaAraclari() {
     return [
         {
             ad: "appstore__abonelik_fiyat_ayarla",
-            aciklama: "Bir aboneliğin fiyatını TÜM ülkelerde tek seferde ayarlar. Tek bir ülkedeki " +
-                "fiyatı verirsin (varsayılan USA), Apple'ın eşitleme tablosu ~175 ülkenin " +
-                "karşılığını çıkarır ve hepsi tek istekte yazılır. Ülke ülke magaza__cagir ile " +
-                "subscriptionPrices yazma; bu araç onun yerine geçer. Önizlemede ülke sayısı ve " +
-                "örnek fiyatlar döner.",
+            aciklama: "Bir aboneliğin fiyatını ayarlar; döngü sunucuda, tek onayla. Ülke ülke " +
+                "magaza__cagir ile subscriptionPrices yazma, bu araç onun yerine geçer.\n" +
+                "- fiyat: bir ülkedeki fiyat (varsayılan USA); Apple'ın eşitleme tablosu " +
+                "~175 ülkenin karşılığını çıkarır, hepsi yazılır.\n" +
+                "- ozel_fiyatlar: {\"TUR\": \"349.99\"} gibi ülkeye özel fiyatlar. fiyat ile " +
+                "birlikte verilirse eşitlemenin üstüne yazılır; tek başına verilirse yalnızca " +
+                "o ülkeler değişir, diğerlerine dokunulmaz.\n" +
+                "Fiyat en yakın geçerli Apple basamağına oturtulur ve önizlemede gösterilir.",
             girdiSemasi: {
                 type: "object",
                 properties: {
                     abonelik_id: metin("appstore__abonelikler'den gelen abonelik id'si."),
                     fiyat: fiyatSemasi,
                     ulke: ulkeSemasi,
+                    ozel_fiyatlar: {
+                        type: "object",
+                        description: "Ülke kodu → o ülkenin para biriminde fiyat, örn. {\"TUR\": \"349.99\", " +
+                            "\"IND\": \"499\"}. appstore__fiyat_analizi'nin ozel_fiyatlar çıktısı olduğu gibi verilebilir.",
+                        additionalProperties: { type: "string" },
+                    },
                     mevcut_aboneleri_koru: {
                         type: "boolean",
                         description: "Fiyat değişikliğinde mevcut aboneler eski fiyattan devam etsin mi " +
@@ -361,19 +447,34 @@ export function appstoreYazmaAraclari() {
                     baslangic: baslangicSemasi,
                     onayla: onaySemasi,
                 },
-                required: ["abonelik_id", "fiyat"],
+                required: ["abonelik_id"],
             },
             yazma: true,
             async calistir(girdi) {
-                const fiyat = fiyatSayisi(girdi.fiyat);
+                const tabanVar = girdi.fiyat !== undefined && girdi.fiyat !== "";
+                if (!tabanVar && girdi.ozel_fiyatlar === undefined) {
+                    throw new Error("fiyat ya da ozel_fiyatlar vermelisin.");
+                }
+                const fiyat = tabanVar ? fiyatSayisi(girdi.fiyat) : undefined;
                 const ulke = ulkeKodu(girdi.ulke) ?? "USA";
                 const koru = girdi.mevcut_aboneleri_koru !== false;
                 const baslangic = tarih(girdi.baslangic);
-                const matris = await abonelikMatrisi(girdi.abonelik_id, fiyat, ulke);
+                const [esit, ozel] = await Promise.all([
+                    fiyat !== undefined ? abonelikMatrisi(girdi.abonelik_id, fiyat, ulke) : [],
+                    girdi.ozel_fiyatlar !== undefined
+                        ? ozelSatirlar(girdi.abonelik_id, girdi.ozel_fiyatlar)
+                        : { satirlar: [], notlar: [] },
+                ]);
+                const ozelUlkeler = new Set(ozel.satirlar.map((s) => s.ulke));
+                const matris = [...esit.filter((s) => !ozelUlkeler.has(s.ulke)), ...ozel.satirlar];
                 if (girdi.onayla !== true) {
-                    return onayIste(`PATCH /v1/subscriptions/${girdi.abonelik_id} (${matris.length} ülke)`, `Aboneliğin fiyatını ${ulke} ${fiyat} baz alınarak ${matris.length} ülkede ayarlar.`, {
+                    return onayIste(`PATCH /v1/subscriptions/${girdi.abonelik_id} (${matris.length} ülke)`, fiyat !== undefined
+                        ? `Aboneliğin fiyatını ${ulke} ${fiyat} baz alınarak ${matris.length} ülkede ayarlar` +
+                            (ozel.satirlar.length ? `; ${ozel.satirlar.length} ülkede özel fiyat.` : ".")
+                        : `Yalnızca ${matris.length} ülkenin fiyatını değiştirir; diğer ülkelere dokunmaz.`, {
                         ulke_sayisi: matris.length,
-                        ornek_fiyatlar: ornekler(matris),
+                        ornek_fiyatlar: fiyat !== undefined ? ornekler(esit) : undefined,
+                        ozel_fiyatlar: ozel.notlar.length ? ozel.notlar : undefined,
                         mevcut_aboneleri_koru: koru,
                         baslangic: baslangic ?? "hemen",
                     });
@@ -381,6 +482,89 @@ export function appstoreYazmaAraclari() {
                 return abonelikFiyatYaz(girdi.abonelik_id, matris, koru, baslangic);
             },
         },
+        {
+            ad: "appstore__fiyat_analizi",
+            aciklama: "Ülkelere özel fiyat önerir (bölgesel fiyatlandırma); hiçbir şey yazmaz. Bir " +
+                "taban fiyattan (örn. USA 9.99) Apple'ın eşitlediği yerel fiyatı alır, ülkenin " +
+                "alım gücüne (Dünya Bankası fiyat seviyesi) göre yumuşatılmış bir indirim " +
+                "hesaplar ve en yakın geçerli Apple basamağına oturtur. Fiyatı öldürmemek için " +
+                "indirim sınırlı: zengin ülkelere dokunulmaz, hiçbir ülke eşit fiyatın " +
+                "en_dusuk_oran'ının altına inmez, hiçbir fiyat artırılmaz. Öneriyi kullanıcıya " +
+                "göster, isterse ülke ülke düzelt, sonra appstore__abonelik_fiyat_ayarla'ya " +
+                "fiyat + ozel_fiyatlar olarak ver.",
+            girdiSemasi: {
+                type: "object",
+                properties: {
+                    abonelik_id: metin("appstore__abonelikler'den gelen abonelik id'si."),
+                    fiyat: fiyatSemasi,
+                    ulke: ulkeSemasi,
+                    yansitma: {
+                        type: "number",
+                        description: "Alım gücü farkının ne kadarı fiyata yansısın, 0-1 (varsayılan 0.4). " +
+                            "0 = indirim yok, 1 = farkın tamamı (agresif). 0.4'te Türkiye ~%27, Hindistan ~%44 iner.",
+                    },
+                    en_dusuk_oran: {
+                        type: "number",
+                        description: "Hiçbir ülke eşit fiyatın bu oranının altına inmesin (varsayılan 0.5 = en fazla %50 indirim).",
+                    },
+                },
+                required: ["abonelik_id", "fiyat"],
+            },
+            async calistir(girdi) {
+                const fiyat = fiyatSayisi(girdi.fiyat);
+                const ulke = ulkeKodu(girdi.ulke) ?? "USA";
+                const yansitma = Math.min(1, Math.max(0, Number(girdi.yansitma ?? 0.4) || 0));
+                const taban = Math.min(1, Math.max(0.1, Number(girdi.en_dusuk_oran ?? 0.5) || 0.5));
+                const [matris, veri] = await Promise.all([
+                    abonelikMatrisi(girdi.abonelik_id, fiyat, ulke),
+                    alimGucuVerisi(),
+                ]);
+                const cipaOrani = fiyatSeviyesi(veri, ulke, matris[0]?.para) ?? 1;
+                // %15'ten küçük indirim gürültü: İtalya'yı %12 indirmek geliri düşürür, satışı
+                // pek artırmaz. Batı Avrupa ve Japonya eşit fiyatta kalır.
+                const adaylar = matris
+                    .map((s) => {
+                    const o = fiyatSeviyesi(veri, s.ulke, s.para);
+                    if (!o || s.ulke === ulke)
+                        return undefined;
+                    const goreli = o / cipaOrani;
+                    const carpan = Math.min(1, Math.max(taban, goreli ** yansitma));
+                    return carpan <= 0.85 ? { s, goreli, carpan } : undefined;
+                })
+                    .filter((x) => x !== undefined);
+                const noktalar = await ulkeNoktalari(girdi.abonelik_id, adaylar.map((a) => a.s.ulke));
+                const oneriler = [];
+                for (const { s, goreli, carpan } of adaylar) {
+                    const liste = noktalar.get(s.ulke);
+                    if (!liste?.length)
+                        continue;
+                    const yeni = enYakin(liste, Number(s.fiyat) * carpan);
+                    const indirim = Math.round((1 - Number(yeni.fiyat) / Number(s.fiyat)) * 100);
+                    if (indirim < 10)
+                        continue;
+                    oneriler.push({
+                        ulke: s.ulke,
+                        fiyat: yeni.fiyat,
+                        indirim,
+                        satir: `${s.ulke}: ${s.fiyat} → ${yeni.fiyat} ${s.para ?? ""} ` +
+                            `(-%${indirim}, alım gücü ${goreli.toFixed(2)})`,
+                    });
+                }
+                oneriler.sort((a, b) => b.indirim - a.indirim);
+                return {
+                    taban: `${ulke} ${fiyat}`,
+                    esit_kalan_ulke: matris.length - oneriler.length,
+                    indirimli_ulke: oneriler.length,
+                    oneriler: oneriler.map((o) => o.satir),
+                    ozel_fiyatlar: Object.fromEntries(oneriler.map((o) => [o.ulke, o.fiyat])),
+                    ayarlar: { yansitma, en_dusuk_oran: taban },
+                    kaynak: "Alım gücü: Dünya Bankası, hane tüketimi PPP / resmi kur (en güncel yıl). " +
+                        "Verisi olmayan ülkeler (ör. Tayvan) eşit fiyatta kalır.",
+                    not: "Hiçbir şey yazılmadı. Kullanıcıya önerileri göster; onaylarsa " +
+                        "appstore__abonelik_fiyat_ayarla'ya fiyat ve bu ozel_fiyatlar ile çağır.",
+                };
+            },
+        },
         {
             ad: "appstore__iap_fiyat_ayarla",
             aciklama: "Tek seferlik uygulama içi satın almanın fiyatını ayarlar. Bir ülkedeki fiyatı " +

package/dist/src/araclar/dispatch.js

@@ -121,7 +121,7 @@ const YAZMA_YONTEMLERI = new Set(["POST", "PATCH", "PUT", "DELETE"]);
  * çalışmaz. `:batchMigratePrices` gibi gerçek toplu yazma uçları bu listeye
  * girmesin diye ek adı tam olarak eşleştiriliyor.
  */
-const OKUYAN_POST_EKLERI = [":query", ":batchGet", ":search", ":lookup"];
+const OKUYAN_POST_EKLERI = [":query", ":batchGet", ":search", ":lookup", ":convertRegionPrices"];
 /**
  * İkinci emniyet: ekin adı kadar operasyonun kendi açıklaması da okuma
  * demeli. Google ileride `:batchGet` gibi görünen ama yazan bir uç eklerse
@@ -129,7 +129,7 @@ const OKUYAN_POST_EKLERI = [":query", ":batchGet", ":search", ":lookup"];
  * "Reads / Queries / Searches / Gets / Lists" ile başlamıyorsa yazma sayıp
  * onay isteriz. Bugünkü 19 ucun 19'u bu kalıba uyuyor.
  */
-const OKUMA_OZETI = /^(read|quer|search|look ?up|get|list|fetch|retriev)/i;
+const OKUMA_OZETI = /^(read|quer|search|look ?up|get|list|fetch|retriev|calculat)/i;
 function yazmaIslemiMi(op) {
     if (!YAZMA_YONTEMLERI.has(op.yontem))
         return false;
@@ -184,7 +184,8 @@ export function dispatchAraclari() {
             "yöntemini döndürür. Sonucu magaza__cagir ile çalıştırabilirsin. " +
             "Örnek sorgular: 'subscription price', 'testflight tester', 'crash rate'. " +
             "Abonelik/IAP fiyatı, abonelik kurulumu ve yaş derecelendirmesi için " +
-            "hazır appstore__ araçları var; onları tercih et.",
+            "hazır appstore__ araçları; Play'de sürüm yayınlama, rollout, mağaza " +
+            "metni, görsel ve abonelik fiyatı için hazır play__ araçları var. Onları tercih et.",
         girdiSemasi: {
             type: "object",
             properties: {
@@ -293,6 +294,11 @@ export function dispatchAraclari() {
                         ? `\nBunlar mı demek istedin?\n  ${yakin.map((y) => y.ad).join("\n  ")}`
                         : "\nmagaza__endpoint_ara ile arayabilirsin."));
             }
+            // Katalogdaki yükleme uçları ham dosya baytı ister; JSON gövdeyle hep düşüyordu.
+            if (magaza === "play" && /\.upload[a-z]*$/i.test(op.ad)) {
+                throw new Error(`'${op.ad}' dosya yükler; magaza__cagir dosya gönderemez. AAB/APK için ` +
+                    "play__surum_yayinla, ekran görüntüsü ve ikon için play__gorsel_yukle kullan.");
+            }
             const yazma = yazmaIslemiMi(op);
             if (yazma && magaza === "appstore")
                 govdeTamamla(op, girdi);

package/dist/src/araclar/ortak.js

@@ -7,7 +7,7 @@
  */
 import { cagir as appleCagir } from "../istemci/apple.js";
 import { cagir as playCagir } from "../istemci/play.js";
-import { yolParcasi } from "./play.js";
+import { paraBicimle, yolParcasi } from "./play.js";
 import { acikMagazalar } from "./tip.js";
 const metin = (aciklama) => ({ type: "string", description: aciklama });
 /** Bir isteği çalıştırır; patlarsa hatayı sonuç olarak döndürür. */
@@ -254,11 +254,11 @@ export function ortakAraclar() {
                                 plan_id: p.basePlanId,
                                 isim: a.listings?.[0]?.title,
                                 sure: p.autoRenewingBasePlanType?.billingPeriodDuration ??
-                                    p.prepaidBasePlanType?.billingPeriodDuration,
+                                    p.prepaidBasePlanType?.billingPeriodDuration ??
+                                    p.installmentsBasePlanType?.billingPeriodDuration,
                                 durum: p.state,
-                                fiyat: bolge?.price
-                                    ? `${(Number(bolge.price.units || 0) + Number(bolge.price.nanos || 0) / 1e9).toFixed(2)} ${bolge.price.currencyCode}`
-                                    : undefined,
+                                // toFixed(2) JPY'de kuruş uyduruyor, TND'de (3 hane) yuvarlıyordu.
+                                fiyat: paraBicimle(bolge?.price),
                             };
                         }));
                         return { uygulama: uygulama.displayName, abonelikler };