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: update the changelog with latest version and translations

Karim shoairfd531313a499
diff --git a/docs/changelog.md b/docs/changelog.md
index 8606d04..df64db5 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -7,6 +7,89 @@ description: "Release notes for Scrapling, including new features, fixes, and br
All notable changes to Scrapling, taken from the [GitHub releases](https://github.com/D4Vinci/Scrapling/releases).
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5 upgrades almost everything: fetching, parsing, spiders, browser automation, AI tools, and docs in ten languages 🚀**
+
+!!! warning "Warning"
+
+ **This release introduces a lot of breaking changes that don't fit here. Check the [Migrating to v0.5 guide](migrating-to-v0.5.md) before updating.**
+
+### 🚀 New Stuff and quality of life changes {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **A much more capable MCP server for AI agents that can solve almost any CAPTCHA** (Check the [docs](ai/mcp-server.md)):
+
+ - **Complete browser workflows**: fill forms, click, hover, scroll, use the keyboard, handle dialogs, and wait for results in one ordered sequence. Supports different field types and slower interactions, with actions stopping at the first error.
+ - **Read and search the current page without reloading it**: extract HTML, Markdown, or text from a whole page or one element. Searchable page snapshots show element roles, names, and positions, with focused views that retain the surrounding context.
+ - **Run custom JavaScript and take focused screenshots**: execute scripts, including async work, with access to the page's own JavaScript. Capture individual elements, the viewport, or the full page as PNG or JPEG.
+ - **Inspect network activity and reuse logins**: examine recorded requests and responses, save and restore browser login state, and interact with elements inside open or closed Shadow DOM. Read recorded traffic before closing the session.
+ - **Use fewer tokens and get clearer errors**: leaner tool descriptions and shared guidance reduce repeated text, while browser and request failures reach agents with useful error messages.
+
+- **See the requests behind the page**. Enable `record_requests=True` to record completed traffic across loads, actions, and tabs, then inspect saved responses without sending requests again. (Check the [docs](fetching/stealthy.md#network-history))
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - Filter by URL, method, resource type, or status; retrieve one response by ID. Inspect headers, sent data, API responses, HTTP errors, and redirects through the usual `Response` API.
+ - Retains supported text bodies with size limits, plus metadata and a reason when a body cannot be saved. The default limit is 1,000 requests. Works with sync and async sessions; saved Python history stays readable after close.
+
+- **Save a login once and reuse it across runs**. `save_state(path)` and `load_state(path)` save cookies, local storage, and IndexedDB in Playwright-compatible JSON. Both sync and async browser sessions support them. (Check the [docs](fetching/stealthy.md#save-and-load-session-state))
+ - Load state before fetching or reloading a page. Requires a started, shared browser context without `proxy_rotator`; tabs, browser settings, and `sessionStorage` are not saved.
+
+- **Extract open Shadow DOM with `pierce_shadow=True`**, then use CSS or XPath as usual. Available in browser fetchers, sessions, and the CLI's `--pierce-shadow` option. Preserves slot content without changing the live page. HTML capture excludes closed roots and iframe documents. (Check the [docs](fetching/stealthy.md#shadow-dom))
+
+- **Choose how your spider explores a site**. `CrawlSpider` and its subclasses, including `ContentSpider`, support `crawl_strategy="bfs"` for oldest-first or `"dfs"` for newest-first scheduling. Priority still wins, and concurrent pages can finish in a different order. (Check the [docs](spiders/generic-templates.md#crawl-order))
+
+### 🐛 Bug Fixes {#v0.5-bug-fixes}
+
+- **Improved Cloudflare solving** with delayed-widget detection, fewer unnecessary waits, and bounded passive-challenge and hidden-frame retry loops. Fixes [#468](https://github.com/D4Vinci/Scrapling/issues/468) and [#509](https://github.com/D4Vinci/Scrapling/issues/509).
+- **Fixed browser startup from an elevated Windows shell**. Fixes [#463](https://github.com/D4Vinci/Scrapling/issues/463).
+- **Kept the built-in stealth flags when adding custom browser flags** by @alkaz-nodemaven in [#430](https://github.com/D4Vinci/Scrapling/pull/430).
+- **Improved charset parsing for browser responses**, including declarations with different letter case, spaces, or quoted values.
+- **Stopped logging the absence of a Cloudflare challenge as an error** when no challenge needs to be solved. Fixes [#459](https://github.com/D4Vinci/Scrapling/issues/459).
+
+- **Corrected request fingerprints** for query parameters by @yetval in [#448](https://github.com/D4Vinci/Scrapling/pull/448), empty or falsy JSON bodies by @ac1982 in [#480](https://github.com/D4Vinci/Scrapling/pull/480), and header insertion order by @SarwadnyaMahajan in [#466](https://github.com/D4Vinci/Scrapling/pull/466).
+- **Fixed request data leaking into followed links**, including stale body-related headers, by @yetval in [#462](https://github.com/D4Vinci/Scrapling/pull/462).
+- **Prevented blocked responses from being stored as successful development-cache entries** by @Kuang-xianxin in [#446](https://github.com/D4Vinci/Scrapling/pull/446).
+- **Preserved checkpoint files when a crawl fails with an exception** by @SulimanAbdulrazzaq in [#486](https://github.com/D4Vinci/Scrapling/pull/486).
+- **Corrected robots.txt failure handling** so failed lookups are not cached as permission to crawl, by @prateekraawat1 in [#443](https://github.com/D4Vinci/Scrapling/pull/443).
+- **Fixed link extraction with restricted selectors**, including empty matches and selectors that target the link element itself, by @SulimanAbdulrazzaq in [#452](https://github.com/D4Vinci/Scrapling/pull/452) and [#483](https://github.com/D4Vinci/Scrapling/pull/483).
+- **Fixed sitemap callback routing** by @SulimanAbdulrazzaq in [#458](https://github.com/D4Vinci/Scrapling/pull/458), **and XML parsing with comments or processing instructions** by @sup3dev in [#450](https://github.com/D4Vinci/Scrapling/pull/450).
+- **Handled leading byte-order marks in robots.txt and CSV feeds** by @SulimanAbdulrazzaq in [#453](https://github.com/D4Vinci/Scrapling/pull/453).
+- **Fixed `stealthy_headers` handling in spider HTTP sessions**, passing the option to the session instead of directly to `curl_cffi`, by @Yigtwxx in [#475](https://github.com/D4Vinci/Scrapling/pull/475).
+
+- **Fixed dictionary form encoding for list and tuple values**, while preserving request-body precedence and existing `None` handling, with contributions by @SulimanAbdulrazzaq in [#485](https://github.com/D4Vinci/Scrapling/pull/485).
+- **Fixed case-insensitive merging of session and per-request HTTP headers** by @SulimanAbdulrazzaq in [#487](https://github.com/D4Vinci/Scrapling/pull/487).
+- **Fixed CLI requests silently dropping empty or falsy JSON bodies** by @SulimanAbdulrazzaq in [#484](https://github.com/D4Vinci/Scrapling/pull/484).
+- **Made Markdown and text file exports consistently use UTF-8** and prevented conversion errors from truncating an existing output file, by @SulimanAbdulrazzaq in [#488](https://github.com/D4Vinci/Scrapling/pull/488).
+- **Fixed `curl2fetcher()` handling of curl's user-agent and proxy options** by @SulimanAbdulrazzaq in [#490](https://github.com/D4Vinci/Scrapling/pull/490).
+
+- **Fixed Markdown blocks running together** when several selected elements are converted through `Response.markdown()` or CLI extraction, with contributions by @Yigtwxx in [#432](https://github.com/D4Vinci/Scrapling/pull/432).
+- **Fixed hidden-content cleaning for AI output** to keep visible content such as `opacity:0.95`, recognize more hidden styles, and remove hidden slots, with contributions by @Yigtwxx in [#460](https://github.com/D4Vinci/Scrapling/pull/460).
+- **Fixed noise-tag removal stopping early around nested tags** by @Yigtwxx in [#474](https://github.com/D4Vinci/Scrapling/pull/474).
+- **Fixed generated CSS and XPath selectors for the first of several same-tag siblings** by @yellow-dog-dog in [#495](https://github.com/D4Vinci/Scrapling/pull/495).
+- **Resolved an lxml HTML parser deprecation warning** by @afsuyadi in [#493](https://github.com/D4Vinci/Scrapling/pull/493).
+
+### Docs {#v0.5-docs}
+
+- **The full website now speaks ten languages**: English, Arabic, Spanish, Brazilian Portuguese, French, German, Simplified Chinese, Japanese, Russian, and Korean. Guides, API references, tutorials, and the [changelog](changelog.md) are translated, with Arabic RTL support and language switches that keep your page and section.
+- **Clearer guides, README examples, and setup steps**, covering checkpoint data, browser encodings, saved state, network history, Shadow DOM, and crawl order.
+- **Updated the Agent Skill**, its examples, references, and downloadable archive for the current browser and MCP tools.
+- **Moved the changelog to the website** and added access to each page's Markdown source.
+
+### Project {#v0.5-project}
+
+- Refreshed Scrapling's logo, cover images, and website presentation.
+- Expanded tests for browser actions, dialogs, extraction, screenshots, JavaScript, network recording, state files, Shadow DOM, and crawler fixes.
+- Added a browser-test marker and separate browser, async, and parallel test runs. Improved Windows checkpoint and CSV test portability by @diegobravtraps-oss in [#457](https://github.com/D4Vinci/Scrapling/pull/457).
+- Updated the shared multilingual documentation build setup and contribution guidance.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**One of the biggest releases this year: a reworked MCP server, RAG-ready Markdown in one line, an improved Cloudflare solver, and browser tabs that stay open for automation 🚀**
diff --git a/docs/locales/ar/changelog.md b/docs/locales/ar/changelog.md
index 15e0ade..e1b13fc 100644
--- a/docs/locales/ar/changelog.md
+++ b/docs/locales/ar/changelog.md
@@ -7,6 +7,89 @@ description: "ملاحظات إصدارات Scrapling، بما فيها المي
كل التغييرات المهمة في Scrapling، نقلًا عن [إصدارات GitHub](https://github.com/D4Vinci/Scrapling/releases).
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**يحسّن Scrapling v0.5 كل شيء تقريبًا: جلب الصفحات، وتحليلها، والعناكب، وأتمتة المتصفح، وأدوات الذكاء الاصطناعي، والتوثيق بعشر لغات 🚀**
+
+!!! warning "تنبيه"
+
+ **يتضمن هذا الإصدار تغييرات كثيرة قد تؤثر في الكود الحالي ولا تتسع لها هذه الصفحة. راجع [دليل الانتقال إلى v0.5](migrating-to-v0.5.md) قبل التحديث.**
+
+### 🚀 الجديد وتحسينات الاستخدام {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **خادم MCP بقدرات أكبر لوكلاء الذكاء الاصطناعي يمكنه حل أي CAPTCHA تقريبًا** (راجع [التوثيق](ai/mcp-server.md)):
+
+ - **تنفيذ خطوات كاملة في المتصفح**: املأ النماذج، وانقر، وحرّك المؤشر فوق العناصر، ومرّر الصفحة، واستخدم لوحة المفاتيح، وتعامل مع مربعات الحوار، وانتظر النتائج في تسلسل واحد مرتب. يدعم أنواعًا مختلفة من الحقول والتفاعل البطيء، وتتوقف الإجراءات عند أول خطأ.
+ - **اقرأ الصفحة الحالية وابحث فيها دون إعادة تحميلها**: استخرج HTML أو Markdown أو النص من الصفحة كاملة أو من عنصر واحد. تعرض لقطات الصفحة القابلة للبحث أدوار العناصر وأسماءها ومواضعها، مع عروض مركزة تحتفظ بالسياق المحيط.
+ - **شغّل JavaScript مخصصًا والتقط صورًا لأجزاء محددة**: نفّذ السكربتات، بما فيها العمليات غير المتزامنة، مع الوصول إلى JavaScript الخاص بالصفحة. التقط صورة لعنصر واحد أو للجزء الظاهر أو للصفحة كاملة بصيغة PNG أو JPEG.
+ - **افحص نشاط الشبكة وأعد استخدام تسجيل الدخول**: افحص الطلبات والردود المسجلة، واحفظ حالة تسجيل الدخول في المتصفح واستعدها، وتفاعل مع العناصر داخل Shadow DOM المفتوح أو المغلق. اقرأ حركة الشبكة المسجلة قبل إغلاق الجلسة.
+ - **استهلك tokens أقل واحصل على أخطاء أوضح**: تقلل أوصاف الأدوات الأقصر والإرشادات المشتركة النص المكرر، وتصل أخطاء المتصفح والطلبات إلى الوكلاء برسائل مفيدة.
+
+- **شاهد الطلبات التي تعمل خلف الصفحة**. فعّل `record_requests=True` لتسجيل حركة الشبكة المكتملة عبر تحميل الصفحات والإجراءات والتبويبات، ثم افحص الردود المحفوظة دون إرسال الطلبات مجددًا. (راجع [التوثيق](fetching/stealthy.md#network-history))
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - صفِّ النتائج حسب الرابط أو طريقة الطلب أو نوع المورد أو الحالة، واسترجع ردًا واحدًا بمعرّفه. افحص الترويسات والبيانات المرسلة وردود API وأخطاء HTTP وإعادة التوجيه عبر واجهة `Response` المعتادة.
+ - يحتفظ بمحتوى الردود النصية المدعومة ضمن حدود للحجم، مع البيانات الوصفية وسبب عدم حفظ المحتوى عند تعذر ذلك. الحد الافتراضي هو 1,000 طلب. يعمل مع الجلسات المتزامنة وغير المتزامنة، ويبقى السجل المحفوظ في Python قابلًا للقراءة بعد الإغلاق.
+
+- **احفظ تسجيل الدخول مرة واحدة وأعد استخدامه في مرات التشغيل التالية**. تحفظ `save_state(path)` و`load_state(path)` ملفات cookies والتخزين المحلي وIndexedDB في JSON متوافق مع Playwright وتستعيدها. تدعمهما جلسات المتصفح المتزامنة وغير المتزامنة. (راجع [التوثيق](fetching/stealthy.md#save-and-load-session-state))
+ - حمّل الحالة قبل جلب الصفحة أو إعادة تحميلها. تتطلب هذه الميزة سياق متصفح مشتركًا بدأ تشغيله دون `proxy_rotator`؛ ولا تُحفظ التبويبات أو إعدادات المتصفح أو `sessionStorage`.
+
+- **استخرج Shadow DOM المفتوح باستخدام `pierce_shadow=True`**، ثم استخدم CSS أو XPath كالمعتاد. تتوفر الميزة في أدوات جلب الصفحات بالمتصفح والجلسات والخيار `--pierce-shadow` في CLI. تحتفظ بمحتوى slot دون تغيير الصفحة المفتوحة. لا يشمل HTML الملتقط جذور Shadow DOM المغلقة أو مستندات iframe. (راجع [التوثيق](fetching/stealthy.md#shadow-dom))
+
+- **اختر كيف يستكشف عنكبوتك الموقع**. يدعم `CrawlSpider` والأصناف المشتقة منه، بما فيها `ContentSpider`، الخيار `crawl_strategy="bfs"` لجدولة الأقدم أولًا أو `"dfs"` لجدولة الأحدث أولًا. تبقى الأولوية هي العامل الأهم، وقد تكتمل الصفحات التي تُجلب بالتوازي بترتيب مختلف. (راجع [التوثيق](spiders/generic-templates.md#crawl-order))
+
+### 🐛 إصلاحات الأخطاء {#v0.5-bug-fixes}
+
+- **تحسين حل تحديات Cloudflare** باكتشاف أداة التحدي التي تظهر متأخرة، وتقليل الانتظار غير الضروري، ووضع حد لحلقات إعادة المحاولة مع التحديات غير التفاعلية والإطارات المخفية. يصلح [#468](https://github.com/D4Vinci/Scrapling/issues/468) و[#509](https://github.com/D4Vinci/Scrapling/issues/509).
+- **إصلاح تشغيل المتصفح من طرفية Windows بصلاحيات المسؤول**. يصلح [#463](https://github.com/D4Vinci/Scrapling/issues/463).
+- **الإبقاء على خيارات التخفي المدمجة عند إضافة خيارات متصفح مخصصة**، بمساهمة @alkaz-nodemaven في [#430](https://github.com/D4Vinci/Scrapling/pull/430).
+- **تحسين قراءة تعريف ترميز الأحرف في ردود المتصفح**، بما فيها التعريفات التي تختلف فيها حالة الأحرف أو تتضمن مسافات أو قيمًا بين علامتي اقتباس.
+- **إيقاف تسجيل غياب تحدي Cloudflare كخطأ** عندما لا يوجد تحدٍّ يحتاج إلى حل. يصلح [#459](https://github.com/D4Vinci/Scrapling/issues/459).
+
+- **تصحيح بصمات الطلبات** لمعاملات الرابط، بمساهمة @yetval في [#448](https://github.com/D4Vinci/Scrapling/pull/448)، ولمحتوى JSON الفارغ أو ذي القيمة التي تُعدّ خاطئة منطقيًا، بمساهمة @ac1982 في [#480](https://github.com/D4Vinci/Scrapling/pull/480)، ولترتيب إضافة الترويسات، بمساهمة @SarwadnyaMahajan في [#466](https://github.com/D4Vinci/Scrapling/pull/466).
+- **إصلاح انتقال بيانات الطلب إلى الروابط المتبوعة**، بما فيها الترويسات القديمة المرتبطة بمحتوى الطلب، بمساهمة @yetval في [#462](https://github.com/D4Vinci/Scrapling/pull/462).
+- **منع تخزين الردود المحظورة كنتائج ناجحة في ذاكرة التخزين المؤقت لوضع التطوير**، بمساهمة @Kuang-xianxin في [#446](https://github.com/D4Vinci/Scrapling/pull/446).
+- **الإبقاء على ملفات نقاط الحفظ عند فشل الزحف بسبب استثناء**، بمساهمة @SulimanAbdulrazzaq في [#486](https://github.com/D4Vinci/Scrapling/pull/486).
+- **تصحيح التعامل مع فشل جلب robots.txt** حتى لا يُخزّن الفشل مؤقتًا بوصفه سماحًا بالزحف، بمساهمة @prateekraawat1 في [#443](https://github.com/D4Vinci/Scrapling/pull/443).
+- **إصلاح استخراج الروابط باستخدام محددات لتقييد نطاق البحث**، بما فيها النتائج الفارغة والمحددات التي تستهدف عنصر الرابط نفسه، بمساهمة @SulimanAbdulrazzaq في [#452](https://github.com/D4Vinci/Scrapling/pull/452) و[#483](https://github.com/D4Vinci/Scrapling/pull/483).
+- **إصلاح توجيه روابط خريطة الموقع إلى دوال معالجتها**، بمساهمة @SulimanAbdulrazzaq في [#458](https://github.com/D4Vinci/Scrapling/pull/458)، **وتحليل XML الذي يحتوي على تعليقات أو تعليمات معالجة**، بمساهمة @sup3dev في [#450](https://github.com/D4Vinci/Scrapling/pull/450).
+- **معالجة علامات ترتيب البايتات في بداية robots.txt وخلاصات CSV**، بمساهمة @SulimanAbdulrazzaq في [#453](https://github.com/D4Vinci/Scrapling/pull/453).
+- **إصلاح التعامل مع `stealthy_headers` في جلسات HTTP للعناكب**، بتمرير الخيار إلى الجلسة بدلًا من تمريره مباشرة إلى `curl_cffi`، بمساهمة @Yigtwxx في [#475](https://github.com/D4Vinci/Scrapling/pull/475).
+
+- **إصلاح ترميز بيانات النماذج من القواميس عندما تكون القيم قوائم أو tuples**، مع الحفاظ على أسبقية محتوى الطلب وطريقة التعامل الحالية مع `None`، بمساهمات من @SulimanAbdulrazzaq في [#485](https://github.com/D4Vinci/Scrapling/pull/485).
+- **إصلاح دمج ترويسات HTTP للجلسة والطلب دون حساسية لحالة الأحرف**، بمساهمة @SulimanAbdulrazzaq في [#487](https://github.com/D4Vinci/Scrapling/pull/487).
+- **إصلاح إسقاط طلبات CLI لمحتوى JSON الفارغ أو ذي القيمة التي تُعدّ خاطئة منطقيًا دون تنبيه**، بمساهمة @SulimanAbdulrazzaq في [#484](https://github.com/D4Vinci/Scrapling/pull/484).
+- **استخدام UTF-8 دائمًا عند تصدير ملفات Markdown والنصوص** ومنع أخطاء التحويل من اقتطاع ملف إخراج موجود، بمساهمة @SulimanAbdulrazzaq في [#488](https://github.com/D4Vinci/Scrapling/pull/488).
+- **إصلاح تعامل `curl2fetcher()` مع خياري وكيل المستخدم والوكيل الشبكي في curl**، بمساهمة @SulimanAbdulrazzaq في [#490](https://github.com/D4Vinci/Scrapling/pull/490).
+
+- **إصلاح تلاصق كتل Markdown** عند تحويل عدة عناصر محددة عبر `Response.markdown()` أو استخراج CLI، بمساهمات من @Yigtwxx في [#432](https://github.com/D4Vinci/Scrapling/pull/432).
+- **إصلاح تنظيف المحتوى المخفي في مخرجات الذكاء الاصطناعي** للإبقاء على المحتوى الظاهر مثل `opacity:0.95`، والتعرف على مزيد من الأنماط التي تخفي المحتوى، وإزالة عناصر slot المخفية، بمساهمات من @Yigtwxx في [#460](https://github.com/D4Vinci/Scrapling/pull/460).
+- **إصلاح توقف إزالة الوسوم غير المرغوبة مبكرًا عند وجود وسوم متداخلة**، بمساهمة @Yigtwxx في [#474](https://github.com/D4Vinci/Scrapling/pull/474).
+- **إصلاح محددات CSS وXPath المُولّدة لأول عنصر من عدة عناصر شقيقة لها الوسم نفسه**، بمساهمة @yellow-dog-dog في [#495](https://github.com/D4Vinci/Scrapling/pull/495).
+- **إزالة تحذير الإهمال من محلل HTML في lxml**، بمساهمة @afsuyadi في [#493](https://github.com/D4Vinci/Scrapling/pull/493).
+
+### التوثيق {#v0.5-docs}
+
+- **الموقع كاملًا متاح الآن بعشر لغات**: الإنجليزية والعربية والإسبانية والبرتغالية البرازيلية والفرنسية والألمانية والصينية المبسطة واليابانية والروسية والكورية. تُرجمت الأدلة ومراجع API والدروس و[سجل التغييرات](changelog.md)، مع دعم اتجاه الكتابة من اليمين إلى اليسار للعربية وتبديل اللغة مع الاحتفاظ بالصفحة والقسم الحاليين.
+- **أدلة وأمثلة README وخطوات إعداد أوضح**، تشمل بيانات نقاط الحفظ وترميزات المتصفح والحالة المحفوظة وسجل الشبكة وShadow DOM وترتيب الزحف.
+- **تحديث مهارة الوكيل** وأمثلتها ومراجعها وأرشيفها القابل للتنزيل لتوافق أدوات المتصفح وMCP الحالية.
+- **نقل سجل التغييرات إلى الموقع** وإتاحة مصدر Markdown لكل صفحة.
+
+### المشروع {#v0.5-project}
+
+- تحديث شعار Scrapling وصور الغلاف وطريقة عرض الموقع.
+- توسيع اختبارات إجراءات المتصفح ومربعات الحوار والاستخراج ولقطات الشاشة وJavaScript وتسجيل الشبكة وملفات الحالة وShadow DOM وإصلاحات الزاحف.
+- إضافة علامة لاختبارات المتصفح وتشغيل اختبارات المتصفح والاختبارات غير المتزامنة والمتوازية بصورة منفصلة. تحسين توافق اختبارات نقاط الحفظ وCSV مع Windows، بمساهمة @diegobravtraps-oss في [#457](https://github.com/D4Vinci/Scrapling/pull/457).
+- تحديث إعداد البناء المشترك للتوثيق متعدد اللغات وإرشادات المساهمة.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**أحد أكبر إصدارات هذا العام: إعادة تصميم خادم MCP، وتحويل الصفحات إلى Markdown جاهز لـ RAG بسطر واحد، وتحسين حل تحديات Cloudflare، وإبقاء تبويبات المتصفح مفتوحة للأتمتة 🚀**
diff --git a/docs/locales/de/changelog.md b/docs/locales/de/changelog.md
index f292ba1..c6d6c64 100644
--- a/docs/locales/de/changelog.md
+++ b/docs/locales/de/changelog.md
@@ -7,6 +7,89 @@ description: "Versionshinweise zu Scrapling mit neuen Funktionen, Fehlerbehebung
Alle wichtigen Änderungen an Scrapling aus den [GitHub-Releases](https://github.com/D4Vinci/Scrapling/releases).
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5 verbessert fast alles: Abrufen, Parsen, Spider, Browser-Automatisierung, KI-Werkzeuge und Dokumentation in zehn Sprachen 🚀**
+
+!!! warning "Warnung"
+
+ **Diese Version enthält so viele inkompatible Änderungen, dass sie hier nicht alle aufgeführt werden können. Lesen Sie vor dem Update den [Leitfaden zur Migration auf v0.5](migrating-to-v0.5.md).**
+
+### 🚀 Neuerungen und Verbesserungen der Bedienung {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **Ein deutlich leistungsfähigerer MCP-Server für KI-Agenten, der fast jedes CAPTCHA lösen kann** (siehe [Dokumentation](ai/mcp-server.md)):
+
+ - **Vollständige Browser-Abläufe**: Formulare ausfüllen, klicken, den Mauszeiger über Elemente bewegen, scrollen, die Tastatur verwenden, Dialoge bedienen und auf Ergebnisse warten, alles in einer geordneten Folge. Unterstützt verschiedene Feldtypen und langsamere Interaktionen. Die Aktionen stoppen beim ersten Fehler.
+ - **Die aktuelle Seite ohne Neuladen lesen und durchsuchen**: HTML, Markdown oder Text aus einer ganzen Seite oder einem einzelnen Element extrahieren. Durchsuchbare Seitenansichten zeigen Rollen, Namen und Positionen der Elemente. Gezielte Ansichten behalten den umgebenden Kontext bei.
+ - **Eigenes JavaScript ausführen und gezielte Screenshots aufnehmen**: Skripte ausführen, auch mit asynchronen Vorgängen und Zugriff auf das JavaScript der Seite. Einzelne Elemente, den sichtbaren Bereich oder die ganze Seite als PNG oder JPEG aufnehmen.
+ - **Netzwerkaktivität prüfen und Anmeldungen wiederverwenden**: Aufgezeichnete Anfragen und Antworten untersuchen, den Anmeldestatus des Browsers speichern und wiederherstellen und mit Elementen in offenem oder geschlossenem Shadow DOM interagieren. Lesen Sie den aufgezeichneten Datenverkehr, bevor Sie die Sitzung schließen.
+ - **Weniger Tokens verwenden und klarere Fehler erhalten**: Kürzere Werkzeugbeschreibungen und gemeinsame Hinweise vermeiden Wiederholungen. Fehler bei Browsern und Anfragen erreichen die Agenten mit hilfreichen Meldungen.
+
+- **Sehen Sie die Anfragen hinter der Seite**. Aktivieren Sie `record_requests=True`, um abgeschlossenen Datenverkehr über Ladevorgänge, Aktionen und Tabs hinweg aufzuzeichnen. Prüfen Sie dann die gespeicherten Antworten, ohne Anfragen erneut zu senden. (Siehe [Dokumentation](fetching/stealthy.md#network-history))
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - Nach URL, Methode, Ressourcentyp oder Status filtern und eine einzelne Antwort anhand ihrer ID abrufen. Header, gesendete Daten, API-Antworten, HTTP-Fehler und Weiterleitungen über die gewohnte `Response`-API prüfen.
+ - Speichert unterstützte Textkörper innerhalb der Größenlimits sowie Metadaten und einen Grund, wenn ein Antwortkörper nicht gespeichert werden kann. Das Standardlimit beträgt 1.000 Anfragen. Funktioniert mit synchronen und asynchronen Sitzungen. Der gespeicherte Python-Verlauf bleibt nach dem Schließen lesbar.
+
+- **Speichern Sie eine Anmeldung einmal und verwenden Sie sie bei weiteren Läufen wieder**. `save_state(path)` und `load_state(path)` speichern Cookies, lokalen Speicher und IndexedDB in Playwright-kompatiblem JSON. Sowohl synchrone als auch asynchrone Browser-Sitzungen unterstützen sie. (Siehe [Dokumentation](fetching/stealthy.md#save-and-load-session-state))
+ - Laden Sie den Zustand, bevor Sie eine Seite abrufen oder neu laden. Erfordert einen gestarteten, gemeinsam genutzten Browser-Kontext ohne `proxy_rotator`. Tabs, Browser-Einstellungen und `sessionStorage` werden nicht gespeichert.
+
+- **Extrahieren Sie offenes Shadow DOM mit `pierce_shadow=True`** und verwenden Sie anschließend CSS oder XPath wie gewohnt. Verfügbar in Browser-Fetchern, Sitzungen und über die CLI-Option `--pierce-shadow`. Behält Slot-Inhalte bei, ohne die aktive Seite zu ändern. Geschlossene Wurzeln und iframe-Dokumente sind in der HTML-Erfassung nicht enthalten. (Siehe [Dokumentation](fetching/stealthy.md#shadow-dom))
+
+- **Wählen Sie, wie Ihr Spider eine Website durchsucht**. `CrawlSpider` und seine Unterklassen, darunter `ContentSpider`, unterstützen `crawl_strategy="bfs"`, um die ältesten Anfragen zuerst einzuplanen, oder `"dfs"` für die neuesten zuerst. Die Priorität hat weiterhin Vorrang. Parallel verarbeitete Seiten können in einer anderen Reihenfolge fertig werden. (Siehe [Dokumentation](spiders/generic-templates.md#crawl-order))
+
+### 🐛 Fehlerbehebungen {#v0.5-bug-fixes}
+
+- **Verbessertes Lösen von Cloudflare-Prüfungen** durch Erkennung verzögert erscheinender Widgets, weniger unnötige Wartezeiten und begrenzte Wiederholungsschleifen für passive Prüfungen und versteckte Frames. Behebt [#468](https://github.com/D4Vinci/Scrapling/issues/468) und [#509](https://github.com/D4Vinci/Scrapling/issues/509).
+- **Browser-Start aus einer Windows-Shell mit Administratorrechten korrigiert**. Behebt [#463](https://github.com/D4Vinci/Scrapling/issues/463).
+- **Integrierte Stealth-Flags bleiben beim Hinzufügen eigener Browser-Flags erhalten**, von @alkaz-nodemaven in [#430](https://github.com/D4Vinci/Scrapling/pull/430).
+- **Verbessertes Parsen der Zeichensatzangaben in Browser-Antworten**, auch bei unterschiedlicher Groß- und Kleinschreibung, Leerzeichen oder Werten in Anführungszeichen.
+- **Das Fehlen einer Cloudflare-Prüfung wird nicht mehr als Fehler protokolliert**, wenn keine Prüfung gelöst werden muss. Behebt [#459](https://github.com/D4Vinci/Scrapling/issues/459).
+
+- **Anfrage-Fingerprints korrigiert** für URL-Parameter von @yetval in [#448](https://github.com/D4Vinci/Scrapling/pull/448), leere oder als falsch ausgewertete JSON-Körper von @ac1982 in [#480](https://github.com/D4Vinci/Scrapling/pull/480) und die Einfügereihenfolge der Header von @SarwadnyaMahajan in [#466](https://github.com/D4Vinci/Scrapling/pull/466).
+- **Unbeabsichtigte Übernahme von Anfragedaten beim Folgen von Links behoben**, einschließlich veralteter Header für den Anfragekörper, von @yetval in [#462](https://github.com/D4Vinci/Scrapling/pull/462).
+- **Blockierte Antworten werden nicht mehr als erfolgreiche Einträge im Entwicklungscache gespeichert**, von @Kuang-xianxin in [#446](https://github.com/D4Vinci/Scrapling/pull/446).
+- **Checkpoint-Dateien bleiben erhalten, wenn ein Crawl mit einer Ausnahme fehlschlägt**, von @SulimanAbdulrazzaq in [#486](https://github.com/D4Vinci/Scrapling/pull/486).
+- **Fehlerbehandlung für robots.txt korrigiert**, damit fehlgeschlagene Abfragen nicht als Erlaubnis zum Crawlen zwischengespeichert werden, von @prateekraawat1 in [#443](https://github.com/D4Vinci/Scrapling/pull/443).
+- **Link-Extraktion mit einschränkenden Selektoren korrigiert**, einschließlich leerer Treffer und Selektoren, die das Link-Element selbst auswählen, von @SulimanAbdulrazzaq in [#452](https://github.com/D4Vinci/Scrapling/pull/452) und [#483](https://github.com/D4Vinci/Scrapling/pull/483).
+- **Auswahl der Sitemap-Callbacks korrigiert**, von @SulimanAbdulrazzaq in [#458](https://github.com/D4Vinci/Scrapling/pull/458), **sowie XML-Parsing mit Kommentaren oder Verarbeitungsanweisungen**, von @sup3dev in [#450](https://github.com/D4Vinci/Scrapling/pull/450).
+- **Führende Byte-Reihenfolgemarkierungen in robots.txt und CSV-Feeds werden berücksichtigt**, von @SulimanAbdulrazzaq in [#453](https://github.com/D4Vinci/Scrapling/pull/453).
+- **Behandlung von `stealthy_headers` in HTTP-Sitzungen von Spidern korrigiert**: Die Option wird an die Sitzung statt direkt an `curl_cffi` übergeben, von @Yigtwxx in [#475](https://github.com/D4Vinci/Scrapling/pull/475).
+
+- **Formularkodierung von Dictionaries für Listen- und Tupelwerte korrigiert**, unter Beibehaltung des Vorrangs der Anfragekörper und der bisherigen Behandlung von `None`, mit Beiträgen von @SulimanAbdulrazzaq in [#485](https://github.com/D4Vinci/Scrapling/pull/485).
+- **Zusammenführen von HTTP-Headern aus Sitzung und einzelner Anfrage ohne Beachtung der Groß- und Kleinschreibung korrigiert**, von @SulimanAbdulrazzaq in [#487](https://github.com/D4Vinci/Scrapling/pull/487).
+- **Behoben: CLI-Anfragen verwarfen leere oder als falsch ausgewertete JSON-Körper ohne Hinweis**, von @SulimanAbdulrazzaq in [#484](https://github.com/D4Vinci/Scrapling/pull/484).
+- **Markdown- und Textdateien werden nun durchgängig als UTF-8 exportiert**. Konvertierungsfehler kürzen bestehende Ausgabedateien nicht mehr, von @SulimanAbdulrazzaq in [#488](https://github.com/D4Vinci/Scrapling/pull/488).
+- **Behandlung der User-Agent- und Proxy-Optionen von curl in `curl2fetcher()` korrigiert**, von @SulimanAbdulrazzaq in [#490](https://github.com/D4Vinci/Scrapling/pull/490).
+
+- **Zusammenlaufende Markdown-Blöcke korrigiert**, wenn mehrere ausgewählte Elemente mit `Response.markdown()` oder der CLI-Extraktion umgewandelt werden, mit Beiträgen von @Yigtwxx in [#432](https://github.com/D4Vinci/Scrapling/pull/432).
+- **Bereinigung versteckter Inhalte für KI-Ausgaben korrigiert**, um sichtbare Inhalte wie `opacity:0.95` beizubehalten, weitere versteckende Stile zu erkennen und versteckte Slots zu entfernen, mit Beiträgen von @Yigtwxx in [#460](https://github.com/D4Vinci/Scrapling/pull/460).
+- **Behoben: Das Entfernen störender Tags brach bei verschachtelten Tags zu früh ab**, von @Yigtwxx in [#474](https://github.com/D4Vinci/Scrapling/pull/474).
+- **Generierte CSS- und XPath-Selektoren für das erste von mehreren Geschwisterelementen mit demselben Tag korrigiert**, von @yellow-dog-dog in [#495](https://github.com/D4Vinci/Scrapling/pull/495).
+- **Eine Veraltungswarnung des lxml-HTML-Parsers behoben**, von @afsuyadi in [#493](https://github.com/D4Vinci/Scrapling/pull/493).
+
+### Dokumentation {#v0.5-docs}
+
+- **Die gesamte Website spricht jetzt zehn Sprachen**: Englisch, Arabisch, Spanisch, brasilianisches Portugiesisch, Französisch, Deutsch, vereinfachtes Chinesisch, Japanisch, Russisch und Koreanisch. Leitfäden, API-Referenzen, Tutorials und der [Änderungsverlauf](changelog.md) sind übersetzt. Arabisch unterstützt die Leserichtung von rechts nach links. Beim Sprachwechsel bleiben Seite und Abschnitt erhalten.
+- **Klarere Leitfäden, README-Beispiele und Einrichtungsschritte**, die Checkpoint-Daten, Browser-Kodierungen, gespeicherten Zustand, Netzwerkverlauf, Shadow DOM und Crawl-Reihenfolge abdecken.
+- **Den Agent Skill aktualisiert**, einschließlich Beispielen, Referenzen und herunterladbarem Archiv, für die aktuellen Browser- und MCP-Werkzeuge.
+- **Den Änderungsverlauf auf die Website verschoben** und Zugriff auf den Markdown-Quelltext jeder Seite hinzugefügt.
+
+### Projekt {#v0.5-project}
+
+- Scraplings Logo, Titelbilder und Website-Darstellung erneuert.
+- Tests für Browser-Aktionen, Dialoge, Extraktion, Screenshots, JavaScript, Netzwerkaufzeichnung, Zustandsdateien, Shadow DOM und Crawler-Korrekturen erweitert.
+- Einen Marker für Browser-Tests und getrennte Läufe für Browser-, asynchrone und parallele Tests hinzugefügt. Windows-Kompatibilität der Checkpoint- und CSV-Tests verbessert, von @diegobravtraps-oss in [#457](https://github.com/D4Vinci/Scrapling/pull/457).
+- Gemeinsame Build-Konfiguration der mehrsprachigen Dokumentation und Hinweise für Beiträge aktualisiert.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**Eine der größten Veröffentlichungen dieses Jahres: ein überarbeiteter MCP-Server, Markdown für RAG mit einer Zeile Code, besseres Lösen von Cloudflare-Prüfungen und Browser-Tabs, die für die Automatisierung offen bleiben 🚀**
diff --git a/docs/locales/es/changelog.md b/docs/locales/es/changelog.md
index dc83d70..d22654b 100644
--- a/docs/locales/es/changelog.md
+++ b/docs/locales/es/changelog.md
@@ -7,6 +7,89 @@ description: "Notas de las versiones de Scrapling, con nuevas funciones, correcc
Todos los cambios importantes de Scrapling, tomados de las [versiones de GitHub](https://github.com/D4Vinci/Scrapling/releases).
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5 mejora casi todo: obtención de páginas, análisis, spiders, automatización del navegador, herramientas de IA y documentación en diez idiomas 🚀**
+
+!!! warning "Advertencia"
+
+ **Esta versión introduce muchos cambios incompatibles que no caben aquí. Consulta la [guía de migración a v0.5](migrating-to-v0.5.md) antes de actualizar.**
+
+### 🚀 Novedades y mejoras de uso {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **Un servidor MCP mucho más capaz para agentes de IA que pueden resolver casi cualquier CAPTCHA** (consulta la [documentación](ai/mcp-server.md)):
+
+ - **Flujos completos en el navegador**: rellena formularios, haz clic, pasa el cursor sobre elementos, desplázate, usa el teclado, gestiona diálogos y espera resultados en una sola secuencia ordenada. Admite distintos tipos de campos e interacciones más lentas, y las acciones se detienen ante el primer error.
+ - **Lee y busca en la página actual sin recargarla**: extrae HTML, Markdown o texto de una página completa o de un elemento. Las instantáneas de página permiten buscar y muestran los roles, nombres y posiciones de los elementos, con vistas enfocadas que conservan el contexto que los rodea.
+ - **Ejecuta JavaScript propio y toma capturas de zonas concretas**: ejecuta scripts, incluidas tareas asíncronas, con acceso al JavaScript de la propia página. Captura elementos individuales, el área visible o la página completa en PNG o JPEG.
+ - **Inspecciona la actividad de red y reutiliza los inicios de sesión**: examina solicitudes y respuestas registradas, guarda y restaura el estado de inicio de sesión del navegador e interactúa con elementos dentro de Shadow DOM abierto o cerrado. Lee el tráfico registrado antes de cerrar la sesión.
+ - **Usa menos tokens y recibe errores más claros**: las descripciones más breves de las herramientas y las instrucciones compartidas reducen el texto repetido, mientras que los fallos del navegador y de las solicitudes llegan a los agentes con mensajes de error útiles.
+
+- **Ve las solicitudes que hay detrás de la página**. Activa `record_requests=True` para registrar el tráfico completado durante cargas, acciones y entre pestañas, y luego inspecciona las respuestas guardadas sin volver a enviar solicitudes. (Consulta la [documentación](fetching/stealthy.md#network-history))
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - Filtra por URL, método, tipo de recurso o estado; recupera una respuesta por su ID. Inspecciona cabeceras, datos enviados, respuestas de API, errores HTTP y redirecciones mediante la API habitual de `Response`.
+ - Conserva los cuerpos de texto admitidos con límites de tamaño, junto con los metadatos y el motivo cuando un cuerpo no se puede guardar. El límite predeterminado es de 1000 solicitudes. Funciona con sesiones síncronas y asíncronas; el historial guardado en Python sigue disponible para lectura después del cierre.
+
+- **Guarda un inicio de sesión una vez y reutilízalo entre ejecuciones**. `save_state(path)` y `load_state(path)` guardan y cargan cookies, almacenamiento local e IndexedDB en JSON compatible con Playwright. Las sesiones de navegador síncronas y asíncronas admiten ambos métodos. (Consulta la [documentación](fetching/stealthy.md#save-and-load-session-state))
+ - Carga el estado antes de obtener o recargar una página. Requiere un contexto de navegador compartido ya iniciado y sin `proxy_rotator`; no se guardan las pestañas, los ajustes del navegador ni `sessionStorage`.
+
+- **Extrae Shadow DOM abierto con `pierce_shadow=True`** y luego usa CSS o XPath como siempre. Disponible en los fetchers de navegador, las sesiones y la opción `--pierce-shadow` de la CLI. Conserva el contenido de los slots sin cambiar la página activa. La captura de HTML excluye las raíces cerradas y los documentos de iframes. (Consulta la [documentación](fetching/stealthy.md#shadow-dom))
+
+- **Elige cómo explora tu spider un sitio**. `CrawlSpider` y sus subclases, incluida `ContentSpider`, admiten `crawl_strategy="bfs"` para programar primero las solicitudes más antiguas o `"dfs"` para programar primero las más recientes. La prioridad sigue prevaleciendo, y las páginas procesadas de forma concurrente pueden terminar en otro orden. (Consulta la [documentación](spiders/generic-templates.md#crawl-order))
+
+### 🐛 Correcciones de errores {#v0.5-bug-fixes}
+
+- **Mejorada la resolución de Cloudflare** con detección de widgets que aparecen tarde, menos esperas innecesarias y límites en los bucles de reintentos para desafíos pasivos e iframes ocultos. Corrige [#468](https://github.com/D4Vinci/Scrapling/issues/468) y [#509](https://github.com/D4Vinci/Scrapling/issues/509).
+- **Corregido el inicio del navegador desde una consola de Windows con permisos de administrador**. Corrige [#463](https://github.com/D4Vinci/Scrapling/issues/463).
+- **Se conservan las opciones de ocultación integradas al añadir opciones propias del navegador**, por @alkaz-nodemaven en [#430](https://github.com/D4Vinci/Scrapling/pull/430).
+- **Mejorada la lectura de la codificación de caracteres en las respuestas del navegador**, incluidas las declaraciones con distintas mayúsculas y minúsculas, espacios o valores entre comillas.
+- **Ya no se registra como error la ausencia de un desafío de Cloudflare** cuando no hay ningún desafío que resolver. Corrige [#459](https://github.com/D4Vinci/Scrapling/issues/459).
+
+- **Corregidas las huellas de las solicitudes** para los parámetros de consulta, por @yetval en [#448](https://github.com/D4Vinci/Scrapling/pull/448), los cuerpos JSON vacíos o con valores evaluados como falsos, por @ac1982 en [#480](https://github.com/D4Vinci/Scrapling/pull/480), y el orden de inserción de cabeceras, por @SarwadnyaMahajan en [#466](https://github.com/D4Vinci/Scrapling/pull/466).
+- **Corregida la transferencia no deseada de datos de la solicitud a los enlaces seguidos**, incluidas las cabeceras antiguas relacionadas con el cuerpo, por @yetval en [#462](https://github.com/D4Vinci/Scrapling/pull/462).
+- **Se impide guardar las respuestas bloqueadas como entradas correctas en la caché de desarrollo**, por @Kuang-xianxin en [#446](https://github.com/D4Vinci/Scrapling/pull/446).
+- **Se conservan los archivos de puntos de control cuando un rastreo falla con una excepción**, por @SulimanAbdulrazzaq en [#486](https://github.com/D4Vinci/Scrapling/pull/486).
+- **Corregida la gestión de errores de robots.txt** para que las consultas fallidas no se guarden en caché como permiso para rastrear, por @prateekraawat1 en [#443](https://github.com/D4Vinci/Scrapling/pull/443).
+- **Corregida la extracción de enlaces con selectores que limitan el ámbito**, incluidas las coincidencias vacías y los selectores que apuntan al propio elemento del enlace, por @SulimanAbdulrazzaq en [#452](https://github.com/D4Vinci/Scrapling/pull/452) y [#483](https://github.com/D4Vinci/Scrapling/pull/483).
+- **Corregida la asignación de callbacks del mapa del sitio**, por @SulimanAbdulrazzaq en [#458](https://github.com/D4Vinci/Scrapling/pull/458), **y el análisis de XML con comentarios o instrucciones de procesamiento**, por @sup3dev en [#450](https://github.com/D4Vinci/Scrapling/pull/450).
+- **Se manejan las marcas de orden de bytes al inicio de robots.txt y de los feeds CSV**, por @SulimanAbdulrazzaq en [#453](https://github.com/D4Vinci/Scrapling/pull/453).
+- **Corregido el manejo de `stealthy_headers` en las sesiones HTTP de los spiders**, pasando la opción a la sesión en lugar de enviarla directamente a `curl_cffi`, por @Yigtwxx en [#475](https://github.com/D4Vinci/Scrapling/pull/475).
+
+- **Corregida la codificación de formularios a partir de diccionarios con valores de tipo lista o tupla**, manteniendo la precedencia del cuerpo de la solicitud y el manejo existente de `None`, con aportes de @SulimanAbdulrazzaq en [#485](https://github.com/D4Vinci/Scrapling/pull/485).
+- **Corregida la combinación de cabeceras HTTP de sesión y de cada solicitud sin distinguir mayúsculas de minúsculas**, por @SulimanAbdulrazzaq en [#487](https://github.com/D4Vinci/Scrapling/pull/487).
+- **Corregidas las solicitudes de la CLI que descartaban sin avisar los cuerpos JSON vacíos o con valores evaluados como falsos**, por @SulimanAbdulrazzaq en [#484](https://github.com/D4Vinci/Scrapling/pull/484).
+- **Las exportaciones a archivos Markdown y de texto ahora usan siempre UTF-8**, y los errores de conversión ya no truncan un archivo de salida existente, por @SulimanAbdulrazzaq en [#488](https://github.com/D4Vinci/Scrapling/pull/488).
+- **Corregido el manejo de las opciones de agente de usuario y proxy de curl en `curl2fetcher()`**, por @SulimanAbdulrazzaq en [#490](https://github.com/D4Vinci/Scrapling/pull/490).
+
+- **Corregidos los bloques Markdown que se unían sin separación** al convertir varios elementos seleccionados mediante `Response.markdown()` o la extracción de la CLI, con aportes de @Yigtwxx en [#432](https://github.com/D4Vinci/Scrapling/pull/432).
+- **Corregida la limpieza del contenido oculto en la salida para IA** para conservar contenido visible como `opacity:0.95`, reconocer más estilos que ocultan contenido y eliminar slots ocultos, con aportes de @Yigtwxx en [#460](https://github.com/D4Vinci/Scrapling/pull/460).
+- **Corregida la eliminación de etiquetas de ruido que se detenía antes de tiempo ante etiquetas anidadas**, por @Yigtwxx en [#474](https://github.com/D4Vinci/Scrapling/pull/474).
+- **Corregidos los selectores CSS y XPath generados para el primero de varios elementos hermanos con la misma etiqueta**, por @yellow-dog-dog en [#495](https://github.com/D4Vinci/Scrapling/pull/495).
+- **Resuelta una advertencia de obsolescencia del analizador HTML de lxml**, por @afsuyadi en [#493](https://github.com/D4Vinci/Scrapling/pull/493).
+
+### Documentación {#v0.5-docs}
+
+- **El sitio completo ahora está en diez idiomas**: inglés, árabe, español, portugués de Brasil, francés, alemán, chino simplificado, japonés, ruso y coreano. Las guías, las referencias de API, los tutoriales y el [historial de cambios](changelog.md) están traducidos, con escritura de derecha a izquierda para el árabe y cambios de idioma que conservan la página y la sección.
+- **Guías, ejemplos del README y pasos de configuración más claros**, que abarcan los datos de puntos de control, las codificaciones del navegador, el estado guardado, el historial de red, Shadow DOM y el orden de rastreo.
+- **Actualizada la habilidad para agentes**, junto con sus ejemplos, referencias y archivo descargable, para las herramientas actuales del navegador y de MCP.
+- **El historial de cambios se ha trasladado al sitio web** y se ha añadido acceso al código fuente Markdown de cada página.
+
+### Proyecto {#v0.5-project}
+
+- Renovados el logotipo de Scrapling, las imágenes de portada y la presentación del sitio web.
+- Ampliadas las pruebas de acciones del navegador, diálogos, extracción, capturas de pantalla, JavaScript, registro de red, archivos de estado, Shadow DOM y correcciones del rastreador.
+- Añadido un marcador para las pruebas del navegador y ejecuciones separadas de las pruebas de navegador, asíncronas y en paralelo. Mejorada la compatibilidad con Windows de las pruebas de puntos de control y CSV, por @diegobravtraps-oss en [#457](https://github.com/D4Vinci/Scrapling/pull/457).
+- Actualizada la configuración compartida para compilar la documentación multilingüe y las instrucciones para contribuir.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**Una de las mayores versiones de este año: un servidor MCP renovado, Markdown listo para RAG en una línea, un solucionador de Cloudflare mejorado y pestañas del navegador que siguen abiertas para la automatización 🚀**
diff --git a/docs/locales/fr/changelog.md b/docs/locales/fr/changelog.md
index c3029a7..8af91cc 100644
--- a/docs/locales/fr/changelog.md
+++ b/docs/locales/fr/changelog.md
@@ -7,6 +7,89 @@ description: "Notes des versions de Scrapling, avec les nouvelles fonctionnalit
Tous les changements importants de Scrapling, tirés des [versions publiées sur GitHub](https://github.com/D4Vinci/Scrapling/releases).
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5 améliore presque tout : la récupération, l’analyse, les spiders, l’automatisation du navigateur, les outils IA et la documentation en dix langues 🚀**
+
+!!! warning "Avertissement"
+
+ **Cette version introduit trop de changements incompatibles pour tous les présenter ici. Consultez le [guide de migration vers v0.5](migrating-to-v0.5.md) avant de mettre à jour.**
+
+### 🚀 Nouveautés et améliorations d’utilisation {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **Un serveur MCP beaucoup plus complet pour les agents IA, capable de résoudre presque tous les CAPTCHA** (consultez la [documentation](ai/mcp-server.md)) :
+
+ - **Des parcours complets dans le navigateur** : remplissez des formulaires, cliquez, survolez, faites défiler, utilisez le clavier, gérez les boîtes de dialogue et attendez les résultats dans une seule séquence ordonnée. Différents types de champs et des interactions plus lentes sont pris en charge. Les actions s’arrêtent à la première erreur.
+ - **Lisez et recherchez dans la page actuelle sans la recharger** : extrayez du HTML, du Markdown ou du texte de toute la page ou d’un élément. Les instantanés de page permettent la recherche et affichent les rôles, les noms et les positions des éléments, avec des vues ciblées qui conservent le contexte environnant.
+ - **Exécutez votre JavaScript et prenez des captures d’écran ciblées** : exécutez des scripts, y compris des opérations asynchrones, avec accès au JavaScript de la page. Capturez un élément, la zone visible ou toute la page en PNG ou JPEG.
+ - **Inspectez l’activité réseau et réutilisez vos connexions** : examinez les requêtes et réponses enregistrées, sauvegardez et restaurez l’état de connexion du navigateur, et interagissez avec les éléments dans un Shadow DOM ouvert ou fermé. Lisez le trafic enregistré avant de fermer la session.
+ - **Utilisez moins de tokens et obtenez des erreurs plus claires** : des descriptions d’outils plus courtes et des instructions communes réduisent les répétitions. Les erreurs du navigateur et des requêtes parviennent aux agents avec des messages utiles.
+
+- **Voyez les requêtes derrière la page**. Activez `record_requests=True` pour enregistrer le trafic terminé au fil des chargements, des actions et des onglets, puis inspectez les réponses sauvegardées sans renvoyer de requêtes. (Consultez la [documentation](fetching/stealthy.md#network-history))
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - Filtrez par URL, méthode, type de ressource ou statut ; récupérez une réponse par son identifiant. Inspectez les en-têtes, les données envoyées, les réponses API, les erreurs HTTP et les redirections avec l’API `Response` habituelle.
+ - Conserve les corps de réponse textuels pris en charge, dans les limites de taille, ainsi que les métadonnées et le motif si un corps ne peut pas être enregistré. La limite par défaut est de 1 000 requêtes. Fonctionne avec les sessions synchrones et asynchrones ; l’historique Python sauvegardé reste lisible après la fermeture.
+
+- **Sauvegardez une connexion une fois et réutilisez-la d’une exécution à l’autre**. `save_state(path)` et `load_state(path)` enregistrent les cookies, le stockage local et IndexedDB dans un JSON compatible avec Playwright. Les sessions du navigateur synchrones et asynchrones les prennent en charge. (Consultez la [documentation](fetching/stealthy.md#save-and-load-session-state))
+ - Chargez l’état avant de récupérer ou de recharger une page. Nécessite un contexte de navigateur partagé et démarré, sans `proxy_rotator` ; les onglets, les réglages du navigateur et `sessionStorage` ne sont pas sauvegardés.
+
+- **Extrayez le Shadow DOM ouvert avec `pierce_shadow=True`**, puis utilisez CSS ou XPath comme d’habitude. Disponible dans les fetchers de navigateur, les sessions et l’option CLI `--pierce-shadow`. Conserve le contenu des slots sans modifier la page active. La capture HTML exclut les racines fermées et les documents iframe. (Consultez la [documentation](fetching/stealthy.md#shadow-dom))
+
+- **Choisissez comment votre spider explore un site**. `CrawlSpider` et ses sous-classes, dont `ContentSpider`, acceptent `crawl_strategy="bfs"` pour traiter d’abord les requêtes les plus anciennes, ou `"dfs"` pour traiter d’abord les plus récentes. La priorité reste déterminante, et les pages traitées en parallèle peuvent se terminer dans un ordre différent. (Consultez la [documentation](spiders/generic-templates.md#crawl-order))
+
+### 🐛 Corrections de bugs {#v0.5-bug-fixes}
+
+- **Amélioration de la résolution Cloudflare** avec la détection des widgets qui apparaissent plus tard, moins d’attentes inutiles et des boucles de nouvelle tentative limitées pour les défis passifs et les frames cachées. Corrige [#468](https://github.com/D4Vinci/Scrapling/issues/468) et [#509](https://github.com/D4Vinci/Scrapling/issues/509).
+- **Correction du démarrage du navigateur depuis un shell Windows lancé en tant qu’administrateur**. Corrige [#463](https://github.com/D4Vinci/Scrapling/issues/463).
+- **Conservation des options de discrétion intégrées lors de l’ajout d’options de navigateur personnalisées**, par @alkaz-nodemaven dans [#430](https://github.com/D4Vinci/Scrapling/pull/430).
+- **Amélioration de l’analyse du jeu de caractères des réponses du navigateur**, y compris les déclarations avec des variations de casse, des espaces ou des valeurs entre guillemets.
+- **L’absence de défi Cloudflare n’est plus enregistrée comme une erreur** lorsqu’aucun défi n’a besoin d’être résolu. Corrige [#459](https://github.com/D4Vinci/Scrapling/issues/459).
+
+- **Correction des empreintes de requête** pour les paramètres d’URL, par @yetval dans [#448](https://github.com/D4Vinci/Scrapling/pull/448), pour les corps JSON vides ou évalués comme faux, par @ac1982 dans [#480](https://github.com/D4Vinci/Scrapling/pull/480), et pour l’ordre d’insertion des en-têtes, par @SarwadnyaMahajan dans [#466](https://github.com/D4Vinci/Scrapling/pull/466).
+- **Correction de la propagation des données de requête aux liens suivis**, y compris les anciens en-têtes liés au corps, par @yetval dans [#462](https://github.com/D4Vinci/Scrapling/pull/462).
+- **Les réponses bloquées ne sont plus enregistrées comme des entrées réussies du cache de développement**, par @Kuang-xianxin dans [#446](https://github.com/D4Vinci/Scrapling/pull/446).
+- **Conservation des fichiers de point de contrôle lorsqu’une exploration échoue avec une exception**, par @SulimanAbdulrazzaq dans [#486](https://github.com/D4Vinci/Scrapling/pull/486).
+- **Correction de la gestion des erreurs de robots.txt**, afin que les consultations échouées ne soient pas mises en cache comme une autorisation d’explorer, par @prateekraawat1 dans [#443](https://github.com/D4Vinci/Scrapling/pull/443).
+- **Correction de l’extraction des liens avec des sélecteurs de restriction**, y compris les correspondances vides et les sélecteurs qui ciblent l’élément du lien lui-même, par @SulimanAbdulrazzaq dans [#452](https://github.com/D4Vinci/Scrapling/pull/452) et [#483](https://github.com/D4Vinci/Scrapling/pull/483).
+- **Correction du choix des callbacks de sitemap**, par @SulimanAbdulrazzaq dans [#458](https://github.com/D4Vinci/Scrapling/pull/458), **et de l’analyse XML avec des commentaires ou des instructions de traitement**, par @sup3dev dans [#450](https://github.com/D4Vinci/Scrapling/pull/450).
+- **Prise en charge des indicateurs d’ordre des octets en début de robots.txt et des flux CSV**, par @SulimanAbdulrazzaq dans [#453](https://github.com/D4Vinci/Scrapling/pull/453).
+- **Correction de la gestion de `stealthy_headers` dans les sessions HTTP des spiders**, en passant l’option à la session au lieu de la transmettre directement à `curl_cffi`, par @Yigtwxx dans [#475](https://github.com/D4Vinci/Scrapling/pull/475).
+
+- **Correction de l’encodage des formulaires fournis comme dictionnaires pour les valeurs de type liste et tuple**, tout en conservant la priorité du corps de requête et la gestion actuelle de `None`, avec des contributions de @SulimanAbdulrazzaq dans [#485](https://github.com/D4Vinci/Scrapling/pull/485).
+- **Correction de la fusion sans distinction de casse des en-têtes HTTP de session et de requête**, par @SulimanAbdulrazzaq dans [#487](https://github.com/D4Vinci/Scrapling/pull/487).
+- **Correction des requêtes CLI qui ignoraient sans avertissement les corps JSON vides ou évalués comme faux**, par @SulimanAbdulrazzaq dans [#484](https://github.com/D4Vinci/Scrapling/pull/484).
+- **Les exports de fichiers Markdown et texte utilisent toujours UTF-8**, et les erreurs de conversion ne tronquent plus un fichier de sortie existant, par @SulimanAbdulrazzaq dans [#488](https://github.com/D4Vinci/Scrapling/pull/488).
+- **Correction de la gestion des options user-agent et proxy de curl dans `curl2fetcher()`**, par @SulimanAbdulrazzaq dans [#490](https://github.com/D4Vinci/Scrapling/pull/490).
+
+- **Correction des blocs Markdown qui se retrouvaient collés** lorsque plusieurs éléments sélectionnés sont convertis avec `Response.markdown()` ou l’extraction CLI, avec des contributions de @Yigtwxx dans [#432](https://github.com/D4Vinci/Scrapling/pull/432).
+- **Correction du nettoyage du contenu caché pour les sorties IA**, afin de conserver le contenu visible tel que `opacity:0.95`, de reconnaître davantage de styles cachés et de supprimer les slots cachés, avec des contributions de @Yigtwxx dans [#460](https://github.com/D4Vinci/Scrapling/pull/460).
+- **Correction de la suppression des balises inutiles qui s’arrêtait trop tôt autour des balises imbriquées**, par @Yigtwxx dans [#474](https://github.com/D4Vinci/Scrapling/pull/474).
+- **Correction des sélecteurs CSS et XPath générés pour le premier de plusieurs éléments frères de même balise**, par @yellow-dog-dog dans [#495](https://github.com/D4Vinci/Scrapling/pull/495).
+- **Résolution d’un avertissement de dépréciation de l’analyseur HTML lxml**, par @afsuyadi dans [#493](https://github.com/D4Vinci/Scrapling/pull/493).
+
+### Documentation {#v0.5-docs}
+
+- **Tout le site parle maintenant dix langues** : anglais, arabe, espagnol, portugais brésilien, français, allemand, chinois simplifié, japonais, russe et coréen. Les guides, les références API, les tutoriels et l’[historique des changements](changelog.md) sont traduits, avec l’affichage de droite à gauche pour l’arabe et un changement de langue qui conserve la page et la section.
+- **Des guides, des exemples README et des étapes d’installation plus clairs**, couvrant les données des points de contrôle, les encodages du navigateur, l’état sauvegardé, l’historique réseau, le Shadow DOM et l’ordre d’exploration.
+- **Mise à jour de l’Agent Skill**, de ses exemples, de ses références et de son archive téléchargeable pour les outils actuels de navigateur et MCP.
+- **Déplacement de l’historique des changements vers le site** et ajout de l’accès à la source Markdown de chaque page.
+
+### Projet {#v0.5-project}
+
+- Actualisation du logo de Scrapling, des images de couverture et de la présentation du site.
+- Ajout de tests pour les actions du navigateur, les boîtes de dialogue, l’extraction, les captures d’écran, JavaScript, l’enregistrement réseau, les fichiers d’état, le Shadow DOM et les corrections du crawler.
+- Ajout d’un marqueur pour les tests de navigateur et d’exécutions séparées pour les tests de navigateur, asynchrones et parallèles. Amélioration de la compatibilité des tests de points de contrôle et CSV sous Windows, par @diegobravtraps-oss dans [#457](https://github.com/D4Vinci/Scrapling/pull/457).
+- Mise à jour de la configuration commune de compilation de la documentation multilingue et des consignes de contribution.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**L’une des plus grandes versions de l’année : un serveur MCP repensé, du Markdown prêt pour RAG en une ligne, une meilleure résolution des défis Cloudflare et des onglets qui restent ouverts pour l’automatisation 🚀**
diff --git a/docs/locales/ja/changelog.md b/docs/locales/ja/changelog.md
index 9232085..a34cc42 100644
--- a/docs/locales/ja/changelog.md
+++ b/docs/locales/ja/changelog.md
@@ -7,6 +7,89 @@ description: "Scrapling のリリースノートです。新機能、修正、
Scrapling の主な変更を、[GitHub のリリース](https://github.com/D4Vinci/Scrapling/releases)からまとめています。
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5 は、取得処理、解析、Spider、ブラウザの自動操作、AI ツール、10 言語のドキュメントまで、ほぼすべてを更新するリリースです 🚀**
+
+!!! warning "警告"
+
+ **このリリースには互換性に影響する変更が多数あり、ここではすべてを紹介できません。更新前に[v0.5 への移行ガイド](migrating-to-v0.5.md)を確認してください。**
+
+### 🚀 新機能と使いやすさの改善 {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **AI エージェント向けの MCP サーバーの機能を大幅に増やし、ほぼすべての CAPTCHA を解決できるようになりました**([ドキュメント](ai/mcp-server.md)を参照):
+
+ - **ブラウザ上の操作をまとめて実行できます**。フォーム入力、クリック、ホバー、スクロール、キーボード操作、ダイアログ処理、結果の待機を、指定した順番で実行します。さまざまな入力欄とゆっくりした操作に対応し、最初のエラーで操作を停止します。
+ - **再読み込みせずに現在のページを読み取り、検索できます**。ページ全体または単一の要素から、HTML、Markdown、テキストを抽出します。検索できるページスナップショットには、要素のロール、名前、位置が表示されます。対象を絞った表示でも、周囲の文脈を保持します。
+ - **独自の JavaScript を実行し、必要な部分のスクリーンショットを撮影できます**。ページ自身の JavaScript にアクセスして、非同期処理を含むスクリプトを実行できます。個別の要素、ビューポート、ページ全体を PNG または JPEG で撮影できます。
+ - **ネットワーク通信を確認し、ログイン状態を再利用できます**。記録したリクエストとレスポンスを調べ、ブラウザのログイン状態を保存、復元できます。開いた Shadow DOM と閉じた Shadow DOM の中にある要素も操作できます。記録した通信は、セッションを閉じる前に読み取ってください。
+ - **トークンの使用量を減らし、エラーをわかりやすくしました**。短いツール説明と共通の案内で重複する文章を減らしました。ブラウザやリクエストの失敗も、役に立つエラーメッセージとともにエージェントに届きます。
+
+- **ページの裏側で発生するリクエストを確認できます**。`record_requests=True` を有効にすると、ページの読み込み、操作、タブをまたいで完了した通信を記録します。リクエストを再送せずに、保存したレスポンスを調べられます([ドキュメント](fetching/stealthy.md#network-history)を参照)。
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - URL、メソッド、リソースの種類、ステータスで絞り込み、ID で 1 つのレスポンスを取得できます。通常の `Response` API を使って、ヘッダー、送信データ、API レスポンス、HTTP エラー、リダイレクトを確認できます。
+ - 対応するテキスト本文をサイズ制限内で保持し、メタデータと、本文を保存できない場合の理由も記録します。既定の上限は 1,000 リクエストです。同期、非同期のセッションに対応し、保存した Python の履歴はセッションを閉じた後も読み取れます。
+
+- **一度保存したログイン状態を、次の実行でも再利用できます**。`save_state(path)` と `load_state(path)` は、Cookie、ローカルストレージ、IndexedDB を Playwright と互換性のある JSON で保存します。同期、非同期のブラウザセッションで利用できます([ドキュメント](fetching/stealthy.md#save-and-load-session-state)を参照)。
+ - ページの取得や再読み込みの前に状態を読み込んでください。起動済みの共有ブラウザコンテキストが必要で、`proxy_rotator` は使用できません。タブ、ブラウザ設定、`sessionStorage` は保存されません。
+
+- **`pierce_shadow=True` で開いた Shadow DOM を抽出できます**。抽出後は、通常どおり CSS や XPath を使えます。ブラウザ Fetcher、セッション、CLI の `--pierce-shadow` オプションで利用できます。実際のページを変更せず、スロットの内容を保持します。取得する HTML には、閉じた Shadow ルートと iframe のドキュメントは含まれません([ドキュメント](fetching/stealthy.md#shadow-dom)を参照)。
+
+- **Spider がサイトをたどる順序を選べます**。`CrawlSpider` と、`ContentSpider` を含むそのサブクラスでは、`crawl_strategy="bfs"` で先に追加したリクエストから、`"dfs"` で後に追加したリクエストから処理するように設定できます。リクエストの優先度はこの順序より優先され、同時に処理するページの完了順は異なる場合があります([ドキュメント](spiders/generic-templates.md#crawl-order)を参照)。
+
+### 🐛 バグ修正 {#v0.5-bug-fixes}
+
+- **Cloudflare チャレンジの解決を改善しました**。遅れて表示されるウィジェットを検出し、不要な待機を減らし、受動型チャレンジと非表示フレームの再試行ループに上限を設けました([#468](https://github.com/D4Vinci/Scrapling/issues/468) と [#509](https://github.com/D4Vinci/Scrapling/issues/509) を修正)。
+- **管理者権限で実行した Windows シェルからブラウザを起動する問題を修正しました**([#463](https://github.com/D4Vinci/Scrapling/issues/463) を修正)。
+- **独自のブラウザフラグを追加しても、組み込みのステルス用フラグを保持するようにしました**。@alkaz-nodemaven による [#430](https://github.com/D4Vinci/Scrapling/pull/430) の変更です。
+- **ブラウザのレスポンスの文字セット解析を改善しました**。大文字と小文字の違い、空白、引用符で囲まれた値を含む宣言にも対応します。
+- **解決すべき Cloudflare チャレンジがない場合に、チャレンジが見つからないことをエラーとして記録しないようにしました**([#459](https://github.com/D4Vinci/Scrapling/issues/459) を修正)。
+
+- **リクエストのフィンガープリントを修正しました**。クエリパラメーターは @yetval による [#448](https://github.com/D4Vinci/Scrapling/pull/448)、空または偽と評価される JSON 本文は @ac1982 による [#480](https://github.com/D4Vinci/Scrapling/pull/480)、ヘッダーの挿入順序は @SarwadnyaMahajan による [#466](https://github.com/D4Vinci/Scrapling/pull/466) の変更です。
+- **リンクをたどる際に、前のリクエストのデータが引き継がれる問題を修正しました**。古い本文関連ヘッダーが残る問題も含みます。@yetval による [#462](https://github.com/D4Vinci/Scrapling/pull/462) の変更です。
+- **ブロックされたレスポンスが、成功したレスポンスとして開発用キャッシュに保存されないようにしました**。@Kuang-xianxin による [#446](https://github.com/D4Vinci/Scrapling/pull/446) の変更です。
+- **クロールが例外で失敗した場合に、チェックポイントファイルを保持するようにしました**。@SulimanAbdulrazzaq による [#486](https://github.com/D4Vinci/Scrapling/pull/486) の変更です。
+- **robots.txt の取得に失敗した場合の処理を修正しました**。取得失敗をクロールの許可としてキャッシュしないようにしました。@prateekraawat1 による [#443](https://github.com/D4Vinci/Scrapling/pull/443) の変更です。
+- **範囲を制限するセレクターを使ったリンク抽出を修正しました**。一致する要素がない場合と、リンク要素自体を選択する場合に対応します。@SulimanAbdulrazzaq による [#452](https://github.com/D4Vinci/Scrapling/pull/452) と [#483](https://github.com/D4Vinci/Scrapling/pull/483) の変更です。
+- **サイトマップのコールバックの振り分けを修正しました**。@SulimanAbdulrazzaq による [#458](https://github.com/D4Vinci/Scrapling/pull/458) の変更です。**コメントや処理命令を含む XML の解析も修正しました**。@sup3dev による [#450](https://github.com/D4Vinci/Scrapling/pull/450) の変更です。
+- **robots.txt と CSV フィードの先頭にあるバイトオーダーマークに対応しました**。@SulimanAbdulrazzaq による [#453](https://github.com/D4Vinci/Scrapling/pull/453) の変更です。
+- **Spider の HTTP セッションでの `stealthy_headers` の扱いを修正しました**。`curl_cffi` に直接渡さず、セッションに渡すようにしました。@Yigtwxx による [#475](https://github.com/D4Vinci/Scrapling/pull/475) の変更です。
+
+- **辞書形式のフォームで、リストとタプルの値のエンコードを修正しました**。リクエスト本文の優先順位と、既存の `None` の扱いは維持します。@SulimanAbdulrazzaq による [#485](https://github.com/D4Vinci/Scrapling/pull/485) の貢献を含みます。
+- **セッションとリクエストごとの HTTP ヘッダーを、大文字と小文字を区別せずに結合する処理を修正しました**。@SulimanAbdulrazzaq による [#487](https://github.com/D4Vinci/Scrapling/pull/487) の変更です。
+- **CLI のリクエストで、空または偽と評価される JSON 本文が通知なく捨てられる問題を修正しました**。@SulimanAbdulrazzaq による [#484](https://github.com/D4Vinci/Scrapling/pull/484) の変更です。
+- **Markdown とテキストファイルの書き出しで、常に UTF-8 を使うようにしました**。変換エラーによって既存の出力ファイルが切り詰められる問題も防ぎます。@SulimanAbdulrazzaq による [#488](https://github.com/D4Vinci/Scrapling/pull/488) の変更です。
+- **`curl2fetcher()` での curl の User-Agent とプロキシのオプション処理を修正しました**。@SulimanAbdulrazzaq による [#490](https://github.com/D4Vinci/Scrapling/pull/490) の変更です。
+
+- **選択した複数の要素を `Response.markdown()` または CLI の抽出処理で変換すると、Markdown のブロックがつながってしまう問題を修正しました**。@Yigtwxx による [#432](https://github.com/D4Vinci/Scrapling/pull/432) の貢献を含みます。
+- **AI 向け出力での非表示コンテンツの除去を修正しました**。`opacity:0.95` のような表示される内容を残し、より多くの非表示スタイルを認識し、非表示のスロットを取り除きます。@Yigtwxx による [#460](https://github.com/D4Vinci/Scrapling/pull/460) の貢献を含みます。
+- **タグが入れ子になっている箇所で、不要なタグの除去が途中で止まる問題を修正しました**。@Yigtwxx による [#474](https://github.com/D4Vinci/Scrapling/pull/474) の変更です。
+- **同じタグの兄弟要素が複数あるとき、最初の要素に対して生成する CSS と XPath のセレクターを修正しました**。@yellow-dog-dog による [#495](https://github.com/D4Vinci/Scrapling/pull/495) の変更です。
+- **lxml の HTML パーサーの非推奨警告を解消しました**。@afsuyadi による [#493](https://github.com/D4Vinci/Scrapling/pull/493) の変更です。
+
+### ドキュメント {#v0.5-docs}
+
+- **Web サイト全体が 10 言語に対応しました**。英語、アラビア語、スペイン語、ブラジルポルトガル語、フランス語、ドイツ語、簡体字中国語、日本語、ロシア語、韓国語で利用できます。ガイド、API リファレンス、チュートリアル、[変更履歴](changelog.md)を翻訳しました。アラビア語の右から左への表示に対応し、言語を切り替えても現在のページとセクションを保持します。
+- **ガイド、README の例、セットアップ手順をわかりやすくしました**。チェックポイントのデータ、ブラウザの文字コード、保存した状態、ネットワーク履歴、Shadow DOM、クロール順序について説明しています。
+- **Agent Skill と、その例、参考資料、ダウンロード用アーカイブを更新しました**。現在のブラウザと MCP のツールに対応しています。
+- **変更履歴を Web サイトに移しました**。各ページの Markdown ソースも参照できるようにしました。
+
+### プロジェクト {#v0.5-project}
+
+- Scrapling のロゴ、カバー画像、Web サイトの見た目を更新しました。
+- ブラウザ操作、ダイアログ、抽出、スクリーンショット、JavaScript、ネットワーク記録、状態ファイル、Shadow DOM、クローラーの修正に関するテストを増やしました。
+- ブラウザテスト用のマーカーを追加し、ブラウザ、非同期、並列のテストを分けて実行するようにしました。@diegobravtraps-oss による [#457](https://github.com/D4Vinci/Scrapling/pull/457) で、Windows でのチェックポイントと CSV のテストの移植性を改善しました。
+- 多言語ドキュメントで共有するビルド設定と、貢献の案内を更新しました。
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**今年最大規模のリリースの 1 つです。MCP サーバーを作り直し、1 行で RAG 用の Markdown を生成できるようにしました。Cloudflare チャレンジの解決を改善し、自動操作のためにブラウザタブを開いたままにします 🚀**
diff --git a/docs/locales/ko/changelog.md b/docs/locales/ko/changelog.md
index ba30b83..1fbe703 100644
--- a/docs/locales/ko/changelog.md
+++ b/docs/locales/ko/changelog.md
@@ -7,6 +7,89 @@ description: "새 기능, 수정 사항, 호환성에 영향을 주는 변경
[GitHub 릴리스](https://github.com/D4Vinci/Scrapling/releases)에서 가져온 Scrapling의 주요 변경 사항을 모두 모았습니다.
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5는 가져오기, 파싱, 스파이더, 브라우저 자동화, AI 도구, 10개 언어로 된 문서까지 거의 모든 부분을 개선한 릴리스입니다 🚀**
+
+!!! warning "주의"
+
+ **이 릴리스에는 여기에 모두 담을 수 없을 만큼 호환성에 영향을 주는 변경 사항이 많습니다. 업데이트 전에 [v0.5 마이그레이션 가이드](migrating-to-v0.5.md)를 확인하세요.**
+
+### 🚀 새 기능과 사용 편의 개선 {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **AI 에이전트를 위한 MCP 서버의 기능이 크게 늘어나 거의 모든 CAPTCHA를 해결할 수 있습니다**([문서](ai/mcp-server.md) 참고):
+
+ - **브라우저 작업을 처음부터 끝까지 실행합니다**. 폼 입력, 클릭, 마우스 올리기, 스크롤, 키보드 사용, 대화 상자 처리, 결과 대기를 지정한 순서대로 실행합니다. 다양한 입력 필드와 느린 동작을 지원하며, 첫 오류가 발생하면 작업을 멈춥니다.
+ - **다시 로드하지 않고 현재 페이지를 읽고 검색합니다**. 페이지 전체나 요소 하나에서 HTML, Markdown, 텍스트를 추출합니다. 검색 가능한 페이지 스냅샷은 요소의 역할, 이름, 위치를 표시하며, 특정 부분만 볼 때도 주변 맥락을 유지합니다.
+ - **사용자 지정 JavaScript를 실행하고 원하는 부분을 캡처합니다**. 페이지 자체의 JavaScript에 접근해 비동기 작업을 포함한 스크립트를 실행합니다. 개별 요소, 뷰포트, 전체 페이지를 PNG나 JPEG로 캡처할 수 있습니다.
+ - **네트워크 활동을 확인하고 로그인 상태를 재사용합니다**. 기록된 요청과 응답을 살펴보고, 브라우저 로그인 상태를 저장하고 복원하며, 열리거나 닫힌 Shadow DOM 내부의 요소를 조작할 수 있습니다. 기록된 통신은 세션을 닫기 전에 읽으세요.
+ - **토큰 사용을 줄이고 오류를 더 명확히 전달합니다**. 짧은 도구 설명과 공통 지침으로 반복되는 내용을 줄였습니다. 브라우저나 요청이 실패하면 에이전트에 유용한 오류 메시지를 전달합니다.
+
+- **페이지 뒤에서 일어나는 요청을 볼 수 있습니다**. `record_requests=True`를 켜면 페이지 로드, 동작, 여러 탭에서 완료된 통신을 기록합니다. 요청을 다시 보내지 않고 저장된 응답을 확인할 수 있습니다([문서](fetching/stealthy.md#network-history) 참고).
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - URL, 메서드, 리소스 유형, 상태로 필터링하거나 ID로 응답 하나를 가져올 수 있습니다. 기존 `Response` API로 헤더, 보낸 데이터, API 응답, HTTP 오류, 리디렉션을 확인합니다.
+ - 지원되는 텍스트 본문을 크기 제한 안에서 보관합니다. 메타데이터와 본문을 저장할 수 없을 때의 이유도 기록합니다. 기본 한도는 요청 1,000개입니다. 동기 및 비동기 세션을 지원하며, 저장된 Python 기록은 세션을 닫은 뒤에도 읽을 수 있습니다.
+
+- **로그인 상태를 한 번 저장하고 여러 실행에서 재사용합니다**. `save_state(path)`와 `load_state(path)`는 쿠키, 로컬 스토리지, IndexedDB를 Playwright와 호환되는 JSON으로 저장합니다. 동기 및 비동기 브라우저 세션에서 모두 지원합니다([문서](fetching/stealthy.md#save-and-load-session-state) 참고).
+ - 페이지를 가져오거나 다시 로드하기 전에 상태를 불러오세요. 시작된 공유 브라우저 컨텍스트가 필요하며 `proxy_rotator`는 사용할 수 없습니다. 탭, 브라우저 설정, `sessionStorage`는 저장하지 않습니다.
+
+- **`pierce_shadow=True`로 열린 Shadow DOM을 추출할 수 있습니다**. 그다음 평소처럼 CSS나 XPath를 사용하세요. 브라우저 Fetcher, 세션, CLI의 `--pierce-shadow` 옵션에서 사용할 수 있습니다. 실제 페이지를 바꾸지 않고 슬롯 내용을 유지합니다. 캡처한 HTML에는 닫힌 Shadow 루트와 iframe 문서가 포함되지 않습니다([문서](fetching/stealthy.md#shadow-dom) 참고).
+
+- **스파이더가 사이트를 탐색하는 순서를 선택할 수 있습니다**. `CrawlSpider`와 `ContentSpider`를 포함한 하위 클래스는 `crawl_strategy="bfs"`로 먼저 들어온 요청부터, `"dfs"`로 나중에 들어온 요청부터 처리하도록 예약할 수 있습니다. 요청의 우선순위가 계속 우선하며, 동시에 처리하는 페이지는 다른 순서로 완료될 수 있습니다([문서](spiders/generic-templates.md#crawl-order) 참고).
+
+### 🐛 버그 수정 {#v0.5-bug-fixes}
+
+- **Cloudflare 검사 처리를 개선했습니다**. 늦게 나타나는 위젯을 감지하고, 불필요한 대기를 줄였으며, 수동 조작이 필요 없는 검사와 숨겨진 프레임의 재시도 횟수에 제한을 두었습니다([#468](https://github.com/D4Vinci/Scrapling/issues/468)과 [#509](https://github.com/D4Vinci/Scrapling/issues/509) 수정).
+- **관리자 권한으로 실행한 Windows 셸에서 브라우저가 시작되지 않는 문제를 수정했습니다**([#463](https://github.com/D4Vinci/Scrapling/issues/463) 수정).
+- **사용자 지정 브라우저 플래그를 추가할 때도 기본 스텔스 플래그를 유지합니다**. @alkaz-nodemaven의 [#430](https://github.com/D4Vinci/Scrapling/pull/430) 기여입니다.
+- **브라우저 응답의 문자 집합 파싱을 개선했습니다**. 대소문자가 다르거나 공백, 따옴표로 감싼 값이 있는 선언도 지원합니다.
+- **해결할 Cloudflare 검사가 없을 때, 검사가 없다는 사실을 오류로 기록하지 않습니다**([#459](https://github.com/D4Vinci/Scrapling/issues/459) 수정).
+
+- **요청 지문을 수정했습니다**. 쿼리 매개변수는 @yetval의 [#448](https://github.com/D4Vinci/Scrapling/pull/448), 비어 있거나 거짓으로 평가되는 JSON 본문은 @ac1982의 [#480](https://github.com/D4Vinci/Scrapling/pull/480), 헤더 삽입 순서는 @SarwadnyaMahajan의 [#466](https://github.com/D4Vinci/Scrapling/pull/466) 기여입니다.
+- **링크를 따라갈 때 이전 요청의 데이터가 넘어가는 문제를 수정했습니다**. 남아 있던 본문 관련 헤더도 포함합니다. @yetval의 [#462](https://github.com/D4Vinci/Scrapling/pull/462) 기여입니다.
+- **차단된 응답이 성공한 응답으로 개발 캐시에 저장되지 않도록 했습니다**. @Kuang-xianxin의 [#446](https://github.com/D4Vinci/Scrapling/pull/446) 기여입니다.
+- **예외로 크롤링이 실패하면 체크포인트 파일을 보존합니다**. @SulimanAbdulrazzaq의 [#486](https://github.com/D4Vinci/Scrapling/pull/486) 기여입니다.
+- **robots.txt 조회 실패 처리를 수정했습니다**. 조회에 실패한 결과를 크롤링 허용으로 캐시하지 않습니다. @prateekraawat1의 [#443](https://github.com/D4Vinci/Scrapling/pull/443) 기여입니다.
+- **범위를 제한하는 선택자를 사용한 링크 추출을 수정했습니다**. 일치하는 요소가 없거나 선택자가 링크 요소 자체를 가리키는 경우도 처리합니다. @SulimanAbdulrazzaq의 [#452](https://github.com/D4Vinci/Scrapling/pull/452)와 [#483](https://github.com/D4Vinci/Scrapling/pull/483) 기여입니다.
+- **사이트맵의 콜백 연결을 수정했습니다**. @SulimanAbdulrazzaq의 [#458](https://github.com/D4Vinci/Scrapling/pull/458) 기여입니다. **주석이나 처리 명령이 포함된 XML의 파싱도 수정했습니다**. @sup3dev의 [#450](https://github.com/D4Vinci/Scrapling/pull/450) 기여입니다.
+- **robots.txt와 CSV 피드의 시작 부분에 있는 바이트 순서 표시를 처리합니다**. @SulimanAbdulrazzaq의 [#453](https://github.com/D4Vinci/Scrapling/pull/453) 기여입니다.
+- **스파이더 HTTP 세션에서 `stealthy_headers`를 처리하는 방식을 수정했습니다**. 옵션을 `curl_cffi`에 직접 전달하지 않고 세션에 전달합니다. @Yigtwxx의 [#475](https://github.com/D4Vinci/Scrapling/pull/475) 기여입니다.
+
+- **딕셔너리 폼에서 리스트와 튜플 값을 인코딩하는 문제를 수정했습니다**. 요청 본문의 우선순위와 기존 `None` 처리는 유지합니다. @SulimanAbdulrazzaq의 [#485](https://github.com/D4Vinci/Scrapling/pull/485) 기여를 포함합니다.
+- **세션과 개별 요청의 HTTP 헤더를 대소문자 구분 없이 합치는 처리를 수정했습니다**. @SulimanAbdulrazzaq의 [#487](https://github.com/D4Vinci/Scrapling/pull/487) 기여입니다.
+- **CLI 요청에서 비어 있거나 거짓으로 평가되는 JSON 본문을 알림 없이 버리는 문제를 수정했습니다**. @SulimanAbdulrazzaq의 [#484](https://github.com/D4Vinci/Scrapling/pull/484) 기여입니다.
+- **Markdown과 텍스트 파일을 내보낼 때 항상 UTF-8을 사용합니다**. 변환 오류로 기존 출력 파일의 내용이 잘리는 문제도 방지했습니다. @SulimanAbdulrazzaq의 [#488](https://github.com/D4Vinci/Scrapling/pull/488) 기여입니다.
+- **`curl2fetcher()`에서 curl의 User-Agent 및 프록시 옵션 처리를 수정했습니다**. @SulimanAbdulrazzaq의 [#490](https://github.com/D4Vinci/Scrapling/pull/490) 기여입니다.
+
+- **선택한 여러 요소를 `Response.markdown()`이나 CLI 추출로 변환할 때 Markdown 블록이 붙어 버리는 문제를 수정했습니다**. @Yigtwxx의 [#432](https://github.com/D4Vinci/Scrapling/pull/432) 기여를 포함합니다.
+- **AI 출력의 숨겨진 콘텐츠 정리를 수정했습니다**. `opacity:0.95`처럼 보이는 내용은 유지하고, 더 많은 숨김 스타일을 감지하며, 숨겨진 슬롯은 제거합니다. @Yigtwxx의 [#460](https://github.com/D4Vinci/Scrapling/pull/460) 기여를 포함합니다.
+- **중첩된 태그 주변에서 불필요한 태그 제거가 일찍 멈추는 문제를 수정했습니다**. @Yigtwxx의 [#474](https://github.com/D4Vinci/Scrapling/pull/474) 기여입니다.
+- **같은 태그를 가진 형제 요소가 여러 개일 때 첫 요소에 대해 생성하는 CSS와 XPath 선택자를 수정했습니다**. @yellow-dog-dog의 [#495](https://github.com/D4Vinci/Scrapling/pull/495) 기여입니다.
+- **lxml HTML 파서의 지원 중단 예정 경고를 해결했습니다**. @afsuyadi의 [#493](https://github.com/D4Vinci/Scrapling/pull/493) 기여입니다.
+
+### 문서 {#v0.5-docs}
+
+- **웹사이트 전체를 10개 언어로 제공합니다**. 영어, 아랍어, 스페인어, 브라질 포르투갈어, 프랑스어, 독일어, 중국어 간체, 일본어, 러시아어, 한국어를 지원합니다. 가이드, API 참조, 튜토리얼, [변경 기록](changelog.md)을 번역했습니다. 아랍어의 오른쪽에서 왼쪽으로 쓰는 방향을 지원하며, 언어를 바꿔도 현재 페이지와 섹션을 유지합니다.
+- **가이드, README 예제, 설정 단계를 더 명확히 했습니다**. 체크포인트 데이터, 브라우저 인코딩, 저장된 상태, 네트워크 기록, Shadow DOM, 크롤링 순서를 다룹니다.
+- **Agent Skill과 예제, 참고 자료, 다운로드용 압축 파일을 업데이트했습니다**. 현재 브라우저 및 MCP 도구에 맞췄습니다.
+- **변경 기록을 웹사이트로 옮겼습니다**. 각 페이지의 Markdown 원본에도 접근할 수 있습니다.
+
+### 프로젝트 {#v0.5-project}
+
+- Scrapling 로고, 표지 이미지, 웹사이트의 모습을 새롭게 바꿨습니다.
+- 브라우저 동작, 대화 상자, 추출, 스크린샷, JavaScript, 네트워크 기록, 상태 파일, Shadow DOM, 크롤러 수정 사항에 대한 테스트를 늘렸습니다.
+- 브라우저 테스트 마커를 추가하고 브라우저, 비동기, 병렬 테스트를 나누어 실행합니다. @diegobravtraps-oss의 [#457](https://github.com/D4Vinci/Scrapling/pull/457) 기여로 Windows에서 체크포인트와 CSV 테스트의 호환성을 개선했습니다.
+- 다국어 문서의 공통 빌드 설정과 기여 지침을 업데이트했습니다.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**올해 가장 큰 릴리스 중 하나입니다. MCP 서버를 새롭게 구성하고, 한 줄로 RAG용 Markdown을 만들 수 있게 했습니다. Cloudflare 검사 처리도 개선했으며, 자동화를 위해 브라우저 탭을 열린 상태로 유지합니다 🚀**
diff --git a/docs/locales/pt-BR/changelog.md b/docs/locales/pt-BR/changelog.md
index b828af1..1e4dab8 100644
--- a/docs/locales/pt-BR/changelog.md
+++ b/docs/locales/pt-BR/changelog.md
@@ -7,6 +7,89 @@ description: "Notas das versões do Scrapling, com novos recursos, correções e
Todas as mudanças importantes do Scrapling, extraídas das [versões no GitHub](https://github.com/D4Vinci/Scrapling/releases).
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**O Scrapling v0.5 melhora quase tudo: busca de páginas, análise, spiders, automação do navegador, ferramentas de IA e documentação em dez idiomas 🚀**
+
+!!! warning "Aviso"
+
+ **Esta versão traz muitas mudanças incompatíveis que não cabem aqui. Confira o [guia de migração para a v0.5](migrating-to-v0.5.md) antes de atualizar.**
+
+### 🚀 Novidades e melhorias de uso {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **Um servidor MCP muito mais capaz para agentes de IA que podem resolver quase qualquer CAPTCHA** (confira a [documentação](ai/mcp-server.md)):
+
+ - **Fluxos completos no navegador**: preencha formulários, clique, passe o cursor sobre elementos, role a página, use o teclado, trate diálogos e aguarde resultados em uma única sequência ordenada. Aceita diferentes tipos de campos e interações mais lentas, e as ações param no primeiro erro.
+ - **Leia e pesquise a página atual sem recarregá-la**: extraia HTML, Markdown ou texto de uma página inteira ou de um elemento. As capturas da estrutura da página permitem buscas e mostram as funções, os nomes e as posições dos elementos, com visualizações focadas que mantêm o contexto ao redor.
+ - **Execute JavaScript próprio e tire capturas de áreas específicas**: execute scripts, incluindo tarefas assíncronas, com acesso ao JavaScript da própria página. Capture elementos individuais, a área visível ou a página inteira em PNG ou JPEG.
+ - **Inspecione a atividade de rede e reutilize logins**: examine solicitações e respostas registradas, salve e restaure o estado de login do navegador e interaja com elementos dentro de Shadow DOM aberto ou fechado. Leia o tráfego registrado antes de fechar a sessão.
+ - **Use menos tokens e receba erros mais claros**: descrições mais curtas das ferramentas e orientações compartilhadas reduzem o texto repetido, enquanto as falhas do navegador e das solicitações chegam aos agentes com mensagens de erro úteis.
+
+- **Veja as solicitações por trás da página**. Ative `record_requests=True` para registrar o tráfego concluído durante carregamentos, ações e entre abas. Depois, inspecione as respostas salvas sem enviar as solicitações novamente. (Confira a [documentação](fetching/stealthy.md#network-history))
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - Filtre por URL, método, tipo de recurso ou status; obtenha uma resposta pelo ID. Inspecione cabeçalhos, dados enviados, respostas de APIs, erros HTTP e redirecionamentos pela API habitual de `Response`.
+ - Mantém os corpos de texto aceitos com limites de tamanho, além dos metadados e do motivo quando um corpo não pode ser salvo. O limite padrão é de 1.000 solicitações. Funciona com sessões síncronas e assíncronas; o histórico salvo em Python continua disponível para leitura após o fechamento.
+
+- **Salve um login uma vez e reutilize-o entre execuções**. `save_state(path)` e `load_state(path)` salvam e carregam cookies, armazenamento local e IndexedDB em JSON compatível com o Playwright. As sessões de navegador síncronas e assíncronas aceitam os dois métodos. (Confira a [documentação](fetching/stealthy.md#save-and-load-session-state))
+ - Carregue o estado antes de buscar ou recarregar uma página. Exige um contexto de navegador compartilhado já iniciado e sem `proxy_rotator`; abas, configurações do navegador e `sessionStorage` não são salvos.
+
+- **Extraia Shadow DOM aberto com `pierce_shadow=True`** e use CSS ou XPath como de costume. Disponível nos fetchers de navegador, nas sessões e na opção `--pierce-shadow` da CLI. Mantém o conteúdo dos slots sem mudar a página ativa. A captura de HTML exclui raízes fechadas e documentos de iframes. (Confira a [documentação](fetching/stealthy.md#shadow-dom))
+
+- **Escolha como seu spider explora um site**. `CrawlSpider` e suas subclasses, incluindo `ContentSpider`, aceitam `crawl_strategy="bfs"` para agendar primeiro as solicitações mais antigas ou `"dfs"` para agendar primeiro as mais recentes. A prioridade continua prevalecendo, e páginas processadas ao mesmo tempo podem terminar em outra ordem. (Confira a [documentação](spiders/generic-templates.md#crawl-order))
+
+### 🐛 Correções de erros {#v0.5-bug-fixes}
+
+- **Melhorada a resolução de Cloudflare** com detecção de widgets que aparecem com atraso, menos esperas desnecessárias e limites nos loops de novas tentativas para desafios passivos e frames ocultos. Corrige [#468](https://github.com/D4Vinci/Scrapling/issues/468) e [#509](https://github.com/D4Vinci/Scrapling/issues/509).
+- **Corrigida a inicialização do navegador a partir de um terminal do Windows com privilégios de administrador**. Corrige [#463](https://github.com/D4Vinci/Scrapling/issues/463).
+- **Mantidas as opções de ocultação integradas ao adicionar opções próprias do navegador**, por @alkaz-nodemaven em [#430](https://github.com/D4Vinci/Scrapling/pull/430).
+- **Melhorada a leitura da codificação de caracteres nas respostas do navegador**, incluindo declarações com diferenças entre maiúsculas e minúsculas, espaços ou valores entre aspas.
+- **A ausência de um desafio de Cloudflare não é mais registrada como erro** quando não há desafio a resolver. Corrige [#459](https://github.com/D4Vinci/Scrapling/issues/459).
+
+- **Corrigidas as impressões digitais das solicitações** para parâmetros de consulta, por @yetval em [#448](https://github.com/D4Vinci/Scrapling/pull/448), corpos JSON vazios ou com valores avaliados como falsos, por @ac1982 em [#480](https://github.com/D4Vinci/Scrapling/pull/480), e a ordem de inserção dos cabeçalhos, por @SarwadnyaMahajan em [#466](https://github.com/D4Vinci/Scrapling/pull/466).
+- **Corrigida a transferência indevida de dados da solicitação para links seguidos**, incluindo cabeçalhos antigos relacionados ao corpo, por @yetval em [#462](https://github.com/D4Vinci/Scrapling/pull/462).
+- **Impedido o armazenamento de respostas bloqueadas como entradas bem-sucedidas no cache de desenvolvimento**, por @Kuang-xianxin em [#446](https://github.com/D4Vinci/Scrapling/pull/446).
+- **Mantidos os arquivos de pontos de controle quando um rastreamento falha com uma exceção**, por @SulimanAbdulrazzaq em [#486](https://github.com/D4Vinci/Scrapling/pull/486).
+- **Corrigido o tratamento de falhas de robots.txt** para que consultas com falha não sejam armazenadas em cache como permissão para rastrear, por @prateekraawat1 em [#443](https://github.com/D4Vinci/Scrapling/pull/443).
+- **Corrigida a extração de links com seletores que limitam o escopo**, incluindo correspondências vazias e seletores que apontam para o próprio elemento do link, por @SulimanAbdulrazzaq em [#452](https://github.com/D4Vinci/Scrapling/pull/452) e [#483](https://github.com/D4Vinci/Scrapling/pull/483).
+- **Corrigido o encaminhamento para callbacks do sitemap**, por @SulimanAbdulrazzaq em [#458](https://github.com/D4Vinci/Scrapling/pull/458), **e a análise de XML com comentários ou instruções de processamento**, por @sup3dev em [#450](https://github.com/D4Vinci/Scrapling/pull/450).
+- **Tratadas as marcas de ordem de bytes no início de robots.txt e feeds CSV**, por @SulimanAbdulrazzaq em [#453](https://github.com/D4Vinci/Scrapling/pull/453).
+- **Corrigido o tratamento de `stealthy_headers` nas sessões HTTP dos spiders**, passando a opção para a sessão em vez de enviá-la diretamente ao `curl_cffi`, por @Yigtwxx em [#475](https://github.com/D4Vinci/Scrapling/pull/475).
+
+- **Corrigida a codificação de formulários a partir de dicionários com valores de lista ou tupla**, mantendo a precedência do corpo da solicitação e o tratamento existente de `None`, com contribuições de @SulimanAbdulrazzaq em [#485](https://github.com/D4Vinci/Scrapling/pull/485).
+- **Corrigida a combinação dos cabeçalhos HTTP da sessão e de cada solicitação sem distinguir maiúsculas de minúsculas**, por @SulimanAbdulrazzaq em [#487](https://github.com/D4Vinci/Scrapling/pull/487).
+- **Corrigidas as solicitações da CLI que descartavam sem aviso corpos JSON vazios ou com valores avaliados como falsos**, por @SulimanAbdulrazzaq em [#484](https://github.com/D4Vinci/Scrapling/pull/484).
+- **As exportações para arquivos Markdown e de texto agora usam sempre UTF-8**, e erros de conversão não truncam mais um arquivo de saída existente, por @SulimanAbdulrazzaq em [#488](https://github.com/D4Vinci/Scrapling/pull/488).
+- **Corrigido o tratamento das opções de agente de usuário e proxy do curl em `curl2fetcher()`**, por @SulimanAbdulrazzaq em [#490](https://github.com/D4Vinci/Scrapling/pull/490).
+
+- **Corrigidos os blocos Markdown que ficavam unidos sem separação** ao converter vários elementos selecionados por `Response.markdown()` ou pela extração da CLI, com contribuições de @Yigtwxx em [#432](https://github.com/D4Vinci/Scrapling/pull/432).
+- **Corrigida a limpeza de conteúdo oculto na saída para IA** para manter conteúdo visível como `opacity:0.95`, reconhecer mais estilos que ocultam conteúdo e remover slots ocultos, com contribuições de @Yigtwxx em [#460](https://github.com/D4Vinci/Scrapling/pull/460).
+- **Corrigida a remoção de tags de ruído que parava antes da hora ao encontrar tags aninhadas**, por @Yigtwxx em [#474](https://github.com/D4Vinci/Scrapling/pull/474).
+- **Corrigidos os seletores CSS e XPath gerados para o primeiro de vários elementos irmãos com a mesma tag**, por @yellow-dog-dog em [#495](https://github.com/D4Vinci/Scrapling/pull/495).
+- **Resolvido um aviso de descontinuação do analisador HTML do lxml**, por @afsuyadi em [#493](https://github.com/D4Vinci/Scrapling/pull/493).
+
+### Documentação {#v0.5-docs}
+
+- **O site inteiro agora está em dez idiomas**: inglês, árabe, espanhol, português do Brasil, francês, alemão, chinês simplificado, japonês, russo e coreano. Guias, referências de APIs, tutoriais e o [histórico de mudanças](changelog.md) estão traduzidos, com escrita da direita para a esquerda em árabe e trocas de idioma que mantêm a página e a seção.
+- **Guias, exemplos do README e etapas de configuração mais claros**, abrangendo dados de pontos de controle, codificações do navegador, estado salvo, histórico de rede, Shadow DOM e ordem de rastreamento.
+- **Atualizada a skill para agentes**, com seus exemplos, referências e arquivo para download, para as ferramentas atuais de navegador e MCP.
+- **O histórico de mudanças foi movido para o site**, com acesso ao código-fonte Markdown de cada página.
+
+### Projeto {#v0.5-project}
+
+- Renovados o logotipo do Scrapling, as imagens de capa e a apresentação do site.
+- Ampliados os testes de ações do navegador, diálogos, extração, capturas de tela, JavaScript, registro de rede, arquivos de estado, Shadow DOM e correções do rastreador.
+- Adicionado um marcador para testes de navegador e execuções separadas para testes de navegador, assíncronos e em paralelo. Melhorada a compatibilidade com Windows dos testes de pontos de controle e CSV, por @diegobravtraps-oss em [#457](https://github.com/D4Vinci/Scrapling/pull/457).
+- Atualizada a configuração compartilhada de compilação da documentação multilíngue e as orientações de contribuição.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**Uma das maiores versões deste ano: um servidor MCP reformulado, Markdown pronto para RAG em uma linha, um solucionador de Cloudflare melhorado e abas do navegador que continuam abertas para automação 🚀**
diff --git a/docs/locales/ru/changelog.md b/docs/locales/ru/changelog.md
index 127efa8..d1cfcb0 100644
--- a/docs/locales/ru/changelog.md
+++ b/docs/locales/ru/changelog.md
@@ -7,6 +7,89 @@ description: "Заметки о выпусках Scrapling: новые возм
Все заметные изменения в Scrapling из [выпусков на GitHub](https://github.com/D4Vinci/Scrapling/releases).
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5 улучшает почти всё: получение и разбор страниц, пауков, автоматизацию браузера, инструменты ИИ и документацию на десяти языках 🚀**
+
+!!! warning "Внимание"
+
+ **Этот выпуск вносит столько несовместимых изменений, что они не поместятся здесь. Перед обновлением прочитайте [руководство по переходу на v0.5](migrating-to-v0.5.md).**
+
+### 🚀 Новые возможности и улучшения удобства {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **Гораздо более мощный MCP-сервер для ИИ-агентов, который может решить почти любую CAPTCHA** (см. [документацию](ai/mcp-server.md)):
+
+ - **Полные сценарии работы в браузере**: заполняйте формы, нажимайте, наводите указатель, прокручивайте, используйте клавиатуру, работайте с диалогами и ждите результатов в одной упорядоченной последовательности. Поддерживаются разные типы полей и замедленные действия. Выполнение останавливается при первой ошибке.
+ - **Читайте и ищите на текущей странице без перезагрузки**: извлекайте HTML, Markdown или текст из всей страницы или одного элемента. Снимки страницы с поиском показывают роли, имена и позиции элементов. Представления выбранных частей сохраняют окружающий контекст.
+ - **Выполняйте свой JavaScript и делайте снимки нужных областей**: запускайте скрипты, включая асинхронные операции, с доступом к JavaScript самой страницы. Снимайте отдельные элементы, видимую область или всю страницу в PNG или JPEG.
+ - **Изучайте сетевую активность и повторно используйте вход в аккаунт**: проверяйте записанные запросы и ответы, сохраняйте и восстанавливайте состояние входа в браузере и взаимодействуйте с элементами в открытом или закрытом Shadow DOM. Прочитайте записанный трафик до закрытия сессии.
+ - **Используйте меньше токенов и получайте более понятные ошибки**: краткие описания инструментов и общие инструкции уменьшают повторы. Ошибки браузера и запросов передаются агентам с полезными сообщениями.
+
+- **Смотрите запросы, которые делает страница**. Включите `record_requests=True`, чтобы записывать завершённый трафик при загрузках, действиях и работе с разными вкладками. Затем изучайте сохранённые ответы без повторной отправки запросов. (См. [документацию](fetching/stealthy.md#network-history).)
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - Фильтруйте по URL, методу, типу ресурса или статусу. Получайте отдельный ответ по ID. Проверяйте заголовки, отправленные данные, ответы API, ошибки HTTP и перенаправления через привычный API `Response`.
+ - Сохраняются поддерживаемые текстовые тела ответов с ограничениями размера, а также метаданные и причина, если тело сохранить нельзя. По умолчанию лимит составляет 1 000 запросов. Работает с синхронными и асинхронными сессиями. Сохранённая история Python остаётся доступной для чтения после закрытия.
+
+- **Сохраните вход в аккаунт один раз и используйте его при следующих запусках**. `save_state(path)` и `load_state(path)` сохраняют cookie, локальное хранилище и IndexedDB в JSON, совместимом с Playwright. Поддерживаются как синхронные, так и асинхронные браузерные сессии. (См. [документацию](fetching/stealthy.md#save-and-load-session-state).)
+ - Загрузите состояние перед получением или перезагрузкой страницы. Нужен запущенный общий контекст браузера без `proxy_rotator`. Вкладки, настройки браузера и `sessionStorage` не сохраняются.
+
+- **Извлекайте открытый Shadow DOM с помощью `pierce_shadow=True`**, затем используйте CSS или XPath как обычно. Доступно в браузерных fetcher-классах, сессиях и через параметр CLI `--pierce-shadow`. Содержимое слотов сохраняется без изменения активной страницы. При получении HTML закрытые корни и документы iframe не включаются. (См. [документацию](fetching/stealthy.md#shadow-dom).)
+
+- **Выберите, как ваш паук обходит сайт**. `CrawlSpider` и его подклассы, включая `ContentSpider`, поддерживают `crawl_strategy="bfs"`, чтобы первыми назначать самые старые запросы, или `"dfs"`, чтобы первыми назначать самые новые. Приоритет по-прежнему имеет преимущество. Обработка параллельных страниц может завершаться в другом порядке. (См. [документацию](spiders/generic-templates.md#crawl-order).)
+
+### 🐛 Исправления ошибок {#v0.5-bug-fixes}
+
+- **Улучшено прохождение проверок Cloudflare**: обнаруживаются виджеты, которые появляются с задержкой, убраны лишние ожидания и ограничены циклы повторов для пассивных проверок и скрытых фреймов. Исправляет [#468](https://github.com/D4Vinci/Scrapling/issues/468) и [#509](https://github.com/D4Vinci/Scrapling/issues/509).
+- **Исправлен запуск браузера из оболочки Windows с правами администратора**. Исправляет [#463](https://github.com/D4Vinci/Scrapling/issues/463).
+- **Встроенные флаги скрытного режима сохраняются при добавлении своих флагов браузера**. Изменение от @alkaz-nodemaven в [#430](https://github.com/D4Vinci/Scrapling/pull/430).
+- **Улучшен разбор кодировки в ответах браузера**, включая объявления с другим регистром букв, пробелами или значениями в кавычках.
+- **Отсутствие проверки Cloudflare больше не записывается как ошибка**, если проходить проверку не требуется. Исправляет [#459](https://github.com/D4Vinci/Scrapling/issues/459).
+
+- **Исправлены отпечатки запросов** для параметров URL, изменение от @yetval в [#448](https://github.com/D4Vinci/Scrapling/pull/448), пустых или логически ложных тел JSON, изменение от @ac1982 в [#480](https://github.com/D4Vinci/Scrapling/pull/480), и порядка добавления заголовков, изменение от @SarwadnyaMahajan в [#466](https://github.com/D4Vinci/Scrapling/pull/466).
+- **Исправлен перенос данных запроса при переходе по ссылкам**, включая устаревшие заголовки, связанные с телом запроса. Изменение от @yetval в [#462](https://github.com/D4Vinci/Scrapling/pull/462).
+- **Заблокированные ответы больше не сохраняются в кеше разработки как успешные записи**. Изменение от @Kuang-xianxin в [#446](https://github.com/D4Vinci/Scrapling/pull/446).
+- **Файлы контрольных точек сохраняются, если обход завершается исключением**. Изменение от @SulimanAbdulrazzaq в [#486](https://github.com/D4Vinci/Scrapling/pull/486).
+- **Исправлена обработка ошибок robots.txt**: неудачные запросы больше не кешируются как разрешение на обход. Изменение от @prateekraawat1 в [#443](https://github.com/D4Vinci/Scrapling/pull/443).
+- **Исправлено извлечение ссылок с ограничивающими селекторами**, включая отсутствие совпадений и селекторы, которые выбирают сам элемент ссылки. Изменение от @SulimanAbdulrazzaq в [#452](https://github.com/D4Vinci/Scrapling/pull/452) и [#483](https://github.com/D4Vinci/Scrapling/pull/483).
+- **Исправлен выбор callback-функций для sitemap**, изменение от @SulimanAbdulrazzaq в [#458](https://github.com/D4Vinci/Scrapling/pull/458), **а также разбор XML с комментариями или инструкциями обработки**, изменение от @sup3dev в [#450](https://github.com/D4Vinci/Scrapling/pull/450).
+- **Добавлена обработка меток порядка байтов в начале robots.txt и CSV-фидов**. Изменение от @SulimanAbdulrazzaq в [#453](https://github.com/D4Vinci/Scrapling/pull/453).
+- **Исправлена обработка `stealthy_headers` в HTTP-сессиях пауков**: параметр передаётся сессии, а не напрямую в `curl_cffi`. Изменение от @Yigtwxx в [#475](https://github.com/D4Vinci/Scrapling/pull/475).
+
+- **Исправлено кодирование данных формы из словаря для значений в виде списков и кортежей**, с сохранением приоритета тела запроса и прежней обработки `None`. Включены изменения от @SulimanAbdulrazzaq в [#485](https://github.com/D4Vinci/Scrapling/pull/485).
+- **Исправлено объединение HTTP-заголовков сессии и отдельного запроса без учёта регистра**. Изменение от @SulimanAbdulrazzaq в [#487](https://github.com/D4Vinci/Scrapling/pull/487).
+- **Исправлено незаметное удаление пустых или логически ложных тел JSON в запросах CLI**. Изменение от @SulimanAbdulrazzaq в [#484](https://github.com/D4Vinci/Scrapling/pull/484).
+- **Экспорт файлов Markdown и текста теперь всегда использует UTF-8**. Ошибки преобразования больше не обрезают существующий выходной файл. Изменение от @SulimanAbdulrazzaq в [#488](https://github.com/D4Vinci/Scrapling/pull/488).
+- **Исправлена обработка параметров user-agent и proxy команды curl в `curl2fetcher()`**. Изменение от @SulimanAbdulrazzaq в [#490](https://github.com/D4Vinci/Scrapling/pull/490).
+
+- **Исправлено слияние блоков Markdown**, когда несколько выбранных элементов преобразуются через `Response.markdown()` или извлечение в CLI. Включены изменения от @Yigtwxx в [#432](https://github.com/D4Vinci/Scrapling/pull/432).
+- **Исправлена очистка скрытого содержимого для вывода ИИ**: видимое содержимое, например `opacity:0.95`, сохраняется, распознаётся больше скрывающих стилей, а скрытые слоты удаляются. Включены изменения от @Yigtwxx в [#460](https://github.com/D4Vinci/Scrapling/pull/460).
+- **Исправлена преждевременная остановка удаления лишних тегов при вложенности**. Изменение от @Yigtwxx в [#474](https://github.com/D4Vinci/Scrapling/pull/474).
+- **Исправлены создаваемые CSS- и XPath-селекторы для первого из нескольких элементов одного родителя с одинаковым тегом**. Изменение от @yellow-dog-dog в [#495](https://github.com/D4Vinci/Scrapling/pull/495).
+- **Устранено предупреждение об устаревании в HTML-парсере lxml**. Изменение от @afsuyadi в [#493](https://github.com/D4Vinci/Scrapling/pull/493).
+
+### Документация {#v0.5-docs}
+
+- **Весь сайт теперь доступен на десяти языках**: английском, арабском, испанском, бразильском португальском, французском, немецком, упрощённом китайском, японском, русском и корейском. Переведены руководства, справочники API, учебные материалы и [история изменений](changelog.md). Для арабского поддерживается направление справа налево, а при смене языка сохраняются страница и раздел.
+- **Более понятные руководства, примеры README и шаги настройки**, которые охватывают данные контрольных точек, кодировки браузера, сохранённое состояние, историю сети, Shadow DOM и порядок обхода.
+- **Обновлён Agent Skill**, его примеры, справочные материалы и архив для загрузки с учётом текущих инструментов браузера и MCP.
+- **История изменений перенесена на сайт**, и добавлен доступ к исходному Markdown каждой страницы.
+
+### Проект {#v0.5-project}
+
+- Обновлены логотип Scrapling, изображения обложек и оформление сайта.
+- Расширены тесты действий браузера, диалогов, извлечения, снимков экрана, JavaScript, записи сети, файлов состояния, Shadow DOM и исправлений обхода.
+- Добавлен маркер браузерных тестов и отдельные запуски для браузерных, асинхронных и параллельных тестов. Улучшена совместимость тестов контрольных точек и CSV с Windows. Изменение от @diegobravtraps-oss в [#457](https://github.com/D4Vinci/Scrapling/pull/457).
+- Обновлены общие настройки сборки многоязычной документации и правила участия в проекте.
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**Один из крупнейших выпусков в этом году: переработанный MCP-сервер, Markdown для RAG одной строкой, улучшенное прохождение проверок Cloudflare и вкладки браузера, которые остаются открытыми для автоматизации 🚀**
diff --git a/docs/locales/zh/changelog.md b/docs/locales/zh/changelog.md
index 6f7e950..86390a1 100644
--- a/docs/locales/zh/changelog.md
+++ b/docs/locales/zh/changelog.md
@@ -7,6 +7,89 @@ description: "Scrapling 各版本的发布说明,包括新功能、问题修
Scrapling 的所有重要变更,整理自 [GitHub 发布记录](https://github.com/D4Vinci/Scrapling/releases)。
+## [v0.5](https://github.com/D4Vinci/Scrapling/releases/tag/v0.5) - 2026-10-17 {#v0.5}
+
+**Scrapling v0.5 几乎全面升级:页面获取、解析、Spider、浏览器自动化、AI 工具,以及十种语言的文档 🚀**
+
+!!! warning "警告"
+
+ **此版本包含大量不兼容变更,无法在此全部列出。更新前请查看[迁移到 v0.5 指南](migrating-to-v0.5.md)。**
+
+### 🚀 新功能与使用体验改进 {#v0.5-new-stuff-and-quality-of-life-changes}
+
+- **面向 AI 智能体的 MCP 服务器功能大幅增强,能够处理几乎所有 CAPTCHA 验证码**(参见[文档](ai/mcp-server.md)):
+
+ - **完整的浏览器操作流程**:按顺序填表、点击、悬停、滚动、使用键盘、处理对话框并等待结果。支持多种字段类型和放慢操作速度,遇到第一个错误时停止执行。
+ - **无需重新加载,即可读取和搜索当前页面**:从整个页面或单个元素中提取 HTML、Markdown 或文本。可搜索的页面快照会显示元素的角色、名称和位置,聚焦查看时仍保留周围的上下文。
+ - **运行自定义 JavaScript 并截取指定区域**:执行脚本,包括异步操作,并可访问页面自身的 JavaScript。可以将单个元素、视口或整个页面保存为 PNG 或 JPEG 截图。
+ - **检查网络活动并复用登录状态**:查看记录的请求和响应,保存和恢复浏览器登录状态,并与开放或封闭 Shadow DOM 内的元素交互。请在关闭会话前读取记录的网络流量。
+ - **减少 token 消耗,让错误更清晰**:更简洁的工具描述和共享说明减少了重复文本,浏览器及请求失败时也会向智能体提供有用的错误信息。
+
+- **查看页面背后的请求**。启用 `record_requests=True`,记录页面加载、操作和标签页中已完成的网络流量,然后直接查看保存的响应,无需再次发送请求。(参见[文档](fetching/stealthy.md#network-history))
+
+ ```python
+ from scrapling.fetchers import StealthySession
+
+ with StealthySession(record_requests=True) as session:
+ session.fetch("https://example.com", network_idle=True)
+ for response in session.network.search(url_pattern=r"/api/", limit=None):
+ print(response.url, response.status, response.body)
+ ```
+
+ - 按 URL、方法、资源类型或状态筛选,也可通过 ID 获取单个响应。通过常用的 `Response` API 查看请求头和响应头、发送的数据、API 响应、HTTP 错误和重定向。
+ - 在大小限制内保留支持的文本正文,并保存元数据;无法保存正文时会记录原因。默认上限为 1,000 个请求。支持同步和异步会话,保存的 Python 历史记录在会话关闭后仍可读取。
+
+- **登录状态只需保存一次,即可在多次运行中复用**。`save_state(path)` 和 `load_state(path)` 以兼容 Playwright 的 JSON 格式保存 Cookie、本地存储和 IndexedDB。同步和异步浏览器会话均支持这两个方法。(参见[文档](fetching/stealthy.md#save-and-load-session-state))
+ - 获取或重新加载页面前先加载状态。需要已启动的共享浏览器上下文,且不能使用 `proxy_rotator`;标签页、浏览器设置和 `sessionStorage` 不会保存。
+
+- **使用 `pierce_shadow=True` 提取开放的 Shadow DOM**,然后照常使用 CSS 或 XPath。浏览器获取器、会话以及 CLI 的 `--pierce-shadow` 选项均支持此功能。保留插槽内容,同时不修改实时页面。捕获的 HTML 不包含封闭的 Shadow 根和 iframe 文档。(参见[文档](fetching/stealthy.md#shadow-dom))
+
+- **选择 Spider 探索网站的顺序**。`CrawlSpider` 及其子类(包括 `ContentSpider`)支持 `crawl_strategy="bfs"`,优先调度最早加入的请求;也可使用 `"dfs"`,优先调度最新加入的请求。优先级仍然优先,并发页面的完成顺序可能不同。(参见[文档](spiders/generic-templates.md#crawl-order))
+
+### 🐛 问题修复 {#v0.5-bug-fixes}
+
+- **改进 Cloudflare 挑战处理**,检测延迟出现的验证组件,减少不必要的等待,并限制被动挑战和隐藏框架的重试循环。修复 [#468](https://github.com/D4Vinci/Scrapling/issues/468) 和 [#509](https://github.com/D4Vinci/Scrapling/issues/509)。
+- **修复从以管理员权限运行的 Windows shell 启动浏览器的问题**。修复 [#463](https://github.com/D4Vinci/Scrapling/issues/463)。
+- **添加自定义浏览器参数时保留内置的隐身参数**,由 @alkaz-nodemaven 在 [#430](https://github.com/D4Vinci/Scrapling/pull/430) 中贡献。
+- **改进浏览器响应的字符集解析**,支持大小写不同、包含空格或带引号的声明值。
+- **无需处理 Cloudflare 挑战时,不再将未检测到挑战记录为错误**。修复 [#459](https://github.com/D4Vinci/Scrapling/issues/459)。
+
+- **修正请求指纹**:查询参数由 @yetval 在 [#448](https://github.com/D4Vinci/Scrapling/pull/448) 中修复,空值或假值 JSON 正文由 @ac1982 在 [#480](https://github.com/D4Vinci/Scrapling/pull/480) 中修复,请求头插入顺序由 @SarwadnyaMahajan 在 [#466](https://github.com/D4Vinci/Scrapling/pull/466) 中修复。
+- **修复请求数据被带入后续链接请求的问题**,包括残留的正文相关请求头,由 @yetval 在 [#462](https://github.com/D4Vinci/Scrapling/pull/462) 中贡献。
+- **防止被拦截的响应作为成功响应存入开发缓存**,由 @Kuang-xianxin 在 [#446](https://github.com/D4Vinci/Scrapling/pull/446) 中贡献。
+- **抓取因异常失败时保留检查点文件**,由 @SulimanAbdulrazzaq 在 [#486](https://github.com/D4Vinci/Scrapling/pull/486) 中贡献。
+- **修正 robots.txt 获取失败的处理方式**,不再将获取失败缓存为允许抓取,由 @prateekraawat1 在 [#443](https://github.com/D4Vinci/Scrapling/pull/443) 中贡献。
+- **修复使用范围限制选择器提取链接的问题**,包括没有匹配项,以及选择器直接指向链接元素本身的情况,由 @SulimanAbdulrazzaq 在 [#452](https://github.com/D4Vinci/Scrapling/pull/452) 和 [#483](https://github.com/D4Vinci/Scrapling/pull/483) 中贡献。
+- **修复 sitemap 的回调路由**,由 @SulimanAbdulrazzaq 在 [#458](https://github.com/D4Vinci/Scrapling/pull/458) 中贡献;**修复包含注释或处理指令时的 XML 解析问题**,由 @sup3dev 在 [#450](https://github.com/D4Vinci/Scrapling/pull/450) 中贡献。
+- **处理 robots.txt 和 CSV Feed 开头的字节顺序标记**,由 @SulimanAbdulrazzaq 在 [#453](https://github.com/D4Vinci/Scrapling/pull/453) 中贡献。
+- **修复 Spider HTTP 会话对 `stealthy_headers` 的处理**,将该选项传给会话,而不是直接传给 `curl_cffi`,由 @Yigtwxx 在 [#475](https://github.com/D4Vinci/Scrapling/pull/475) 中贡献。
+
+- **修复字典表单中列表和元组值的编码**,同时保留请求正文的优先顺序和现有的 `None` 处理方式,包含 @SulimanAbdulrazzaq 在 [#485](https://github.com/D4Vinci/Scrapling/pull/485) 中的贡献。
+- **修复会话与单次请求的 HTTP 请求头合并,正确忽略大小写**,由 @SulimanAbdulrazzaq 在 [#487](https://github.com/D4Vinci/Scrapling/pull/487) 中贡献。
+- **修复 CLI 请求无提示地丢弃空值或假值 JSON 正文的问题**,由 @SulimanAbdulrazzaq 在 [#484](https://github.com/D4Vinci/Scrapling/pull/484) 中贡献。
+- **让 Markdown 和文本文件导出统一使用 UTF-8**,并防止转换错误截断已有的输出文件,由 @SulimanAbdulrazzaq 在 [#488](https://github.com/D4Vinci/Scrapling/pull/488) 中贡献。
+- **修复 `curl2fetcher()` 对 curl 的 User-Agent 和代理选项的处理**,由 @SulimanAbdulrazzaq 在 [#490](https://github.com/D4Vinci/Scrapling/pull/490) 中贡献。
+
+- **修复 Markdown 块连在一起的问题**,该问题发生在通过 `Response.markdown()` 或 CLI 提取转换多个选中元素时,包含 @Yigtwxx 在 [#432](https://github.com/D4Vinci/Scrapling/pull/432) 中的贡献。
+- **修复 AI 输出的隐藏内容清理**,保留 `opacity:0.95` 这类可见内容,识别更多隐藏样式并移除隐藏插槽,包含 @Yigtwxx 在 [#460](https://github.com/D4Vinci/Scrapling/pull/460) 中的贡献。
+- **修复在嵌套标签附近过早停止移除噪声标签的问题**,由 @Yigtwxx 在 [#474](https://github.com/D4Vinci/Scrapling/pull/474) 中贡献。
+- **修复为多个同标签兄弟元素中的第一个元素生成 CSS 和 XPath 选择器的问题**,由 @yellow-dog-dog 在 [#495](https://github.com/D4Vinci/Scrapling/pull/495) 中贡献。
+- **解决 lxml HTML 解析器的弃用警告**,由 @afsuyadi 在 [#493](https://github.com/D4Vinci/Scrapling/pull/493) 中贡献。
+
+### 文档 {#v0.5-docs}
+
+- **整个网站现已支持十种语言**:英语、阿拉伯语、西班牙语、巴西葡萄牙语、法语、德语、简体中文、日语、俄语和韩语。指南、API 参考、教程和[更新日志](changelog.md)均已翻译,支持阿拉伯语从右到左的布局,切换语言时会保留当前页面和章节。
+- **改进指南、README 示例和设置步骤**,涵盖检查点数据、浏览器编码、保存的状态、网络历史记录、Shadow DOM 和抓取顺序。
+- **更新 Agent Skill** 及其示例、参考资料和可下载的压缩包,使其与当前的浏览器和 MCP 工具保持一致。
+- **将更新日志移至网站**,并提供每个页面的 Markdown 源文件入口。
+
+### 项目 {#v0.5-project}
+
+- 更新 Scrapling 的徽标、封面图片和网站外观。
+- 扩展测试,覆盖浏览器操作、对话框、内容提取、截图、JavaScript、网络记录、状态文件、Shadow DOM 和爬虫修复。
+- 添加浏览器测试标记,将浏览器、异步和并行测试分别运行。@diegobravtraps-oss 在 [#457](https://github.com/D4Vinci/Scrapling/pull/457) 中改进了 Windows 上检查点和 CSV 测试的兼容性。
+- 更新共享的多语言文档构建配置和贡献指南。
+
## [v0.4.15](https://github.com/D4Vinci/Scrapling/releases/tag/v0.4.15) - 2026-08-23 {#v0.4.15}
**今年规模最大的版本之一:重构 MCP 服务器,一行代码生成可用于 RAG 的 Markdown,改进 Cloudflare 挑战处理,并让浏览器标签页保持打开以便继续自动化操作 🚀**