Dokümantasyon · curl

curl ve jq ile web sayfasını Markdown'a dönüştürme

Q: Bir hatanın HTTP durumunu nasıl görürüm?

Gövdeden sonra yazdırmak için -w '\n%{http_code}\n', tüm header'ları görmek için -i ekleyin. Gövdedeki error.code, betiklerde test edilecek kararlı değerdir.

API'nin yaptığı her şey tek satırlık bir shell komutuna sığar. Bu tarifler, API'yi çağırmak için curl ve JSON içinden alan seçmek için jq kullanır; sonda Windows için bir PowerShell sürümü bulunur.

Son güncelleme: 22 Ekim 2026 · 3 dk okuma

Hızlı yanıt

Bir web sayfasını komut satırından Markdown'a nasıl dönüştürürüm?

Anahtarınızı bir Authorization: Bearer header'ında koyarak curl -sG https://webreaderapi.com/api/v1/read --data-urlencode "url=…" çalıştırın, ardından yanıtı jq -r .markdown aracılığıyla aktarın. WebReaderAPI, sayfanın ana içeriğini meta verileriyle birlikte Markdown olarak döndürür. Tek bir düz sayfa, Ekim 2026 itibarıyla $0,07/1K sayfa değerinden itibaren 1 kredi kullanır. KYC yok; kripto ile ödeme yapın.

Terminali nasıl kurarım?

Çoğu Linux ve macOS sisteminde zaten bulunan curl ve jq'yu kurun ve API anahtarınızı oturum başına bir kez export edin. Aşağıdaki tariflerin tümü anahtarı $WEBREADER_API_KEY üzerinden okur, böylece anahtar bir komutun parçası olarak shell geçmişinizde hiç görünmez.

GET istekleri için --data-urlencode ile birlikte -G kullanın: curl o zaman sayfa adresini sizin için kodlar; bu önemlidir çünkü adreslerin kendi içinde ?, & ve = bulunur.

Anahtarı ayarlayın ve bir sayfayı .md dosyası olarak kaydedin

export WEBREADER_API_KEY="your-key"

curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/guides/compost" \
  | jq -r '.markdown' > compost.md

Bir çağrının ne döndürdüğünü ve ne kadar tuttuğunu nasıl görürüm?

İçerik yerine jq'dan metadata isteyin. final_url yönlendirmelerin nereye gittiğini, rendered bir tarayıcı kullanılıp kullanılmadığını gösterir ve credits_used çağrının maliyetidir. Yanıt bir hataysa aynı filtre null alanlarını yazdırır; kodu ve mesajı okumak için .error yazdırın.

Yalnızca metadata, ya da varsa hata

curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/guides/compost" \
  | jq '.error // {title, final_url, rendered, credits_used, word_count}'

Bir sayfanın bağlantılarını nasıl listelerim?

include_links=true ekleyin ve links listesini sekme ile ayrılmış satırlara dönüştürün. Bu size bir sayfanın dışa giden bağlantılarının hızlı bir haritasını verir; sıralayabilir, grep ile filtreleyebilir veya bir toplu işe besleyebilirsiniz.

Metin ve URL olarak bağlantılar, her satırda bir tane

curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/docs/" \
  -d include_links=true \
  | jq -r '.links[] | "\(.text)\t\(.url)"' | sort -u

JavaScript ile çalışan bir sayfayı veya bir PDF'i nasıl okurum?

İçeriğini JavaScript ile oluşturan bir sayfa için -d render=true ekleyin; o zaman 2 kredi tutar. Bir PDF için özel bir şey gerekmez: URL'sini gönderin, metin markdown içinde döner. 20 MB ve 100 sayfaya kadar PDF dosyaları, başlayan her 10 sayfalık blok için 1 kredi ile Markdown'a dönüştürülür.

İşlenmiş bir sayfa, ardından bir PDF

curl -sG "https://webreaderapi.com/api/v1/read" -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/app/changelog" -d render=true \
  | jq -r '.markdown' > changelog.md

curl -sG "https://webreaderapi.com/api/v1/read" -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/files/annual-report.pdf" \
  | jq -r '.markdown' > annual-report.md

Shell'den bir toplu işi nasıl çalıştırırım?

URL'lerinizi içeren bir JSON gövdesini /batch adresine post edin, job_id değerini saklayın ve ardından işi okuyun. Küçük bir döngü, iş done olana kadar bekler ve her sayfanın başlığını veya hata kodunu yazdırır. Uzun işler için toplu iş ve tarama sayfası üzerinde gösterildiği gibi next_cursor izleyin.

Üç URL'lik toplu iş, ardından sonucu bekleyin

JOB=$(curl -s "https://webreaderapi.com/api/v1/batch" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/a", "https://example.com/b", "https://example.com/c"]}' \
  | jq -r '.job_id')

until [ "$(curl -s "https://webreaderapi.com/api/v1/jobs/$JOB" -H "Authorization: Bearer $WEBREADER_API_KEY" | jq -r '.status')" = "done" ]; do
  sleep 5
done

curl -s "https://webreaderapi.com/api/v1/jobs/$JOB" -H "Authorization: Bearer $WEBREADER_API_KEY" \
  | jq -r '.results[] | "\(.url)\t\(.title // .error.code)"'

Kredilerimi nasıl kontrol ederim?

/credits çağırın; ücretsizdir. credits_remaining, credits_used_today ve concurrency_limit değerlerinizi döndürür. Ön ödemeli kreditler asla süresi dolmaz: kullanılmayan sayfalar siz kullanana kadar hesabınızda kalır.

Kalan krediler

curl -s "https://webreaderapi.com/api/v1/credits" -H "Authorization: Bearer $WEBREADER_API_KEY" | jq '.credits_remaining'

Windows'ta PowerShell sürümü nedir?

Invoke-RestMethod JSON'u sizin için ayrıştırır, bu yüzden jq gerekmez. Sorguyu sayfa adresini kodlamak için [uri]::EscapeDataString ile oluşturun ve anahtarı bir headers tablosunda geçirin.

PowerShell: bir sayfayı kaydedin

$headers = @{ Authorization = "Bearer $env:WEBREADER_API_KEY" }
$target = [uri]::EscapeDataString('https://example.com/guides/compost')
$page = Invoke-RestMethod -Uri "https://webreaderapi.com/api/v1/read?url=$target" -Headers $headers
$page.markdown | Out-File -Encoding utf8 compost.md
"$($page.title): $($page.word_count) words, $($page.credits_used) credit(s)"

curl: sık sorulan sorular

İçinde & bulunan URL'im neden başarısız oluyor?

Çünkü shell veya curl onu böler. Yukarıdaki tariflerde olduğu gibi url=… argümanının tamamını tırnak içine alın ve --data-urlencode ile geçirin; curl o zaman sayfa adresinin içindeki &, ? ve = karakterlerini kodlar.

Bir hatanın HTTP durumunu nasıl görürüm?

Gövdeden sonra yazdırmak için -w '\n%{http_code}\n', tüm header'ları görmek için -i ekleyin. Gövdedeki error.code, betiklerde test edilecek kararlı değerdir.

Başarısız bir çağrı faturalandırılır mı?

Hayır. 1 kredi = tarayıcı olmadan 1 sayfa okuma; sayfa JavaScript render etmek için tarayıcı gerektiriyorsa 2 kredi. Başarısız olan veya bir sitenin robots.txt'inin reddettiği istek için ücret alınmaz.