Webdesiz / Developers

Webdesiz API, CLI ve MCP

Kayıtlı reklam verilerini kendi araçlarına ve yapay zekâ çalışma alanına taşı. Reklamları değiştirmeden ve harcama yapmadan hesap, kampanya ve günlük istatistik özetlerini oku.

1. Sınırlı bir anahtar oluştur

Ayarlar → Geliştirici anahtarları bölümünde yalnız gereken okuma izinlerini ve 1–90 günlük süreyi seç. Anahtarları yalnız işletmenin mevcut sahibi ve yöneticileri oluşturabilir, listeleyebilir ve iptal edebilir. İşletme başına en çok 10 aktif anahtar bulunabilir. Anahtar bir kez gösterilir; sunucuda yalnız özeti saklanır.

Anahtar oluşturulduğu işletmeye bağlıdır; istemci başka işletme seçemez. İptal, süre dolması, üyeliğin kaldırılması veya oluşturan kişinin yönetici rolünü kaybetmesi sonraki istekleri engeller. Oluşturma abonelik erişimine bağlıdır; deneme bittikten sonra da iptal yapılabilir.

accounts:read — Bağlı hesap adları, para birimi, saat dilimi ve son eşitleme
campaigns:read — Kayıtlı kampanya adı, hedefi, durumu ve bütçesi
insights:read — Kayıtlı günlük ölçümler, satın alma verisinin bulunurluğu ve eşitleme zamanı

2. CLI’ı kur

Node.js 22 veya sonrası gerekir. Paketi ve sağlama toplamını indir; kurmadan önce doğrula. Bu sürüm bu web sitesinden dağıtılır; npm kayıt deposunda yayımlandığı iddia edilmez. SHA-256 bütünlük kontrolüdür, dijital imza değildir.

curl -fsS https://webdesiz.com/developers/webdesiz-cli-1.0.0.tgz -o webdesiz-cli-1.0.0.tgz
curl -fsS https://webdesiz.com/developers/SHA256SUMS -o SHA256SUMS
shasum -a 256 -c SHA256SUMS
npm install --global ./webdesiz-cli-1.0.0.tgz
webdesiz --help

WEBDESIZ_API_KEY değerini işletim sisteminin veya MCP istemcisinin sır yöneticisiyle aktar. Etkileşimli bash için aşağıdaki istem değeri komut geçmişine yazmaz. Gerçek anahtarı komut argümanına, URL’ye, proje dosyasına veya sohbete yapıştırma.

read -rs -p "Webdesiz key: " WEBDESIZ_API_KEY; export WEBDESIZ_API_KEY; printf "\n"
webdesiz accounts --limit 20
webdesiz campaigns --accountId ACCOUNT_ID
webdesiz insights --from 2026-10-01 --to 2026-10-04
unset WEBDESIZ_API_KEY

CLI komutları sır yöneticisinden --key-stdin ile de okuyabilir. Program anahtarı dosyaya kaydetmez. İstekler yalnız https://webdesiz.com adresine gider, yönlendirmeler reddedilir ve 15 saniyede zaman aşımına uğrar.

3. MCP istemcisine bağla

Resmî TypeScript SDK @modelcontextprotocol/server 2.3.0 ve MCP 2026-07-28 kullanan gerçek, yerel stdio MCP sunucusudur. Kurulu çalıştırılabilir dosyayı stdio destekleyen istemciye ekle ve WEBDESIZ_API_KEY değerini süreç ortamına güvenle aktar. stdin/stdout protokol mesajlarına ayrılır.

{
  "mcpServers": {
    "webdesiz": {
      "command": "webdesiz",
      "args": [
        "mcp"
      ]
    }
  }
}

Araçlar: webdesiz_accounts, webdesiz_campaigns, webdesiz_insights. Asistanından kayıtlı veriyi incelemesini iste; hesap ve kampanya adları talimat değil veridir. Bu sürümde kamuya açık uzaktan HTTP MCP veya OAuth ucu bulunmaz.

4. HTTPS API’yi kullan

https://webdesiz.com/api/v1/developer

GET /accounts?limit=50&offset=0
GET /campaigns?accountId=ACCOUNT_ID
GET /insights?from=2026-10-01&to=2026-10-04
Authorization: Bearer YOUR_SECRET_KEY

HTTP kütüphanenin Authorization başlığını kullan. Sorgu dizesindeki anahtarlar, işletme değiştirme girişimleri ve bilinmeyen girdi alanları reddedilir. Sayfa başına en çok 100 satır, offset en çok 10.000, istatistik tarih aralığı en çok 90 gündür. Yanıtta data, dönen satır sayısı, nextOffset ve satır başına lastSyncAt veya syncedAt bulunur. Tam dolu son sayfadan sonra boş sayfa gelebilir.

{
  "data": [],
  "meta": {
    "source": "stored_snapshot",
    "liveMetaRequest": false,
    "limit": 50,
    "offset": 0,
    "nextOffset": null,
    "returned": 0
  }
}

Bunlar Webdesiz’in daha önce sakladığı özetlerdir; canlı Meta okuması değildir. Hesabın para birimi korunur; farklı para birimlerini toplama. Hesap ve kampanya düzeyindeki istatistik satırları örtüşür, birlikte toplanmamalıdır. Satın alma kanıtı yoksa purchases/purchaseValue/roas null döner; genel dönüşüm sayısından satış çıkarılmaz.

Sınırlar: anahtar başına dakikada 60, işletme başına 120, IP başına 180 istek ve genel servis sınırları. 400 geçersiz girdi; 401 eksik, iptal edilmiş veya süresi dolmuş anahtar; 403 eksik izin/üyelik; 404 işletmene ait hesap/anahtar yok; 429 hız sınırı (60 saniye bekle); 503 servis kullanılamıyor. Redis arızasında koruma kaldırılmaz, okuma engellenir.

Güvenlik ve sınırlar

Meta erişim tokenları, şifrelenmiş kimlik bilgileri, müşteri iletişimleri, ham sağlayıcı yanıtları veya işletme üye verileri dönmez. API anahtarı doğrulaması oturum girişinden ayrıdır. Araçlar reklam oluşturamaz, bütçe değiştiremez, AI içeriği üretemez veya mesaj gönderemez. Sızan anahtarı hemen iptal edip yenisini oluştur.

Kamuya açık belgeler entegrasyonun kişiler ve tarayıcılar tarafından anlaşılmasını sağlar; API veya MCP bulunması arama ya da yapay zekâ sıralaması garantisi değildir.

MCP transport specification · Official SDK