🕷️ 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
Python aiai-scrapingautomationcrawlercrawlingcrawling-pythondatadata-extractionmcpmcp-serverplaywrightpythonscrapingselectorsstealthweb-scraperweb-scrapingweb-scraping-pythonwebscrapingxpath
docs: Move MCP details into relevant sections
Karim shoaireec511f76f05
diff --git a/agent-skill/Scrapling-Skill.zip b/agent-skill/Scrapling-Skill.zipindex ab905e2..0a50e29 100644Binary files a/agent-skill/Scrapling-Skill.zip and b/agent-skill/Scrapling-Skill.zip differdiff --git a/agent-skill/Scrapling-Skill/references/mcp-server.md b/agent-skill/Scrapling-Skill/references/mcp-server.mdindex 3c4b991..c90f826 100644--- a/agent-skill/Scrapling-Skill/references/mcp-server.md+++ b/agent-skill/Scrapling-Skill/references/mcp-server.md@@ -43,7 +43,7 @@ State files are stored on the machine running the MCP server. They do not includ#### Browser Actions-- **`browser_actions`**: Chain mouse actions, field filling, keyboard shortcuts, dialog replies, and waits in one call. Accept or dismiss browser alerts and confirmations, or enter text in prompts. For example, fill a search box, submit it, wait for results, and open a result. The AI can combine known steps while keeping snapshots separate when it needs to inspect a page change.+- **`browser_actions`**: Chain mouse actions, field filling, keyboard shortcuts, dialog replies, and waits in one call. Accept or dismiss browser alerts and confirmations, or enter text in prompts. For example, fill a search box, submit it, wait for results, and open a result. The AI can combine known steps while keeping snapshots separate when it needs to inspect a page change. This avoids a separate agent round trip between each step and helps with short-lived menus and other controls that need prompt follow-up.Reveal hover menus and tooltips, click buttons and links, or move over a nested panel and scroll it vertically or horizontally. Moves and clicks support selectors, snapshot references, or coordinates, with automatic waiting and scrolling into view for element targets. Supports coordinate movement in multiple steps, left, right, and middle clicks, plus double-clicks.@@ -68,6 +68,8 @@ Only completed requests are saved, including HTTP 4xx and 5xx responses. FailedSet `pierce_shadow=true` on `browser_fetch_once` or each `browser_fetch` call to include open Shadow DOM content. It defaults to `false`. See [Shadow DOM](fetching/stealthy.md#shadow-dom) for selector examples and limits.+Browser selectors can also target and interact with elements inside closed Shadow DOM.+### Key Capabilities- **Smart Content Extraction**: Convert web pages/elements to Markdown, HTML, or extract a clean version of the text content- **CSS Selector Support**: Use the Scrapling engine to target specific elements with precision before handing the content to the AI@@ -78,12 +80,6 @@ Set `pierce_shadow=true` on `browser_fetch_once` or each `browser_fetch` call to- **Ad Blocking**: All browser-based tools automatically block requests to ~3,500 known ad and tracker domains, saving tokens and speeding up page loads- **Prompt Injection Protection**: Automatic sanitization of hidden content (inline hidden elements, aria-hidden, hidden slots, zero-width characters, HTML comments, template tags) that could be used for prompt injection attacks-#### But why use Scrapling MCP Server instead of other available tools?--Aside from its stealth capabilities and ability to bypass Cloudflare Turnstile/Interstitial, Scrapling's server is the only one that lets you select specific elements to pass to the AI, saving a lot of time and tokens!--The way other servers work is that they extract the content, then pass it all to the AI to extract the fields you want. This causes the AI to consume far more tokens than needed (from irrelevant content). Scrapling solves this problem by allowing you to pass a CSS selector to narrow down the content you want before passing it to the AI, which makes the whole process much faster and more efficient.-## InstallationInstall Scrapling with MCP Support, then double-check that the browser dependencies are installed.diff --git a/docs/ai/mcp-server.md b/docs/ai/mcp-server.mdindex f4eaeeb..b6a3f1d 100644--- a/docs/ai/mcp-server.md+++ b/docs/ai/mcp-server.md@@ -50,7 +50,7 @@ State files are stored on the machine running the MCP server. They do not includ#### Browser Actions-- **`browser_actions`**: Chain mouse actions, field filling, keyboard shortcuts, dialog replies, and waits in one call. Accept or dismiss browser alerts and confirmations, or enter text in prompts. For example, fill a search box, submit it, wait for results, and open a result. The AI can combine known steps while keeping snapshots separate when it needs to inspect a page change.+- **`browser_actions`**: Chain mouse actions, field filling, keyboard shortcuts, dialog replies, and waits in one call. Accept or dismiss browser alerts and confirmations, or enter text in prompts. For example, fill a search box, submit it, wait for results, and open a result. The AI can combine known steps while keeping snapshots separate when it needs to inspect a page change. This avoids a separate agent round trip between each step and helps with short-lived menus and other controls that need prompt follow-up.Reveal hover menus and tooltips, click buttons and links, or move over a nested panel and scroll it vertically or horizontally. Moves and clicks support selectors, snapshot references, or coordinates, with automatic waiting and scrolling into view for element targets. Supports coordinate movement in multiple steps, left, right, and middle clicks, plus double-clicks.@@ -75,6 +75,8 @@ Only completed requests are saved, including HTTP 4xx and 5xx responses. FailedSet `pierce_shadow=true` on `browser_fetch_once` or each `browser_fetch` call to include open Shadow DOM content. It defaults to `false`. See [Shadow DOM](../fetching/stealthy.md#shadow-dom) for selector examples and limits.+Browser selectors can also target and interact with elements inside closed Shadow DOM.+### Key Capabilities- **Smart Content Extraction**: Convert web pages/elements to Markdown, HTML, or extract a clean version of the text content- **CSS Selector Support**: Use the Scrapling engine to target specific elements with precision before handing the content to the AI@@ -85,15 +87,6 @@ Set `pierce_shadow=true` on `browser_fetch_once` or each `browser_fetch` call to- **Ad Blocking**: All browser-based tools automatically block requests to ~3,500 known ad and tracker domains, saving tokens and speeding up page loads- **Prompt Injection Protection**: Automatic sanitization of hidden content (inline hidden elements, aria-hidden, hidden slots, zero-width characters, HTML comments, template tags) that could be used for prompt injection attacks-#### But why use Scrapling MCP Server instead of other available tools?--Aside from its stealth capabilities and ability to bypass Cloudflare Turnstile/Interstitial, Scrapling's server is the only one that lets you select specific elements to pass to the AI, saving a lot of time and tokens!--The way other servers work is that they extract the content, then pass it all to the AI to extract the fields you want. This causes the AI to consume far more tokens than needed (from irrelevant content). Scrapling solves this problem by allowing you to pass a CSS selector to narrow down the content you want before passing it to the AI, which makes the whole process much faster and more efficient.--If you don't know how to write/use CSS selectors, don't worry. You can tell the AI in the prompt to write selectors to match possible fields for you and watch it try different combinations until it finds the right one, as we will show in the examples section.--## InstallationInstall Scrapling with MCP Support, then double-check that the browser dependencies are installed.diff --git a/docs/locales/ar/ai/mcp-server.md b/docs/locales/ar/ai/mcp-server.mdindex 3157900..4b8a03f 100644--- a/docs/locales/ar/ai/mcp-server.md+++ b/docs/locales/ar/ai/mcp-server.md@@ -54,7 +54,7 @@ description: "اربط عميل ذكاء اصطناعي بـ Scrapling للجل#### إجراءات المتصفح {#browser-actions}-- **`browser_actions`**: يجمع حركات الفأرة وملء الحقول واختصارات لوحة المفاتيح والرد على مربعات الحوار والانتظار في استدعاء واحد. اقبل تنبيهات المتصفح ورسائل التأكيد أو ارفضها، أو أدخل نصًا في مربعات الطلب. مثلًا: املأ مربع بحث، وأرسل البحث، وانتظر النتائج، ثم افتح نتيجة. يستطيع الذكاء الاصطناعي جمع الخطوات المعروفة، وأخذ وصف الصفحة بشكل منفصل عندما يحتاج إلى فحص تغيير فيها.+- **`browser_actions`**: يجمع حركات الفأرة وملء الحقول واختصارات لوحة المفاتيح والرد على مربعات الحوار والانتظار في استدعاء واحد. اقبل تنبيهات المتصفح ورسائل التأكيد أو ارفضها، أو أدخل نصًا في مربعات الطلب. مثلًا: املأ مربع بحث، وأرسل البحث، وانتظر النتائج، ثم افتح نتيجة. يستطيع الذكاء الاصطناعي جمع الخطوات المعروفة، وأخذ وصف الصفحة بشكل منفصل عندما يحتاج إلى فحص تغيير فيها. وهذا يجنّب الحاجة إلى الرجوع للوكيل بين كل خطوة والخطوة التالية، ويساعد مع القوائم التي تختفي سريعًا وعناصر التحكم الأخرى التي تحتاج إلى إجراء تالٍ سريع.أظهر القوائم والتلميحات التي تظهر عند مرور الفأرة، وانقر الأزرار والروابط، أو حرّك الفأرة فوق لوحة داخلية ومرّرها رأسيًا أو أفقيًا. تدعم الحركة والنقر المحددات ومراجع وصف الصفحة والإحداثيات، مع الانتظار التلقائي وتمرير العنصر إلى الجزء المرئي عند استهداف عنصر. كما تدعم الحركة بالإحداثيات على عدة خطوات، والنقر بالزر الأيسر والأيمن والأوسط، والنقر المزدوج.@@ -79,6 +79,8 @@ description: "اربط عميل ذكاء اصطناعي بـ Scrapling للجلاضبط `pierce_shadow=true` في `browser_fetch_once` أو في كل استدعاء لـ `browser_fetch` لتضمين محتوى Shadow DOM المفتوح. قيمته الافتراضية `false`. راجع [Shadow DOM](../fetching/stealthy.md#shadow-dom) لأمثلة المحددات وحدود الدعم.+تستطيع محددات المتصفح أيضًا استهداف العناصر داخل Shadow DOM المغلق والتفاعل معها.+### القدرات الرئيسية {#key-capabilities}- **استخراج المحتوى بذكاء**: حوّل الصفحات والعناصر إلى Markdown أو HTML، أو استخرج نسخة نظيفة من النص.@@ -90,14 +92,6 @@ description: "اربط عميل ذكاء اصطناعي بـ Scrapling للجل- **حظر الإعلانات**: تحظر جميع أدوات المتصفح تلقائيًا الطلبات إلى نحو 3,500 نطاق معروف للإعلانات والتتبع، لتوفير الرموز وتسريع تحميل الصفحات.- **الحماية من حقن التعليمات**: يزيل المحتوى المخفي تلقائيًا، مثل العناصر المخفية بأنماط مباشرة وaria-hidden وعناصر slot المخفية والمحارف عديمة العرض وتعليقات HTML ووسوم template، التي قد تُستخدم لحقن تعليمات ضارة.-#### لماذا تستخدم خادم Scrapling MCP بدلًا من الأدوات الأخرى؟ {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--إلى جانب قدراته على التخفي وتجاوز Cloudflare Turnstile وInterstitial، فإن خادم Scrapling هو الوحيد الذي يتيح اختيار عناصر معينة لإرسالها إلى الذكاء الاصطناعي، لتوفير الكثير من الوقت والرموز!--تستخرج الخوادم الأخرى المحتوى ثم ترسله كله إلى الذكاء الاصطناعي ليستخرج الحقول المطلوبة. وهذا يستهلك رموزًا أكثر بكثير من اللازم بسبب المحتوى غير المرتبط بالمهمة. تحل Scrapling هذه المشكلة بالسماح بتمرير محدد CSS لتضييق المحتوى المطلوب قبل إرساله إلى النموذج، فتكون العملية أسرع وأكثر كفاءة.--إذا كنت لا تعرف كتابة محددات CSS أو استخدامها، فلا تقلق. اطلب من الذكاء الاصطناعي كتابة محددات للحقول المحتملة، وسيجرّب تراكيب مختلفة حتى يجد المناسب، كما سنوضح في قسم الأمثلة.-## التثبيت {#installation}ثبّت Scrapling مع دعم MCP، ثم تأكد من تثبيت متطلبات المتصفح.diff --git a/docs/locales/de/ai/mcp-server.md b/docs/locales/de/ai/mcp-server.mdindex e8d7071..4a421dc 100644--- a/docs/locales/de/ai/mcp-server.md+++ b/docs/locales/de/ai/mcp-server.md@@ -54,7 +54,7 @@ Die Zustandsdateien liegen auf dem Rechner, auf dem der MCP-Server läuft. Sie e#### Browser-Aktionen {#browser-actions}-- **`browser_actions`**: Verbindet Mausaktionen, das Ausfüllen von Feldern, Tastenkürzel, Antworten auf Dialoge und Wartebedingungen in einem Aufruf. Es kann Browser-Meldungen und Bestätigungen annehmen oder schließen und Text in Eingabedialoge schreiben. Zum Beispiel: ein Suchfeld ausfüllen, die Suche senden, Ergebnisse abwarten und ein Ergebnis öffnen. Die KI kann bekannte Schritte zusammenfassen und separate Seitenansichten anfordern, wenn sie eine Änderung prüfen muss.+- **`browser_actions`**: Verbindet Mausaktionen, das Ausfüllen von Feldern, Tastenkürzel, Antworten auf Dialoge und Wartebedingungen in einem Aufruf. Es kann Browser-Meldungen und Bestätigungen annehmen oder schließen und Text in Eingabedialoge schreiben. Zum Beispiel: ein Suchfeld ausfüllen, die Suche senden, Ergebnisse abwarten und ein Ergebnis öffnen. Die KI kann bekannte Schritte zusammenfassen und separate Seitenansichten anfordern, wenn sie eine Änderung prüfen muss. Dadurch muss der Agent nicht für jeden Schritt einen eigenen Aufruf senden. Das hilft bei kurz eingeblendeten Menüs und anderen Bedienelementen, die eine schnelle Folgeaktion erfordern.Zeigen Sie Menüs und Tooltips durch Überfahren mit der Maus an, klicken Sie auf Schaltflächen und Links oder bewegen Sie die Maus über einen verschachtelten Bereich, um dort senkrecht oder waagerecht zu scrollen. Bewegungen und Klicks unterstützen Selektoren, Referenzen aus der Seitenansicht und Koordinaten. Bei Zielelementen wartet das Werkzeug automatisch auf das Element und scrollt es ins Blickfeld. Es unterstützt Bewegungen über mehrere Koordinatenschritte, Links-, Rechts- und Mittelklicks sowie Doppelklicks.@@ -79,6 +79,8 @@ Nur abgeschlossene Anfragen werden gespeichert, einschließlich HTTP-Antworten mSetzen Sie `pierce_shadow=true` bei `browser_fetch_once` oder jedem `browser_fetch`-Aufruf, um Inhalte offener Shadow DOMs einzubeziehen. Der Standardwert ist `false`. Im Abschnitt [Shadow DOM](../fetching/stealthy.md#shadow-dom) finden Sie Selektorbeispiele und Einschränkungen.+Browser-Selektoren können auch Elemente in geschlossenen Shadow DOMs ansprechen und mit ihnen interagieren.+### Wichtigste Möglichkeiten {#key-capabilities}- **Inhalte extrahieren**: Wandeln Sie Webseiten oder Elemente in Markdown oder HTML um, oder extrahieren Sie bereinigten Text.@@ -90,14 +92,6 @@ Setzen Sie `pierce_shadow=true` bei `browser_fetch_once` oder jedem `browser_fet- **Werbeblocker**: Alle Browser-Werkzeuge blockieren automatisch Anfragen an etwa 3.500 bekannte Werbe- und Tracking-Domains. Das spart Tokens und beschleunigt das Laden.- **Schutz vor Prompt Injection**: Entfernt automatisch versteckte Inhalte, die für Angriffe auf das Modell verwendet werden könnten: durch Inline-Styles versteckte Elemente, aria-hidden, versteckte Slots, Zeichen mit der Breite null, HTML-Kommentare und template-Tags.-#### Warum den MCP-Server von Scrapling statt anderer Werkzeuge verwenden? {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--Der Server von Scrapling kann Automatisierung verbergen und Cloudflare Turnstile sowie Interstitial umgehen. Außerdem ist er der einzige Server, mit dem Sie bestimmte Elemente für die KI auswählen können. Das spart viel Zeit und Tokens!--Andere Server extrahieren den Inhalt und übergeben ihn vollständig an die KI, damit sie die gewünschten Felder findet. Dabei verbraucht das Modell viele Tokens für unnötige Inhalte. Mit Scrapling können Sie den Inhalt vor der Übergabe mit einem CSS-Selektor eingrenzen. Das macht den Ablauf schneller und effizienter.--Wenn Sie noch keine CSS-Selektoren schreiben können, ist das kein Problem. Bitten Sie die KI im Prompt, passende Selektoren für die gesuchten Felder zu erstellen. Sie kann verschiedene Kombinationen ausprobieren, bis sie die richtige findet. Wir zeigen das im Abschnitt mit den Beispielen.-## Installation {#installation}Installieren Sie Scrapling mit MCP-Unterstützung und prüfen Sie, ob auch die Browser-Abhängigkeiten installiert sind.diff --git a/docs/locales/es/ai/mcp-server.md b/docs/locales/es/ai/mcp-server.mdindex 8aca5c2..49c3e7b 100644--- a/docs/locales/es/ai/mcp-server.md+++ b/docs/locales/es/ai/mcp-server.md@@ -54,7 +54,7 @@ Los archivos de estado se guardan en el equipo donde se ejecuta el servidor MCP.#### Acciones del navegador {#browser-actions}-- **`browser_actions`**: Encadena acciones del ratón, entrada de texto, atajos de teclado, respuestas a diálogos y esperas en una sola llamada. Acepta o descarta alertas y confirmaciones del navegador, o introduce texto en sus diálogos. Por ejemplo, rellena un campo de búsqueda, envía la consulta, espera los resultados y abre uno. La IA puede agrupar los pasos que ya conoce y obtener vistas de la página por separado cuando necesita revisar un cambio.+- **`browser_actions`**: Encadena acciones del ratón, entrada de texto, atajos de teclado, respuestas a diálogos y esperas en una sola llamada. Acepta o descarta alertas y confirmaciones del navegador, o introduce texto en sus diálogos. Por ejemplo, rellena un campo de búsqueda, envía la consulta, espera los resultados y abre uno. La IA puede agrupar los pasos que ya conoce y obtener vistas de la página por separado cuando necesita revisar un cambio. Así no es necesario volver al agente entre un paso y el siguiente, lo que ayuda con menús que desaparecen pronto y otros controles que necesitan una acción rápida a continuación.Muestra menús y ayudas al pasar el ratón, pulsa botones y enlaces, o mueve el ratón sobre un panel anidado para desplazarlo en vertical u horizontal. Los movimientos y clics admiten selectores, referencias de la vista estructurada o coordenadas. Si el destino es un elemento, esperan y lo desplazan hasta dejarlo visible de forma automática. Admiten movimientos por coordenadas en varios pasos, clic izquierdo, derecho y central, además de doble clic.@@ -79,6 +79,8 @@ Solo se guardan las solicitudes completadas, incluidas las respuestas HTTP 4xx yDefine `pierce_shadow=true` en `browser_fetch_once` o en cada llamada a `browser_fetch` para incluir contenido de Shadow DOM abierto. Su valor predeterminado es `false`. Consulta [Shadow DOM](../fetching/stealthy.md#shadow-dom) para ver ejemplos de selectores y sus límites.+Los selectores del navegador también permiten localizar elementos dentro de un Shadow DOM cerrado e interactuar con ellos.+### Funciones principales {#key-capabilities}- **Extracción de contenido**: Convierte páginas o elementos a Markdown o HTML, o extrae una versión limpia de su texto.@@ -90,14 +92,6 @@ Define `pierce_shadow=true` en `browser_fetch_once` o en cada llamada a `browser- **Bloqueo de anuncios**: Todas las herramientas de navegador bloquean automáticamente solicitudes a unos 3.500 dominios conocidos de anuncios y seguimiento. Esto ahorra tokens y acelera la carga.- **Protección contra inyección de instrucciones**: Elimina automáticamente contenido oculto que podría usarse para atacar al modelo: elementos ocultos con estilos en línea, aria-hidden, slots ocultos, caracteres de ancho cero, comentarios HTML y etiquetas template.-#### ¿Por qué usar el servidor MCP de Scrapling en lugar de otras herramientas? {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--Además de ocultar la automatización y superar Turnstile e Interstitial de Cloudflare, el servidor de Scrapling es el único que permite elegir qué elementos se pasan a la IA. ¡Eso ahorra mucho tiempo y muchos tokens!--Otros servidores extraen el contenido y se lo pasan entero a la IA para que busque los campos que quieres. Esto hace que el modelo consuma muchos tokens en contenido que no necesita. Scrapling permite usar un selector CSS para limitar el contenido antes de enviarlo a la IA, lo que hace todo el proceso más rápido y eficiente.--Si no sabes escribir o usar selectores CSS, no te preocupes. Puedes pedir a la IA que los escriba para los campos que buscas y dejar que pruebe distintas opciones hasta encontrar la correcta. Lo veremos en la sección de ejemplos.-## Instalación {#installation}Instala Scrapling con soporte para MCP y comprueba que también estén instaladas las dependencias del navegador.diff --git a/docs/locales/fr/ai/mcp-server.md b/docs/locales/fr/ai/mcp-server.mdindex 9ba2251..b899fa6 100644--- a/docs/locales/fr/ai/mcp-server.md+++ b/docs/locales/fr/ai/mcp-server.md@@ -54,7 +54,7 @@ Les fichiers d’état se trouvent sur l’ordinateur qui exécute le serveur MC#### Actions du navigateur {#browser-actions}-- **`browser_actions`** : Enchaîne les actions de la souris, le remplissage des champs, les raccourcis clavier, les réponses aux boîtes de dialogue et les attentes dans un seul appel. Accepte ou ferme les alertes et confirmations du navigateur, ou saisit du texte dans les boîtes de saisie. Par exemple, remplit un champ de recherche, envoie la requête, attend les résultats et en ouvre un. L’IA peut regrouper les étapes connues et demander des vues séparées lorsqu’elle doit vérifier une modification de la page.+- **`browser_actions`** : Enchaîne les actions de la souris, le remplissage des champs, les raccourcis clavier, les réponses aux boîtes de dialogue et les attentes dans un seul appel. Accepte ou ferme les alertes et confirmations du navigateur, ou saisit du texte dans les boîtes de saisie. Par exemple, remplit un champ de recherche, envoie la requête, attend les résultats et en ouvre un. L’IA peut regrouper les étapes connues et demander des vues séparées lorsqu’elle doit vérifier une modification de la page. Cela évite un aller-retour avec l’agent entre deux étapes. C’est utile pour les menus qui disparaissent rapidement et les autres contrôles qui demandent d’enchaîner vite les actions.Affiche les menus et infobulles au survol, clique sur les boutons et liens, ou place la souris sur un panneau imbriqué pour le faire défiler verticalement ou horizontalement. Les déplacements et clics acceptent des sélecteurs, des références de la vue structurée ou des coordonnées. Pour les éléments ciblés, l’outil attend automatiquement leur présence et fait défiler la page pour les rendre visibles. Il accepte les déplacements par coordonnées en plusieurs étapes, les clics gauche, droit et central, ainsi que les doubles clics.@@ -79,6 +79,8 @@ Seules les requêtes terminées sont enregistrées, y compris les réponses HTTPDéfinissez `pierce_shadow=true` dans `browser_fetch_once` ou dans chaque appel à `browser_fetch` pour inclure le contenu des Shadow DOM ouverts. La valeur par défaut est `false`. Consultez [Shadow DOM](../fetching/stealthy.md#shadow-dom) pour voir des exemples de sélecteurs et leurs limites.+Les sélecteurs du navigateur peuvent aussi cibler des éléments dans un Shadow DOM fermé et interagir avec eux.+### Fonctions principales {#key-capabilities}- **Extraction de contenu** : Convertissez des pages ou des éléments en Markdown ou HTML, ou extrayez une version propre du texte.@@ -90,14 +92,6 @@ Définissez `pierce_shadow=true` dans `browser_fetch_once` ou dans chaque appel- **Blocage des publicités** : Tous les outils de navigateur bloquent automatiquement les requêtes vers environ 3 500 domaines connus de publicité et de suivi. Cela économise des tokens et accélère le chargement.- **Protection contre l’injection d’instructions** : Supprime automatiquement le contenu caché qui pourrait servir à attaquer le modèle : éléments cachés par des styles en ligne, aria-hidden, slots cachés, caractères de largeur nulle, commentaires HTML et balises template.-#### Pourquoi utiliser le serveur MCP de Scrapling plutôt que d’autres outils ? {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--En plus de masquer l’automatisation et de contourner Turnstile et Interstitial de Cloudflare, le serveur de Scrapling est le seul qui permet de choisir les éléments à envoyer à l’IA. Cela économise beaucoup de temps et de tokens !--Les autres serveurs extraient le contenu et le transmettent en entier à l’IA pour qu’elle trouve les champs souhaités. Le modèle consomme alors beaucoup de tokens pour du contenu inutile. Scrapling permet de limiter le contenu avec un sélecteur CSS avant de l’envoyer à l’IA, ce qui rend tout le processus plus rapide et plus efficace.--Si vous ne savez pas écrire ou utiliser des sélecteurs CSS, ne vous inquiétez pas. Demandez à l’IA d’en écrire pour les champs recherchés, puis laissez-la essayer différentes combinaisons jusqu’à trouver la bonne. Nous le montrerons dans les exemples.-## Installation {#installation}Installez Scrapling avec la prise en charge de MCP, puis vérifiez que les dépendances du navigateur sont aussi installées.diff --git a/docs/locales/ja/ai/mcp-server.md b/docs/locales/ja/ai/mcp-server.mdindex 4b87815..42cbf6f 100644--- a/docs/locales/ja/ai/mcp-server.md+++ b/docs/locales/ja/ai/mcp-server.md@@ -50,7 +50,7 @@ Scrapling MCP サーバーには、Web スクレイピングとブラウザ操#### ブラウザ操作 {#browser-actions}-- **`browser_actions`**:1 回の呼び出しで、マウス操作、入力欄の操作、キーボードショートカット、ダイアログへの応答、待機を続けて実行します。アラートや確認ダイアログを受け入れる、閉じる、入力ダイアログにテキストを入れる、といった操作ができます。例えば、検索欄への入力、送信、結果の待機、結果を開く操作をまとめられます。AI は手順が分かっている操作をまとめ、ページの変化を確認したいときは別途スナップショットを取得できます。+- **`browser_actions`**:1 回の呼び出しで、マウス操作、入力欄の操作、キーボードショートカット、ダイアログへの応答、待機を続けて実行します。アラートや確認ダイアログを受け入れる、閉じる、入力ダイアログにテキストを入れる、といった操作ができます。例えば、検索欄への入力、送信、結果の待機、結果を開く操作をまとめられます。AI は手順が分かっている操作をまとめ、ページの変化を確認したいときは別途スナップショットを取得できます。操作ごとにエージェントとのやり取りを挟まずに済むため、短時間で消えるメニューなど、すぐに次の操作をする必要がある場面で役立ちます。ホバーでメニューやツールチップを表示し、ボタンやリンクをクリックし、入れ子のパネル上に移動して縦や横にスクロールできます。移動とクリックでは、セレクター、スナップショットの参照、座標を指定できます。要素を対象にする場合は、自動で待機して表示範囲までスクロールします。座標間の移動を複数の段階に分けるほか、左、右、中央ボタンのクリックとダブルクリックにも対応しています。@@ -75,6 +75,8 @@ Scrapling MCP サーバーには、Web スクレイピングとブラウザ操オープンな Shadow DOM の内容を含めるには、`browser_fetch_once` または各 `browser_fetch` 呼び出しで `pierce_shadow=true` を設定します。デフォルトは `false` です。セレクターの例と制限については [Shadow DOM](../fetching/stealthy.md#shadow-dom) をご覧ください。+ブラウザのセレクターは、クローズドな Shadow DOM 内の要素も指定して操作できます。+### 主な機能 {#key-capabilities}- **内容の抽出**:Web ページや要素を Markdown、HTML に変換し、不要な内容を除いたテキストも抽出します。- **CSS セレクター対応**:AI に渡す前に、Scrapling のエンジンで対象の要素を正確に選べます。@@ -85,15 +87,6 @@ Scrapling MCP サーバーには、Web スクレイピングとブラウザ操- **広告のブロック**:すべてのブラウザツールで、既知の広告、トラッキング用の約 3,500 ドメインへのリクエストを自動でブロックし、トークンを節約して読み込みを速くします。- **プロンプトインジェクション対策**:攻撃に使われる可能性のある隠し内容を自動で除去します。インラインスタイルで隠された要素、aria-hidden、隠されたスロット、ゼロ幅文字、HTML コメント、template タグが対象です。-#### 他のツールではなく、Scrapling MCP サーバーを使う理由 {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--ステルス機能と Cloudflare Turnstile/Interstitial の回避に加え、Scrapling のサーバーでは AI に渡す要素を選べます。この選択機能を提供する唯一のサーバーで、時間とトークンを大きく節約できます。--他のサーバーは内容を抽出した後、そのすべてを AI に渡し、必要な項目を取り出させます。そのため、無関係な内容にも多くのトークンを使います。Scrapling では、AI に渡す前に CSS セレクターで内容を絞れるため、処理全体を速く、効率よく進められます。--CSS セレクターの書き方や使い方が分からなくても大丈夫です。必要な項目に合うセレクターを作るよう、プロンプトで AI に頼めます。AI は正しいものが見つかるまで組み合わせを試します。後の例で紹介します。--## インストール {#installation}MCP 対応の Scrapling をインストールし、ブラウザの依存関係も入っていることを確認します。diff --git a/docs/locales/ko/ai/mcp-server.md b/docs/locales/ko/ai/mcp-server.mdindex 0e11619..a683c14 100644--- a/docs/locales/ko/ai/mcp-server.md+++ b/docs/locales/ko/ai/mcp-server.md@@ -50,7 +50,7 @@ Scrapling MCP 서버는 웹 스크래핑과 브라우저 조작을 위한 도구#### 브라우저 동작 {#browser-actions}-- **`browser_actions`**: 한 번의 호출로 마우스 동작, 필드 입력, 키보드 단축키, 대화 상자 응답, 대기를 이어서 실행합니다. 알림이나 확인 창을 수락하거나 닫고, 입력 대화 상자에 텍스트를 넣을 수 있습니다. 예를 들어 검색창 입력, 제출, 결과 대기, 결과 열기를 한 번에 실행할 수 있습니다. AI는 이미 알고 있는 단계를 묶어서 실행하고, 페이지 변화를 확인할 때는 스냅샷을 따로 가져올 수 있습니다.+- **`browser_actions`**: 한 번의 호출로 마우스 동작, 필드 입력, 키보드 단축키, 대화 상자 응답, 대기를 이어서 실행합니다. 알림이나 확인 창을 수락하거나 닫고, 입력 대화 상자에 텍스트를 넣을 수 있습니다. 예를 들어 검색창 입력, 제출, 결과 대기, 결과 열기를 한 번에 실행할 수 있습니다. AI는 이미 알고 있는 단계를 묶어서 실행하고, 페이지 변화를 확인할 때는 스냅샷을 따로 가져올 수 있습니다. 단계마다 에이전트와 다시 통신할 필요가 없어, 잠깐만 표시되는 메뉴나 빠른 후속 동작이 필요한 다른 조작 대상을 다룰 때 도움이 됩니다.마우스를 올려 메뉴나 툴팁을 표시하고, 버튼이나 링크를 클릭하고, 중첩 패널 위로 이동해 세로나 가로로 스크롤할 수 있습니다. 이동과 클릭에는 선택자, 스냅샷 참조, 좌표를 사용합니다. 대상이 요소라면 자동으로 기다린 뒤 화면 안으로 스크롤합니다. 여러 단계의 좌표 이동, 왼쪽·오른쪽·가운데 버튼 클릭, 더블 클릭을 지원합니다.@@ -75,6 +75,8 @@ Scrapling MCP 서버는 웹 스크래핑과 브라우저 조작을 위한 도구열린 Shadow DOM의 내용을 포함하려면 `browser_fetch_once` 또는 각 `browser_fetch` 호출에 `pierce_shadow=true`를 설정하세요. 기본값은 `false`입니다. 선택자 예제와 제한 사항은 [Shadow DOM](../fetching/stealthy.md#shadow-dom)을 참고하세요.+브라우저 선택자로 닫힌 Shadow DOM 안의 요소를 지정하고 조작할 수도 있습니다.+### 주요 기능 {#key-capabilities}- **콘텐츠 추출**: 웹페이지나 요소를 Markdown, HTML로 바꾸거나 정리된 텍스트를 추출합니다.- **CSS 선택자 지원**: AI에 전달하기 전에 Scrapling 엔진으로 필요한 요소를 정확히 고릅니다.@@ -85,15 +87,6 @@ Scrapling MCP 서버는 웹 스크래핑과 브라우저 조작을 위한 도구- **광고 차단**: 모든 브라우저 도구가 알려진 광고·추적 도메인 약 3,500개로 보내는 요청을 자동으로 차단해 토큰을 줄이고 페이지 로드를 빠르게 합니다.- **프롬프트 인젝션 방지**: 공격에 쓰일 수 있는 숨겨진 내용을 자동으로 제거합니다. 인라인 스타일로 숨긴 요소, aria-hidden, 숨겨진 슬롯, 너비가 0인 문자, HTML 주석, template 태그가 대상입니다.-#### 다른 도구 대신 Scrapling MCP 서버를 사용하는 이유 {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--스텔스 기능과 Cloudflare Turnstile/Interstitial 우회 외에도, Scrapling 서버는 AI에 전달할 요소를 직접 고를 수 있습니다. 이런 기능을 제공하는 유일한 서버이며 시간과 토큰을 크게 줄여 줍니다.--다른 서버는 내용을 추출한 뒤 모두 AI에 전달해 필요한 항목을 찾게 합니다. 그러면 관련 없는 내용에도 토큰을 많이 씁니다. Scrapling은 AI에 전달하기 전에 CSS 선택자로 범위를 좁힐 수 있어 전체 과정이 더 빠르고 효율적입니다.--CSS 선택자를 쓰는 방법을 몰라도 괜찮습니다. 프롬프트에서 AI에게 필요한 항목에 맞는 선택자를 작성해 달라고 하세요. AI가 맞는 선택자를 찾을 때까지 여러 조합을 시도할 수 있습니다. 아래 예제에서 보여 드리겠습니다.--## 설치 {#installation}MCP를 지원하는 Scrapling을 설치하고 브라우저 의존성도 설치되어 있는지 확인하세요.diff --git a/docs/locales/pt-BR/ai/mcp-server.md b/docs/locales/pt-BR/ai/mcp-server.mdindex 99cf123..0829694 100644--- a/docs/locales/pt-BR/ai/mcp-server.md+++ b/docs/locales/pt-BR/ai/mcp-server.md@@ -54,7 +54,7 @@ Os arquivos de estado ficam no computador que executa o servidor MCP. Eles não#### Ações do navegador {#browser-actions}-- **`browser_actions`**: Encadeia ações do mouse, preenchimento de campos, atalhos de teclado, respostas a caixas de diálogo e esperas em uma chamada. Aceita ou dispensa alertas e confirmações do navegador, ou insere texto em caixas de entrada. Por exemplo, preenche um campo de busca, envia a consulta, espera os resultados e abre um deles. A IA pode agrupar etapas que já conhece e obter snapshots separados quando precisar conferir uma mudança na página.+- **`browser_actions`**: Encadeia ações do mouse, preenchimento de campos, atalhos de teclado, respostas a caixas de diálogo e esperas em uma chamada. Aceita ou dispensa alertas e confirmações do navegador, ou insere texto em caixas de entrada. Por exemplo, preenche um campo de busca, envia a consulta, espera os resultados e abre um deles. A IA pode agrupar etapas que já conhece e obter snapshots separados quando precisar conferir uma mudança na página. Assim, não é preciso voltar ao agente entre uma etapa e a próxima. Isso ajuda com menus que desaparecem rápido e outros controles que exigem uma ação rápida em seguida.Mostra menus e dicas ao passar o mouse, clica em botões e links, ou move o mouse sobre um painel aninhado para rolá-lo na vertical ou horizontal. Movimentos e cliques aceitam seletores, referências de snapshots ou coordenadas. Quando o alvo é um elemento, esperam e rolam a página até ele ficar visível de forma automática. Aceitam movimentos por coordenadas em várias etapas, cliques com os botões esquerdo, direito e do meio, além de clique duplo.@@ -79,6 +79,8 @@ Somente solicitações concluídas são salvas, incluindo respostas HTTP 4xx e 5Defina `pierce_shadow=true` em `browser_fetch_once` ou em cada chamada a `browser_fetch` para incluir conteúdo de Shadow DOM aberto. O padrão é `false`. Consulte [Shadow DOM](../fetching/stealthy.md#shadow-dom) para ver exemplos de seletores e seus limites.+Os seletores do navegador também podem localizar elementos dentro de Shadow DOM fechado e interagir com eles.+### Funções principais {#key-capabilities}- **Extração de conteúdo**: Converta páginas ou elementos em Markdown ou HTML, ou extraia uma versão limpa do texto.@@ -90,14 +92,6 @@ Defina `pierce_shadow=true` em `browser_fetch_once` ou em cada chamada a `browse- **Bloqueio de anúncios**: Todas as ferramentas de navegador bloqueiam automaticamente solicitações a cerca de 3.500 domínios conhecidos de anúncios e rastreamento. Isso economiza tokens e acelera o carregamento.- **Proteção contra injeção de instruções**: Remove automaticamente conteúdo oculto que poderia ser usado para atacar o modelo: elementos ocultos por estilos inline, aria-hidden, slots ocultos, caracteres de largura zero, comentários HTML e tags template.-#### Por que usar o servidor MCP do Scrapling em vez de outras ferramentas? {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--Além de ocultar a automação e contornar Turnstile e Interstitial do Cloudflare, o servidor do Scrapling é o único que permite escolher quais elementos serão enviados à IA. Isso economiza muito tempo e muitos tokens!--Outros servidores extraem o conteúdo e passam tudo para a IA encontrar os campos que você quer. Isso faz o modelo gastar muitos tokens com conteúdo que não precisa. O Scrapling permite usar um seletor CSS para limitar o conteúdo antes de enviá-lo à IA, deixando todo o processo mais rápido e eficiente.--Se você não sabe escrever ou usar seletores CSS, não se preocupe. Peça à IA para criar seletores para os campos desejados e deixe que ela teste combinações até encontrar a certa. Vamos mostrar isso na seção de exemplos.-## Instalação {#installation}Instale o Scrapling com suporte a MCP e confira se as dependências do navegador também estão instaladas.diff --git a/docs/locales/ru/ai/mcp-server.md b/docs/locales/ru/ai/mcp-server.mdindex 62b9ef1..6a37913 100644--- a/docs/locales/ru/ai/mcp-server.md+++ b/docs/locales/ru/ai/mcp-server.md@@ -50,7 +50,7 @@ MCP-сервер Scrapling предоставляет 16 инструменто#### Действия в браузере {#browser-actions}-- **`browser_actions`**: объединяет в одном вызове действия мышью, заполнение полей, сочетания клавиш, ответы на диалоговые окна и ожидания. Можно принять или отклонить уведомление и подтверждение, а также ввести текст в диалог запроса. Например, заполнить строку поиска, отправить запрос, дождаться результатов и открыть один из них. ИИ может объединять известные шаги, а снимки получать отдельно, когда нужно проверить изменение страницы.+- **`browser_actions`**: объединяет в одном вызове действия мышью, заполнение полей, сочетания клавиш, ответы на диалоговые окна и ожидания. Можно принять или отклонить уведомление и подтверждение, а также ввести текст в диалог запроса. Например, заполнить строку поиска, отправить запрос, дождаться результатов и открыть один из них. ИИ может объединять известные шаги, а снимки получать отдельно, когда нужно проверить изменение страницы. Это позволяет обойтись без отдельного обмена сообщениями с агентом между шагами. Такой подход полезен для быстро исчезающих меню и других элементов управления, где следующий шаг нужно выполнить быстро.Показывайте меню и подсказки наведением, нажимайте кнопки и ссылки, перемещайтесь на вложенную панель и прокручивайте её по вертикали или горизонтали. Для перемещения и клика можно указать селектор, ссылку из снимка или координаты. При выборе элемента инструмент сам дождётся его и прокрутит в видимую область. Поддерживаются перемещение по координатам в несколько шагов, клики левой, правой и средней кнопкой, а также двойной клик.@@ -75,6 +75,8 @@ MCP-сервер Scrapling предоставляет 16 инструментоЧтобы включить содержимое открытого Shadow DOM, задайте `pierce_shadow=true` в `browser_fetch_once` или в каждом вызове `browser_fetch`. По умолчанию используется `false`. Примеры селекторов и ограничения описаны в разделе [Shadow DOM](../fetching/stealthy.md#shadow-dom).+Селекторы браузера также позволяют выбирать элементы внутри закрытого Shadow DOM и взаимодействовать с ними.+### Основные возможности {#key-capabilities}- **Извлечение содержимого**: преобразование страниц и элементов в Markdown, HTML или очищенный текст.- **Поддержка CSS-селекторов**: точный выбор элементов движком Scrapling до передачи содержимого ИИ.@@ -85,15 +87,6 @@ MCP-сервер Scrapling предоставляет 16 инструменто- **Блокировка рекламы**: все браузерные инструменты автоматически блокируют запросы примерно к 3 500 известным рекламным и отслеживающим доменам, экономя токены и ускоряя загрузку.- **Защита от внедрения инструкций в промпт**: автоматическое удаление скрытого содержимого, пригодного для таких атак: элементов со встроенными скрывающими стилями, aria-hidden, скрытых слотов, символов нулевой ширины, HTML-комментариев и тегов template.-#### Почему стоит выбрать MCP-сервер Scrapling вместо других инструментов {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--Помимо функций скрытности и обхода Cloudflare Turnstile/Interstitial, сервер Scrapling позволяет выбрать конкретные элементы для передачи ИИ. Это единственный сервер с такой возможностью, которая заметно экономит время и токены.--Другие серверы сначала извлекают всё содержимое, затем передают его ИИ для поиска нужных полей. Из-за лишнего содержимого ИИ расходует больше токенов, чем нужно. Scrapling позволяет заранее сузить содержимое CSS-селектором, поэтому весь процесс становится быстрее и эффективнее.--Если вы не умеете писать CSS-селекторы, не беспокойтесь. Попросите ИИ в промпте подобрать селекторы для нужных полей. Он будет пробовать разные варианты, пока не найдёт подходящий. Ниже мы покажем примеры.--## Установка {#installation}Установите Scrapling с поддержкой MCP и убедитесь, что зависимости браузера тоже установлены.diff --git a/docs/locales/zh/ai/mcp-server.md b/docs/locales/zh/ai/mcp-server.mdindex c8d4542..af7ae43 100644--- a/docs/locales/zh/ai/mcp-server.md+++ b/docs/locales/zh/ai/mcp-server.md@@ -54,7 +54,7 @@ Scrapling MCP 服务器提供十六个工具,用于网页抓取和浏览器交#### 浏览器操作 {#browser-actions}-- **`browser_actions`**:在一次调用中串联鼠标操作、字段填写、快捷键、对话框响应和等待。可以接受或关闭浏览器提示和确认框,也可以在输入对话框中填写文本。例如,填写搜索框、提交、等待结果,然后打开一个结果。AI 可以合并已知步骤;需要检查页面变化时,再单独获取快照。+- **`browser_actions`**:在一次调用中串联鼠标操作、字段填写、快捷键、对话框响应和等待。可以接受或关闭浏览器提示和确认框,也可以在输入对话框中填写文本。例如,填写搜索框、提交、等待结果,然后打开一个结果。AI 可以合并已知步骤;需要检查页面变化时,再单独获取快照。这样就不必在每一步之后都把控制权交回智能体,再由它发起下一次调用,有助于处理只短暂显示的菜单,以及需要快速衔接操作的其他控件。悬停以显示菜单和提示,点击按钮和链接,或将鼠标移到嵌套区域内进行纵向或横向滚动。移动和点击支持选择器、快照引用或坐标。以元素为目标时,会自动等待并将其滚动到可见区域。支持分多步移动到坐标、左键、右键和中键点击,以及双击。@@ -79,6 +79,8 @@ Scrapling MCP 服务器提供十六个工具,用于网页抓取和浏览器交在 `browser_fetch_once` 或每次 `browser_fetch` 调用中设置 `pierce_shadow=true`,即可包含开放 Shadow DOM 的内容。默认值为 `false`。选择器示例和限制请参阅 [Shadow DOM](../fetching/stealthy.md#shadow-dom)。+浏览器选择器也可以定位封闭 Shadow DOM 内的元素并与之交互。+### 核心能力 {#key-capabilities}- **内容提取**:将网页或元素转换为 Markdown、HTML,或提取干净的文本。@@ -90,14 +92,6 @@ Scrapling MCP 服务器提供十六个工具,用于网页抓取和浏览器交- **广告拦截**:所有浏览器工具都会自动阻止发往约 3,500 个已知广告和跟踪域名的请求,节省 token 并加快加载。- **提示词注入防护**:自动清理可能用于攻击的隐藏内容,包括通过内联样式隐藏的元素、aria-hidden、隐藏的 slot、零宽字符、HTML 注释和 template 标签。-#### 为什么使用 Scrapling MCP 服务器,而不是其他工具? {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}--除了隐身能力和绕过 Cloudflare Turnstile、Interstitial 的功能,Scrapling 的服务器还是唯一能选择指定元素再交给 AI 的服务器。这可以节省很多时间和 token!--其他服务器通常提取内容后,将全部内容交给 AI,让它寻找需要的字段。这会让 AI 为无关内容消耗大量 token。Scrapling 允许先用 CSS 选择器缩小内容范围,再传给 AI,让整个过程更快、更高效。--如果不会编写 CSS 选择器,也不用担心。可以在提示词中要求 AI 为目标字段编写选择器,让它尝试不同组合,直到找到合适的方式。后面的示例会展示这一点。-## 安装 {#installation}安装带 MCP 支持的 Scrapling,并确认浏览器依赖也已安装。