Web Sitesi Ağ Trafiğini OpenCode Browse ile API Şemasına Dönüştürün

OpenCode Browse, kodlama ajanınızın oturum açmış haldeyken bir sitenin yaptığı API çağrılarını yakalamasını sağlar. Bu trafiği nasıl bir OpenAPI şartnamesine dönüştürüp Apidog CLI ile nasıl test edeceğinizi, tek bir ajan komutuyla burada öğrenin.

Ashley Innocent

Ashley Innocent

17 November 2026

Web Sitesi Ağ Trafiğini OpenCode Browse ile API Şemasına Dönüştürün

Kurumsal İçin Apidog

Şirket İçi (On-Premises) Dağıtım

SSO ve RBAC

SOC 2 Uyumlu

Apidog Enterprise'ı Keşfedin

Web sitesi ağ trafiğini bir API spesifikasyonuna dönüştürmek için, kodlama ajanınızın OpenCode Browse ile gerçek tarayıcınızı kullanmasına izin verin: ajan bir sekmede network yakalama başlatır, siz oturum açmışken siteyi gezer, sonra ajan yakalamayı durdurarak kimlik bilgileri sansurlanmış şekilde her isteği elde eder. Ardından ajan bu etkileşimlerden bir OpenAPI dosyası yazar; Apidog CLI bu dosyayı içe aktarır ve ona karşı bir test çalıştırır.

Bu rehber, tek bir ajan komutuyla bu döngüyü adım adım ele alıyor: Browse'ın neyi yakaladığını, neyi gizlediğini ve işi tamamlayan apidog komutlarını.

OpenCode Browse nedir?

OpenCode Browse, kodlama ajanınızın sekmeleriniz, oturumlarınız ve uzantılarınızla gerçek tarayıcınızı kullanmasını sağlayan bir MCP sunucusu ve bir Chromium uzantısından oluşur. Ajanlar arka plan sekmeleri açar, sayfaları okur, tıklar, yazar, ekran görüntüsü alır, sekmeleri kaydeder ve ağ trafiğini yakalar. Bir adım sizin müdahalenizi gerektirdiğinde (bir oturum açma, bir 2FA istemi, bir ödeme), ajan sekmeyi size geri verir ve Devam'a tıklamanızı bekler.

Öğe Kaynağın söylediği
Lisans MIT (deposundaki LICENSE dosyası)
İlk halka açık kod Depo 27 Ekim 2026'da oluşturuldu
Güncel sürüm v0.1.0, 16 Kasım 2026'da yayınlandı (tek bir Rust ikili dosyası olarak yeniden yazım)
Tarayıcılar Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera, Chromium
Ajanlar OpenCode, Claude Code, Codex, Cursor, Zed ve yaklaşık 30 MCP istemcisi daha
Fiyatlandırma Ürün sayfasında belirtilmemiş

Ürün sayfasında fiyat veya lansman tarihi listelenmiyor, bu yüzden bugün doğrulayabileceğiniz tek maliyet sinyali olarak MIT lisansını kabul edin. DevTools yöntemiyle karşılaştırıyorsanız, Claude ile Chrome DevTools MCP rehberimiz alternatifi ele alıyor.

Neden gerçek tarayıcınızdan trafik yakalamalısınız?

Çoğu belgelenmemiş API bir oturum açma arkasındadır. Headless bir tarayıcı hiç çerez olmadan başlar, bu yüzden ajanınız bir oturum açma duvarına çarpar. Browse zaten kullandığınız profilin içinde çalışır, böylece ajan sizin gördüğünüz aynı kimlik doğrulamalı istekleri görür. Bu, üç işte yardımcı olur:

Manuel sürüm, DevTools'tan bir HAR dışa aktarmasıdır; API tersine mühendisliği rehberimize bakın. Ajan sürümü spesifikasyonu sizin için yazar.

Pipeline diagram: a signed-in browser tab feeds a Browse network capture with credentials redacted, a coding agent writes openapi.json from it, and Apidog CLI imports the file, creates a test case and runs it

Web sitesi ağ trafiğini bir API spesifikasyonuna dönüştürme: 5 adım

  1. Browse'ı kurun ve uzantıyı tarayıcınızla eşleştirin.
  2. Ajanınızdan siteyi bir Browse sekmesinde açmasını ve XHR ve Fetch'e filtrelenmiş bir network yakalama başlatmasını isteyin.
  3. Belgelenmesini istediğiniz özelliklerde gezinin, ardından ajana yakalamayı durdurmasını söyleyin.
  4. Ajanın etkileşimleri yollara gruplandırmasını ve openapi.json dosyasını yazmasını sağlayın.
  5. Spesifikasyonu Apidog CLI ile içe aktarın, bir test vakası oluşturun ve çalıştırın.

Adım 1: Browse'ı kurun ve ajanınızı bağlayın

Browse, macOS ve Linux'ta tek bir komut dosyasıyla kurulur:

curl -fsSL https://opencode.ai/browse/install | bash

Windows'ta PowerShell'de irm https://opencode.ai/browse/install.ps1 | iex komutunu çalıştırın. Ayrıca npm i -g @opencode/browse kullanıp ardından browse install çalıştırabilirsiniz.

browse install ikili dosyayı yerine koyar, bulduğu ajanlara Browse MCP sunucusunu ekler ve Chrome Web Mağazası uzantısını eşleştirir. Etkileşimli seçiciyi atlamak için:

browse install -a claude codex   # yalnızca Claude Code ve Codex
browse install -y                # bu bilgisayarda bulunan tüm ajanlar

Sonrasında ajanınızı yeniden başlatın. browse status, aktarıcının, uzantının ve eşleştirmenin sağlıklı olup olmadığını bildirir.

Bir ayrıntı, ajanınızın nasıl çalıştığını değiştirir. OpenCode düz araçlar alır (navigate, snapshot, click, network ve diğerleri). Claude Code, Codex, Cursor ve diğer istemciler, her Browse aracını çağırabilen JavaScript çalıştıran execute ile birlikte execute, status ve tabs araçlarını alır. Her durumda, ajan aynı network yakalamaya ulaşır.

Adım 2: Filtrelenmiş bir ağ yakalama başlatın

network aracı, start, status, stop veya cancel değerlerinden birini alan bir action parametresi alır; sekme başına bir yakalama. start üzerinde neyi kaydedeceğini daraltabilirsiniz:

Seçenek Ne yapar Varsayılan
urlFilter Yalnızca bu metni içeren URL'leri yakalar Yok
resourceTypes Yalnızca bu türleri yakalar, örneğin ["XHR", "Fetch"] Tüm türler
methods Yalnızca bu HTTP metotlarını yakalar Tüm metotlar
bodies İstek ve yanıt gövdelerini yakalar true
maxDurationMs Bu süre sonunda yakalamayı bitirir ve atar 1.800.000 (30 dakika)

XHR ve Fetch'e filtreleyin ve analiz isteklerini (beacon) atlamak için /api/ gibi bir urlFilter ekleyin. Çağrı şöyle görünür:

{
  "action": "start",
  "tab": "<tabId>",
  "resourceTypes": ["XHR", "Fetch"],
  "urlFilter": "/api/"
}

Ajanı tek bir sitede tutmak için sekmeyi allowedOrigins ile açın. Browse'ın README'si bunun gezinmeyi sınırladığını, bir sayfanın kendisinin yaptığı istekleri sınırlamadığını açıkça belirtir; yani bu bir veri sınırı değil, bir güvenlik önlemidir.

Adım 3: Sitede gezinin, sonra yakalamayı durdurun

Şimdi ajanın sekmesinde siteyi kullanın: bir liste açın, filtreleyin, bir detay sayfası görüntüleyin, bir test kaydı oluşturun ve silin. Site oturum açmanızı isterse, ajan handoff çağırır, siz oturum açmayı tamamlarsınız ve Devam'a tıklarsınız.

Bitirdiğinizde, ajan {"action": "stop"} gönderir. Bu, her etkileşimi döndürür: metot, URL, başlıklar, durum ve gövdeler. Sınırları bilmeye değer:

Kimlik bilgileri her zaman [redacted] ile değiştirilir: authorization ve API anahtarı başlıkları, tüm çerez değerleri, gizli adlı sorgu, JSON ve form alanları ile token benzeri yol bölümleri. README, sıradan bir alan adı altındaki bir gizli bilginin hâlâ sızabileceği konusunda uyarır, bu yüzden paylaşmadan önce spesifikasyonu okuyun.

Planlamanız gereken bir değişiklik: 0.0.17 sürümü (14 Kasım 2026) HAR dışa aktarmayı kaldırdı ve yakalamalar artık sansurlanmış trafiği doğrudan döndürüyor. Bir HAR dosyasına ihtiyacınız varsa, DevTools'tan dışa aktarın ve HAR dosyasını Apidog'a içe aktarma rehberimizi kullanın.

Adım 4: Ajanın OpenAPI spesifikasyonunu yazmasına izin verin

Ham trafik bir spesifikasyon değildir. /api/orders/1042, /api/orders/877 ve /api/orders/15 çağrıları, tek bir yanıt şemasıyla tek bir yola, /api/orders/{orderId}'ye dönüşmelidir. Bir kodlama ajanı tam olarak bunu yapmakta iyidir: örüntüyü tespit etmek ve gerçek yanıtlardan türleri çıkarmak.

Diagram showing three captured GET requests to /api/orders/1042, /api/orders/877 and /api/orders/15 with JSON bodies, grouped by pattern into one OpenAPI path GET /api/orders/{orderId} with an integer orderId parameter and an Order response schema, with the Authorization header shown as redacted

Çıktının temiz içe aktarılması için ajanın birkaç kurala uymasını isteyin:

Adım 5: Spesifikasyonu içe aktarın ve Apidog CLI ile test edin

openapi.json oluşturulduktan sonra, gerisini aynı ajana bırakın. Apidog CLI, spesifikasyon içe aktarma, test vakaları oluşturma ve çalıştırma komutları sunar ve her komut, ajanınızın okuyabileceği yapılandırılmış JSON çıktısı verir.

Bir kez kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Ardından ajanınıza tüm işi kapsayan tek bir komut verin:

Open https://app.example.com in a Browse tab limited to app.example.com.
Start a network capture for XHR and Fetch requests whose URL contains /api/.
Hand the tab to me, wait while I use the orders pages, then stop the capture.
Write openapi.json (OpenAPI 3.1, info.title "Example Orders API") with path
parameters for IDs and schemas from the real responses. Create an AI branch in
Apidog project <projectId>, import the spec there, create a test case for
GET /api/orders/{orderId} that asserts status 200 and a numeric id, run it
against environment <envId> and summarize any failures.

Ajan aşağıdaki komutları çalıştırır. Buradaki her bayrak, Apidog CLI 2.2.12 üzerindeki apidog <cmd> --help çıktısından alınmıştır:

apidog branch create --project <projectId> --type ai \
  --name "ai/20261117-from-main-orders-capture" --from main
apidog import --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  --format openapi --file ./openapi.json
apidog endpoint list --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  --path-contains /api/orders
apidog test-case category --project <projectId> --branch "ai/20261117-from-main-orders-capture"
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  --file case.json
apidog run --test-case <caseId> --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  -e <envId> -r cli,json

Bir AI dalına içe aktarmak, yakalanan spesifikasyonu inceleyene kadar ana tasarımınızdan uzak tutar. Daha sonra yeniden yakalayıp tekrar içe aktarırsanız, info.title'ı değiştirmeden tutun veya --module-map "<info.title>=<moduleId>" iletin; böylece Apidog her birinin ikinci bir kopyasını oluşturmak yerine uç noktaları yerinde günceller.

Test geçtiğinde, aynı apidog run ... -r junit komutu doğrudan CI'a girer. Apidog CLI CI/CD rehberimiz pipeline kurulumunu gösterir, Claude Code'da Apidog CLI ise ajan tarafını daha derinlemesine ele alır.

Daha temiz bir yakalanan spesifikasyon için ipuçları

SSS

OpenCode Browse ücretsiz mi? Depo MIT lisanslıdır ve ürün sayfasında fiyat listelenmemiştir. 17 Kasım 2026 itibarıyla kaynak, bundan fazlasını doğrulamıyor; bu yüzden maliyet üzerine plan yapmadan önce sayfayı tekrar kontrol edin.

OpenCode Browse Claude Code ile çalışıyor, yoksa yalnızca OpenCode ile mi? Claude Code, Codex, Cursor, Zed ve yaklaşık 30 diğer MCP istemcisiyle çalışır. browse install -a claude Claude Code'u kurar. OpenCode düz araçlar alır, diğer istemciler ise aynı araçları JavaScript'ten çağıran bir execute aracı alır.

Browse bir HAR dosyası dışa aktarabilir mi? Artık hayır. 0.0.17 sürümü HAR dışa aktarmayı kaldırdı ve network artık sansurlanmış trafiği doğrudan yapılandırılmış veri olarak döndürüyor. Bir HAR dosyası için Chrome DevTools'tan bir tane kaydedin ve apidog import --format har ile içe aktarın.

Oturum çerezlerim veya tokenlarım spesifikasyona biter mi? Browse, authorization ve API anahtarı başlıklarını, tüm çerez değerlerini, gizli adlı alanları ve token benzeri yol bölümlerini sansürler. Sıradan bir alan adı altında saklanan bir gizli bilgi yine de görünebilir, bu yüzden paylaşmadan önce dosyayı inceleyin.

Ajanın çıktısı için hangi Apidog içe aktarma biçimini kullanmalıyım? Ajanın yazdığı spesifikasyon için --format openapi kullanın. Apidog CLI ayrıca Postman, HAR, Insomnia, Swagger 2.0 ve 20'den fazla diğer biçimi aynı apidog import komutuyla kabul eder.

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin