Skip to content

🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev

docs: make the cli section clearer for README files of all languages

Karim shoair8ca0646172b6
diff --git a/docs/README.md b/docs/README.md
index d17e4dc..cd73bb2 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -222,13 +222,12 @@ Scrapling v0.3 includes a powerful command-line interface:
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
+Launch the interactive Web Scraping shell
```bash
-# Launch interactive Web Scraping shell
scrapling shell
-
-# Extract pages to a file directly without programming (Extracts the content inside `body` tag by default)
-# If the output file ends with `.txt`, then the text content of the target will be extracted.
-# If ended with `.md`, it will be a markdown representation of the HTML content, and `.html` will be the HTML content right away.
+```
+Extract pages to a file directly without programming (Extracts the content inside the `body` tag by default). If the output file ends with `.txt`, then the text content of the target will be extracted. If it ends in `.md`, it will be a Markdown representation of the HTML content; if it ends in `.html`, it will be the HTML content itself.
+```bash
scrapling extract get 'https://example.com' content.md
scrapling extract get 'https://example.com' content.txt --css-selector '#fromSkipToProducts' --impersonate 'chrome' # All elements matching the CSS selector '#fromSkipToProducts'
scrapling extract fetch 'https://example.com' content.md --css-selector '#fromSkipToProducts' --no-headless
diff --git a/docs/README_AR.md b/docs/README_AR.md
index 60e2fcb..2cdf5c7 100644
--- a/docs/README_AR.md
+++ b/docs/README_AR.md
@@ -212,13 +212,12 @@ async with AsyncStealthySession(max_pages=2) as session:
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
+تشغيل غلاف استخراج الويب التفاعلي
```bash
-# تشغيل غلاف استخراج الويب التفاعلي
scrapling shell
-
-# استخراج الصفحات إلى ملف مباشرة دون برمجة (يستخرج المحتوى داخل وسم `body` افتراضياً)
-# إذا انتهى ملف الإخراج بـ `.txt`، فسيتم استخراج محتوى النص للهدف.
-# إذا انتهى بـ `.md`، فسيكون تمثيل markdown لمحتوى HTML، و`.html` سيكون محتوى HTML مباشرة.
+```
+استخراج الصفحات إلى ملف مباشرة دون برمجة (يستخرج المحتوى داخل وسم `body` افتراضياً). إذا انتهى ملف الإخراج بـ `.txt`، فسيتم استخراج محتوى النص للهدف. إذا انتهى بـ `.md`، فسيكون تمثيل Markdown لمحتوى HTML؛ إذا انتهى بـ `.html`، فسيكون محتوى HTML نفسه.
+```bash
scrapling extract get 'https://example.com' content.md
scrapling extract get 'https://example.com' content.txt --css-selector '#fromSkipToProducts' --impersonate 'chrome' # جميع العناصر المطابقة لمحدد CSS '#fromSkipToProducts'
scrapling extract fetch 'https://example.com' content.md --css-selector '#fromSkipToProducts' --no-headless
diff --git a/docs/README_CN.md b/docs/README_CN.md
index daee3fc..75a0200 100644
--- a/docs/README_CN.md
+++ b/docs/README_CN.md
@@ -212,13 +212,12 @@ Scrapling v0.3包含强大的命令行界面:
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
+启动交互式网页抓取shell
```bash
-# 启动交互式网页抓取shell
scrapling shell
-
-# 直接将页面提取到文件而无需编程(默认提取`body`标签内的内容)
-# 如果输出文件以`.txt`结尾,则将提取目标的文本内容。
-# 如果以`.md`结尾,它将是HTML内容的markdown表示,`.html`将直接是HTML内容。
+```
+直接将页面提取到文件而无需编程(默认提取`body`标签内的内容)。如果输出文件以`.txt`结尾,则将提取目标的文本内容。如果以`.md`结尾,它将是HTML内容的Markdown表示;如果以`.html`结尾,它将是HTML内容本身。
+```bash
scrapling extract get 'https://example.com' content.md
scrapling extract get 'https://example.com' content.txt --css-selector '#fromSkipToProducts' --impersonate 'chrome' # 所有匹配CSS选择器'#fromSkipToProducts'的元素
scrapling extract fetch 'https://example.com' content.md --css-selector '#fromSkipToProducts' --no-headless
diff --git a/docs/README_DE.md b/docs/README_DE.md
index 098e745..8b29c9a 100644
--- a/docs/README_DE.md
+++ b/docs/README_DE.md
@@ -212,13 +212,12 @@ Scrapling v0.3 enthält eine leistungsstarke Befehlszeilenschnittstelle:
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
+Interaktive Web-Scraping-Shell starten
```bash
-# Interaktive Web-Scraping-Shell starten
scrapling shell
-
-# Seiten direkt ohne Programmierung in eine Datei extrahieren (Extrahiert standardmäßig den Inhalt im `body`-Tag)
-# Wenn die Ausgabedatei mit `.txt` endet, wird der Textinhalt des Ziels extrahiert.
-# Wenn sie mit `.md` endet, ist es eine Markdown-Darstellung des HTML-Inhalts, und `.html` ist direkt der HTML-Inhalt.
+```
+Seiten direkt ohne Programmierung in eine Datei extrahieren (Extrahiert standardmäßig den Inhalt im `body`-Tag). Wenn die Ausgabedatei mit `.txt` endet, wird der Textinhalt des Ziels extrahiert. Wenn sie mit `.md` endet, ist es eine Markdown-Darstellung des HTML-Inhalts; wenn sie mit `.html` endet, ist es der HTML-Inhalt selbst.
+```bash
scrapling extract get 'https://example.com' content.md
scrapling extract get 'https://example.com' content.txt --css-selector '#fromSkipToProducts' --impersonate 'chrome' # Alle Elemente, die dem CSS-Selektor '#fromSkipToProducts' entsprechen
scrapling extract fetch 'https://example.com' content.md --css-selector '#fromSkipToProducts' --no-headless
diff --git a/docs/README_ES.md b/docs/README_ES.md
index 5f112b9..fe52f8c 100644
--- a/docs/README_ES.md
+++ b/docs/README_ES.md
@@ -212,13 +212,12 @@ Scrapling v0.3 incluye una poderosa interfaz de línea de comandos:
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
+Lanzar shell interactivo de Web Scraping
```bash
-# Lanzar shell interactivo de Web Scraping
scrapling shell
-
-# Extraer páginas a un archivo directamente sin programar (Extrae el contenido dentro de la etiqueta `body` por defecto)
-# Si el archivo de salida termina con `.txt`, entonces se extraerá el contenido de texto del objetivo.
-# Si termina con `.md`, será una representación markdown del contenido HTML, y `.html` será el contenido HTML directamente.
+```
+Extraer páginas a un archivo directamente sin programar (Extrae el contenido dentro de la etiqueta `body` por defecto). Si el archivo de salida termina con `.txt`, entonces se extraerá el contenido de texto del objetivo. Si termina con `.md`, será una representación Markdown del contenido HTML; si termina con `.html`, será el contenido HTML en sí mismo.
+```bash
scrapling extract get 'https://example.com' content.md
scrapling extract get 'https://example.com' content.txt --css-selector '#fromSkipToProducts' --impersonate 'chrome' # Todos los elementos que coinciden con el selector CSS '#fromSkipToProducts'
scrapling extract fetch 'https://example.com' content.md --css-selector '#fromSkipToProducts' --no-headless
diff --git a/docs/README_JP.md b/docs/README_JP.md
index 73d2a68..7450daf 100644
--- a/docs/README_JP.md
+++ b/docs/README_JP.md
@@ -212,13 +212,12 @@ Scrapling v0.3には強力なコマンドラインインターフェースが含
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
+インタラクティブウェブスクレイピングシェルを起動
```bash
-# インタラクティブウェブスクレイピングシェルを起動
scrapling shell
-
-# プログラミングせずに直接ページをファイルに抽出(デフォルトで`body`タグ内のコンテンツを抽出)
-# 出力ファイルが`.txt`で終わる場合、ターゲットのテキストコンテンツが抽出されます。
-# `.md`で終わる場合、HTMLコンテンツのMarkdown表現になり、`.html`は直接HTMLコンテンツになります。
+```
+プログラミングせずに直接ページをファイルに抽出(デフォルトで`body`タグ内のコンテンツを抽出)。出力ファイルが`.txt`で終わる場合、ターゲットのテキストコンテンツが抽出されます。`.md`で終わる場合、HTMLコンテンツのMarkdown表現になります;`.html`で終わる場合、HTMLコンテンツそのものになります。
+```bash
scrapling extract get 'https://example.com' content.md
scrapling extract get 'https://example.com' content.txt --css-selector '#fromSkipToProducts' --impersonate 'chrome' # CSSセレクタ'#fromSkipToProducts'に一致するすべての要素
scrapling extract fetch 'https://example.com' content.md --css-selector '#fromSkipToProducts' --no-headless
diff --git a/docs/README_RU.md b/docs/README_RU.md
index 7015338..10911b5 100644
--- a/docs/README_RU.md
+++ b/docs/README_RU.md
@@ -212,13 +212,12 @@ Scrapling v0.3 включает мощный интерфейс командно
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
+Запустить интерактивную оболочку веб-скрапинга
```bash
-# Запустить интерактивную оболочку веб-скрапинга
scrapling shell
-
-# Извлечь страницы в файл напрямую без программирования (Извлекает содержимое внутри тега `body` по умолчанию)
-# Если выходной файл заканчивается на `.txt`, то будет извлечено текстовое содержимое цели.
-# Если заканчивается на `.md`, это будет markdown-представление HTML-содержимого, а `.html` будет непосредственно HTML-содержимым.
+```
+Извлечь страницы в файл напрямую без программирования (Извлекает содержимое внутри тега `body` по умолчанию). Если выходной файл заканчивается на `.txt`, то будет извлечено текстовое содержимое цели. Если заканчивается на `.md`, это будет Markdown-представление HTML-содержимого; если заканчивается на `.html`, это будет само HTML-содержимое.
+```bash
scrapling extract get 'https://example.com' content.md
scrapling extract get 'https://example.com' content.txt --css-selector '#fromSkipToProducts' --impersonate 'chrome' # Все элементы, соответствующие CSS-селектору '#fromSkipToProducts'
scrapling extract fetch 'https://example.com' content.md --css-selector '#fromSkipToProducts' --no-headless