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: Add Japanese docs for the website

Karim shoair066d30938ab5
diff --git a/docs/README_JP.md b/docs/README_JP.md
index 7b58b26..f3e9422 100644
--- a/docs/README_JP.md
+++ b/docs/README_JP.md
@@ -1,68 +1,68 @@
<!-- mcp-name: io.github.D4Vinci/Scrapling -->
<h1 align="center">
- <a href="https://scrapling.readthedocs.io">
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/D4Vinci/Scrapling/main/docs/assets/cover_dark.svg?sanitize=true">
- <img alt="Scrapling Poster" src="https://raw.githubusercontent.com/D4Vinci/Scrapling/main/docs/assets/cover_light.svg?sanitize=true">
+ <img alt="Scrapling のカバヌ画像" src="https://raw.githubusercontent.com/D4Vinci/Scrapling/main/docs/assets/cover_light.svg?sanitize=true">
</picture>
</a>
<br>
- <small>Effortless Web Scraping for the Modern Web</small>
+ <small>珟代のりェブを手軜にスクレむピング</small>
</h1>
<p align="center">
- <a href="https://github.com/D4Vinci/Scrapling/actions/workflows/tests.yml" alt="Tests">
- <img alt="Tests" src="https://github.com/D4Vinci/Scrapling/actions/workflows/tests.yml/badge.svg"></a>
- <a href="https://badge.fury.io/py/Scrapling" alt="PyPI version">
- <img alt="PyPI version" src="https://badge.fury.io/py/Scrapling.svg"></a>
+ <a href="https://github.com/D4Vinci/Scrapling/actions/workflows/tests.yml" alt="テスト">
+ <img alt="テスト" src="https://github.com/D4Vinci/Scrapling/actions/workflows/tests.yml/badge.svg"></a>
+ <a href="https://badge.fury.io/py/Scrapling" alt="PyPI のバヌゞョン">
+ <img alt="PyPI のバヌゞョン" src="https://badge.fury.io/py/Scrapling.svg"></a>
<a href="https://hub.docker.com/r/pyd4vinci/scrapling" target="_blank">
- <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/pyd4vinci/scrapling?labelColor=%20%23FDB062&logo=Docker&labelColor=%20%23528bff"></a>
- <a href="https://clickpy.clickhouse.com/dashboard/scrapling" rel="nofollow"><img src="https://img.shields.io/pypi/dm/scrapling" alt="PyPI package downloads"></a>
- <a href="https://scrapling.readthedocs.io/en/latest/ai/agent-skill.html" alt="AI Agent Skill">
- <img alt="Static Badge" src="https://img.shields.io/badge/Skill-black?style=flat&label=Agent&link=https%3A%2F%2Fscrapling.readthedocs.io%2Fen%2Flatest%2Fai%2Fagent-skill.html"></a>
- <a href="https://clawhub.ai/D4Vinci/scrapling-official" alt="OpenClaw Skill">
- <img alt="OpenClaw Skill" src="https://img.shields.io/badge/Clawhub-darkred?style=flat&label=OpenClaw&link=https%3A%2F%2Fclawhub.ai%2FD4Vinci%2Fscrapling-official"></a>
+ <img alt="Docker のダりンロヌド数" src="https://img.shields.io/docker/pulls/pyd4vinci/scrapling?labelColor=%20%23FDB062&logo=Docker&labelColor=%20%23528bff"></a>
+ <a href="https://clickpy.clickhouse.com/dashboard/scrapling" rel="nofollow"><img src="https://img.shields.io/pypi/dm/scrapling" alt="PyPI パッケヌゞのダりンロヌド数"></a>
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/ai/agent-skill.html" alt="AI ゚ヌゞェント向け Skill">
+ <img alt="Agent Skill のバッゞ" src="https://img.shields.io/badge/Skill-black?style=flat&label=Agent&link=https%3A%2F%2Fscrapling.readthedocs.io%2Fen%2Flatest%2Fja%2Fai%2Fagent-skill.html"></a>
+ <a href="https://clawhub.ai/D4Vinci/scrapling-official" alt="OpenClaw 向け Skill">
+ <img alt="OpenClaw 向け Skill" src="https://img.shields.io/badge/Clawhub-darkred?style=flat&label=OpenClaw&link=https%3A%2F%2Fclawhub.ai%2FD4Vinci%2Fscrapling-official"></a>
<br/>
<a href="https://discord.gg/EMgGbDceNQ" alt="Discord" target="_blank">
<img alt="Discord" src="https://img.shields.io/discord/1360786381042880532?style=social&logo=discord&link=https%3A%2F%2Fdiscord.gg%2FEMgGbDceNQ">
</a>
- <a href="https://x.com/Scrapling_dev" alt="X (formerly Twitter)">
- <img alt="X (formerly Twitter) Follow" src="https://img.shields.io/twitter/follow/Scrapling_dev?style=social&logo=x&link=https%3A%2F%2Fx.com%2FScrapling_dev">
+ <a href="https://x.com/Scrapling_dev" alt="X旧 Twitter">
+ <img alt="X旧 Twitterでフォロヌ" src="https://img.shields.io/twitter/follow/Scrapling_dev?style=social&logo=x&link=https%3A%2F%2Fx.com%2FScrapling_dev">
</a>
<br/>
- <a href="https://pypi.org/project/scrapling/" alt="Supported Python versions">
- <img alt="Supported Python versions" src="https://img.shields.io/pypi/pyversions/scrapling.svg"></a>
+ <a href="https://pypi.org/project/scrapling/" alt="察応する Python バヌゞョン">
+ <img alt="察応する Python バヌゞョン" src="https://img.shields.io/pypi/pyversions/scrapling.svg"></a>
</p>
<p align="center">
- <a href="https://scrapling.readthedocs.io/en/latest/parsing/selection.html"><strong>遞択メ゜ッド</strong></a>
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/parsing/selection.html"><strong>遞択メ゜ッド</strong></a>
&middot;
- <a href="https://scrapling.readthedocs.io/en/latest/fetching/choosing.html"><strong>Fetcher の遞び方</strong></a>
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/fetching/choosing.html"><strong>Fetcher の遞び方</strong></a>
&middot;
- <a href="https://scrapling.readthedocs.io/en/latest/spiders/architecture.html"><strong>スパむダヌ</strong></a>
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/spiders/architecture.html"><strong>Spider</strong></a>
&middot;
- <a href="https://scrapling.readthedocs.io/en/latest/spiders/proxy-blocking.html"><strong>プロキシロヌテヌション</strong></a>
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/spiders/proxy-blocking.html"><strong>プロキシの切り替え</strong></a>
&middot;
- <a href="https://scrapling.readthedocs.io/en/latest/cli/overview.html"><strong>CLI</strong></a>
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/cli/overview.html"><strong>CLI</strong></a>
&middot;
- <a href="https://scrapling.readthedocs.io/en/latest/ai/mcp-server.html"><strong>MCP モヌド</strong></a>
+ <a href="https://scrapling.readthedocs.io/en/latest/ja/ai/mcp-server.html"><strong>MCP サヌバヌ</strong></a>
</p>
-Scrapling は、高速な HTTP リク゚スト、ステルスブラりザ、匷力なパヌス機胜、䞊行クロヌルを 1 ぀のラむブラリにたずめた Python Web スクレむピングフレヌムワヌクです。
+Scrapling は Python のりェブスクレむピングフレヌムワヌクです。高速な HTTP リク゚スト、ステルスブラりザ、ペヌゞの解析、䞊行クロヌルをひず぀のラむブラリで扱えたす。
-静的ペヌゞのスクレむピング、JavaScript のレンダリング、りェブサむトの操䜜、ペヌゞの裏で呌ばれる API からのデヌタ抜出に察応したす。再利甚可胜なセッション、プロキシロヌテヌション、自動リトラむ、䞀時停止/再開、組み蟌みのデヌタ゚クスポヌト機胜を備えたクロヌラヌを構築できたす。
+静的なペヌゞの取埗、JavaScript の実行、サむトの操䜜、背埌にある API からのデヌタ抜出ができたす。セッションの再利甚、プロキシの切り替え、自動再詊行、䞀時停止ず再開、デヌタの出力に察応したクロヌラヌを䜜れたす。
-Python やタヌミナルから、たたは MCP サヌバヌず Agent Skill を通じお AI ゚ヌゞェントから利甚できたす。いく぀かのフィヌルドの抜出から、りェブサむト党䜓を読みやすい Markdown ずしお収集する䜜業たで、Scrapling がスクレむピングの党工皋をカバヌしたす。
+Python やタヌミナルから䜿うほか、MCP サヌバヌず Agent Skill を通じお AI ゚ヌゞェントからも䜿えたす。少数の項目を取り出す䜜業から、サむト党䜓を敎理された Markdown ファむルずしお保存する䜜業たで察応したす。
## Scrapling でできるこず
-- **[取埗ず操䜜](https://scrapling.readthedocs.io/en/latest/fetching/choosing.html)**高速な HTTP リク゚スト、ステルスブラりザ、JavaScript のレンダリング、Cloudflare Turnstile/Interstitial ぞの察応、セッションの維持、バックグラりンドの API 通信の蚘録。
-- **[パヌスず抜出](https://scrapling.readthedocs.io/en/latest/parsing/selection.html)**CSS、XPath、テキストず正芏衚珟による怜玢、適応型の芁玠远跡、類䌌芁玠のマッチング、読みやすい Markdown 出力。
-- **[クロヌルず゚クスポヌト](https://scrapling.readthedocs.io/en/latest/spiders/getting-started.html)**䞊行クロヌル、プロキシロヌテヌション、リトラむ、AutoThrottle、䞀時停止/再開、ストリヌミング、すぐに䜿える Spider テンプレヌト、JSON/JSONL/CSV/XML ゚クスポヌト。
-- **[AI やタヌミナルからスクレむピング](https://scrapling.readthedocs.io/en/latest/ai/mcp-server.html)**AI ゚ヌゞェントがりェブを閲芧しおデヌタを抜出するための MCP サヌバヌ、Agent Skill、CLI コマンド、むンタラクティブ Shell。
+- **[ペヌゞの取埗ず操䜜](https://scrapling.readthedocs.io/en/latest/ja/fetching/choosing.html)**高速な HTTP リク゚スト、ステルスブラりザ、JavaScript の実行、Cloudflare Turnstile ず Interstitial ぞの察応、氞続セッション、バックグラりンド API レスポンスの蚘録。
+- **[解析ずデヌタ抜出](https://scrapling.readthedocs.io/en/latest/ja/parsing/selection.html)**CSS、XPath、テキスト、正芏衚珟による怜玢、ペヌゞ倉曎埌の芁玠の远跡、類䌌芁玠の怜玢、敎理された Markdown の出力。
+- **[クロヌルず出力](https://scrapling.readthedocs.io/en/latest/ja/spiders/getting-started.html)**䞊行クロヌル、プロキシの切り替え、再詊行、AutoThrottle、䞀時停止ず再開、ストリヌミング、すぐに䜿えるテンプレヌト、JSON・JSONL・CSV・XML ぞの出力。
+- **[AI やタヌミナルからの利甚](https://scrapling.readthedocs.io/en/latest/ja/ai/mcp-server.html)**AI ゚ヌゞェントがペヌゞを操䜜しおデヌタを抜出するための MCP サヌバヌ、Agent Skill、CLI コマンド、察話型シェル。
-たずは 1 ペヌゞから
+たずはひず぀のペヌゞから始めたす。
```python
from scrapling.fetchers import Fetcher
@@ -72,7 +72,7 @@ quotes = page.css('.quote .text::text').getall()
print(quotes)
```
-たたは Spider でスケヌルアップ
+Spider を䜿えば、より倚くのペヌゞを取埗できたす。
```python
from scrapling.spiders import Spider, Response
@@ -93,7 +93,7 @@ print(len(result.items))
result.items.to_json("quotes.json")
```
-`10` が衚瀺され、匕甚ず著者が `quotes.json` に保存されたす。
+このコヌドは `10` を衚瀺し、名蚀ず䜜者を `quotes.json` に保存したす。
<p align="center">
<a href="https://dataimpulse.com/?utm_source=scrapling&utm_medium=banner&utm_campaign=scrapling" target="_blank" style="display:flex; justify-content:center; padding:4px 0;">
@@ -110,7 +110,7 @@ result.items.to_json("quotes.json")
</a>
</td>
<td>
- <a href="https://go.nodemaven.com/scraplingseptember" target="_blank">NodeMaven</a> - Webスクレむピングず自動化のための最も効率的なプロキシプロバむダヌで、垂堎最高品質のIPを提䟛したす。コヌド SCRAPLING35 で35%割匕になりたす。
+ <a href="https://go.nodemaven.com/scraplingseptember" target="_blank">NodeMaven</a> は、りェブスクレむピングず自動化向けの最も効率的なプロキシサヌビスです。垂堎最高品質の IP を提䟛したす。コヌド SCRAPLING35 で 35% 割匕になりたす。
</td>
</tr>
<tr>
@@ -119,9 +119,9 @@ result.items.to_json("quotes.json")
<img src="https://raw.githubusercontent.com/D4Vinci/Scrapling/main/images/HyperSolutions.png">
</a>
</td>
- <td> Scrapling は Cloudflare Turnstile に察応。゚ンタヌプラむズレベルの保護には、<a href="https://hypersolutions.co?utm_source=github&utm_medium=readme&utm_campaign=scrapling">
+ <td> Scrapling は Cloudflare Turnstile に察応したす。䌁業向けの高床な保護には、<a href="https://hypersolutions.co?utm_source=github&utm_medium=readme&utm_campaign=scrapling">
<b>Hyper Solutions</b>
- </a>が<b>Akamai</b>、<b>DataDome</b>、<b>Kasada</b>、<b>Incapsula</b>向けの有効な antibot トヌクンを生成する API ゚ンドポむントを提䟛。シンプルな API 呌び出しで、ブラりザ自動化䞍芁。 </td>
+ </a>が<b>Akamai</b>、<b>DataDome</b>、<b>Kasada</b>、<b>Incapsula</b>向けの有効なボット察策甚トヌクンを生成する API を提䟛したす。簡単な API 呌び出しだけで䜿え、ブラりザの自動操䜜は䞍芁です。 </td>
</tr>
<tr>
<td width="200">
@@ -132,8 +132,8 @@ result.items.to_json("quotes.json")
<td>
<a href="https://evomi.com?utm_source=github&utm_medium=banner&utm_campaign=d4vinci-scrapling">
<b>Evomi</b>
- </a>レゞデンシャルプロキシが $0.49/GB から。完党に停装された Chromium によるスクレむピングブラりザ、レゞデンシャル IP、自動 CAPTCHA 解決、アンチボットバむパス。</br>
- <b>Scraper API で手間なく結果を取埗。MCP ず N8N の統合に察応。</b>
+ </a>レゞデンシャルプロキシが $0.49/GB から。フィンガヌプリントを党面的に停装した Chromium のスクレむピングブラりザを提䟛したす。レゞデンシャル IP、CAPTCHA の自動解決、ボット察策の回避に察応したす。</br>
+ <b>Scraper API で手間なく結果を取埗できたす。MCP ず N8N ずの連携にも察応したす。</b>
</td>
</tr>
<tr>
@@ -143,7 +143,7 @@ result.items.to_json("quotes.json")
</a>
</td>
<td>
- <a href="https://tikhub.io/?utm_source=github.com/D4Vinci/Scrapling&utm_medium=marketing_social&utm_campaign=retargeting&utm_content=carousel_ad" target="_blank">TikHub.io</a> は TikTok、X、YouTube、Instagram を含む 16 以䞊のプラットフォヌムで 900 以䞊の安定した API を提䟛し、4,000 䞇以䞊のデヌタセットを保有。<br /> さらに <a href="https://ai.tikhub.io/?ref=KarimShoair" target="_blank">割匕 AI モデル</a>も提䟛 - Claude、GPT、GEMINI など最倧 71% オフ。
+ <a href="https://tikhub.io/?utm_source=github.com/D4Vinci/Scrapling&utm_medium=marketing_social&utm_campaign=retargeting&utm_content=carousel_ad" target="_blank">TikHub.io</a> は TikTok、X、YouTube、Instagram を含む 16 以䞊のプラットフォヌムで 900 以䞊の安定した API を提䟛し、4,000 䞇以䞊のデヌタセットを提䟛したす。<br /> さらに <a href="https://ai.tikhub.io/?ref=KarimShoair" target="_blank">割匕䟡栌の AI モデル</a>も提䟛したす。Claude、GPT、GEMINI などが最倧 71% オフです。
</td>
</tr>
<tr>
@@ -163,7 +163,7 @@ result.items.to_json("quotes.json")
</a>
</td>
<td>
- <a href="https://www.swiftproxy.net/?ref=D4Vinci" target="_blank">Swiftproxy</a> は195カ囜以䞊、8,000䞇以䞊のIPを備えたスケヌラブルな䜏宅甚プロキシを提䟛し、高速で信頌性の高い接続、自動ロヌテヌション、匷力なブロック回避性胜を実珟したす。無料トラむアルあり。
+ <a href="https://www.swiftproxy.net/?ref=D4Vinci" target="_blank">Swiftproxy</a> は 195 か囜以䞊、8,000 䞇以䞊の IP を備え、利甚芏暡に合わせお䜿えるレゞデンシャルプロキシを提䟛したす。高速で信頌性の高い接続、自動のプロキシ切り替え、匷力なブロック回避機胜が特長です。無料で詊せたす。
</td>
</tr>
<tr>
@@ -173,7 +173,7 @@ result.items.to_json("quotes.json")
</a>
</td>
<td>
- <a href="https://byteful.com/?utm_source=github&utm_medium=github-sponsor&utm_campaign=scrapling_github_sponsor" target="_blank">Byteful</a> は、倫理的に調達されたレゞデンシャル、モバむル、ISP、デヌタセンタヌプロキシに加え、スクレむピングずAI自動化のツヌルを提䟛したす。コヌド SCRAPLING10 でレゞデンシャルプロキシが10%オフになりたす。
+ <a href="https://byteful.com/?utm_source=github&utm_medium=github-sponsor&utm_campaign=scrapling_github_sponsor" target="_blank">Byteful</a> は、倫理的に調達されたレゞデンシャル、モバむル、ISP、デヌタセンタヌプロキシに加え、スクレむピングず AI 自動化のツヌルを提䟛したす。コヌド SCRAPLING10 でレゞデンシャルプロキシが 10% オフになりたす。
</td>
</tr>
<tr>
@@ -183,7 +183,7 @@ result.items.to_json("quotes.json")
</a>
</td>
<td>
- <a href="https://proxylane.dev/?utm_source=scrapling&utm_medium=partnership&utm_campaign=scrapling_platinum_202609&utm_content=github_readme" target="_blank">ProxyLane</a>ブロックずCAPTCHAを90%削枛。倧芏暡なWebスクレむピング向けに、2,800䞇の高品質なレゞデンシャルIPを提䟛。195か囜に察応。郜垂・ISP・郵䟿番号ZIPの指定が可胜。固定・ロヌテヌションセッション。有効期限のない通信量を $2/GB から提䟛。コヌド <strong>SCRAPEANDTAKE</strong> で<em>25%オフ</em>。
+ <a href="https://proxylane.dev/?utm_source=scrapling&utm_medium=partnership&utm_campaign=scrapling_platinum_202609&utm_content=github_readme" target="_blank">ProxyLane</a>ブロックず CAPTCHA を 90% 削枛したす。倧芏暡なりェブスクレむピング向けに、2,800 䞇の高品質なレゞデンシャル IP を提䟛したす。195 か囜に察応し、郜垂・ISP・郵䟿番号ZIPを指定できたす。同じ IP を保぀セッションず、IP を切り替えるセッションを䜿えたす。有効期限のない通信量を $2/GB から提䟛したす。コヌド <strong>SCRAPEANDTAKE</strong> で<em>25% オフ</em>になりたす。
</td>
</tr>
<tr>
@@ -193,7 +193,7 @@ result.items.to_json("quotes.json")
</a>
</td>
<td>
- <a href="https://www.lundproxy.com?utm_source=github&utm_medium=sponsorship&utm_campaign=scrapling&utm_content=text" target="_blank">LundProxy</a>GB単䜍の課金はもう䞍芁。レゞデンシャルプロキシの通信量は無制限。1億以䞊のIP、190か囜以䞊に察応。垯域幅に応じた料金。50 Mbps のレゞデンシャルプロキシの無料トラむアルをお申し蟌みください。
+ <a href="https://www.lundproxy.com?utm_source=github&utm_medium=sponsorship&utm_campaign=scrapling&utm_content=text" target="_blank">LundProxy</a>GB 単䜍の課金は䞍芁です。レゞデンシャルプロキシの通信量は無制限です。1 億以䞊の IP、190 か囜以䞊に察応したす。料金は垯域幅に応じお決たりたす。50 Mbps のレゞデンシャルプロキシの無料トラむアルをお申し蟌みください。
</td>
</tr>
<tr>
@@ -203,12 +203,12 @@ result.items.to_json("quotes.json")
</a>
</td>
<td>
- <a href="https://dataimpulse.com/?utm_source=website&utm_medium=github_readme&utm_campaign=scrapling_platinum" target="_blank">DataImpulse</a> なら $1/GB。倫理的に調達された自瀟提䟛のプロキシ。9,000䞇以䞊のIP、195か囜以䞊に察応。レゞデンシャル、デヌタセンタヌ、モバむル。埓量課金 = サブスクリプション䞍芁。通信量に有効期限はありたせん。
+ <a href="https://dataimpulse.com/?utm_source=website&utm_medium=github_readme&utm_campaign=scrapling_platinum" target="_blank">DataImpulse</a> なら $1/GB です。倫理的に調達された自瀟提䟛のプロキシで、9,000 䞇以䞊の IP、195 か囜以䞊に察応したす。レゞデンシャル、デヌタセンタヌ、モバむルのプロキシを䜿えたす。埓量課金なので、定期契玄は䞍芁です。通信量に有効期限はありたせん。
</td>
</tr>
</table>
-<i><sub>ここに広告を衚瀺したいですか[こちら](https://github.com/sponsors/D4Vinci/sponsorships?tier_id=586646)をクリック</sub></i>
+<i><sub>ここに広告を掲茉するには、[こちら](https://github.com/sponsors/D4Vinci/sponsorships?tier_id=586646)をご芧ください。</sub></i>
# スポンサヌ
<!-- sponsors -->
@@ -226,71 +226,77 @@ result.items.to_json("quotes.json")
<!-- /sponsors -->
-<i><sub>ここに広告を衚瀺したいですか[こちら](https://github.com/sponsors/D4Vinci)をクリックしお、あなたに合ったティアを遞択しおください</sub></i>
+<i><sub>ここに広告を掲茉するには、[こちら](https://github.com/sponsors/D4Vinci)からプランを遞んでください。</sub></i>
---
## 䞻な機胜
-### Spider - 本栌的なクロヌルフレヌムワヌク
-- 🕷 **Scrapy 颚の Spider API**`start_urls`、async `parse` callback、`Request`/`Response` オブゞェクトで Spider を定矩。
-- ⚡ **䞊行クロヌル**蚭定可胜な䞊行数制限、ドメむンごずのスロットリング、ダりンロヌド遅延。
-- 🔄 **マルチ Session サポヌト**HTTP リク゚ストずステルスヘッドレスブラりザの統䞀むンタヌフェヌス - ID によっお異なる Session にリク゚ストをルヌティング。
-- 💟 **䞀時停止ず再開**`crawldir` で保留䞭のリク゚ストず蚪問枈み URL を保存したす。Ctrl+C で正垞終了し、同じディレクトリで再起動したす。
-- 📡 **Streaming モヌド**`async for item in spider.stream()` でリアルタむム統蚈ずずもにスクレむプされたアむテムを Streaming で受信 - UI、パむプラむン、長時間実行クロヌルに最適。
-- 🛡 **ブロックされたリク゚ストの怜出**カスタマむズ可胜なロゞックによるブロックされたリク゚ストの自動怜出ずリトラむ。
-- 🚊 **AutoThrottle**埅ち時間を勘で決める必芁はありたせん。Spider がサむトの応答速床からドメむンごずの埅ち時間を自動調敎し、ブロックやレヌト制限が始たるず埅ち時間を 2 倍にたたは `Retry-After` が求める時間だけ埅機しお、収たればたた加速したす。
-- 🀖 **robots.txt 準拠**オプションの `robots_txt_obey` フラグで `Disallow`、`Crawl-delay`、`Request-rate` ディレクティブをドメむンごずのキャッシュで遵守。
-- 🧪 **開発モヌド**初回実行時にレスポンスをディスクにキャッシュし、以降の実行ではそれを再生 - タヌゲットサヌバヌに再リク゚ストするこずなく `parse()` ロゞックを反埩開発できたす。
-- 🧩 **すぐに䜿える Spider テンプレヌト**定型コヌドは䞍芁です。ルヌルベヌスのリンク远跡には `CrawlSpider`、sitemap/robots.txt を起点ずしたクロヌルには `SitemapSpider`、XML/RSS や CSV フィヌドの走査には `XMLFeedSpider`/`CSVFeedSpider`、そしお `ShopifySpider` で公開されおいる Shopify ストアの商品を取埗できたすバリ゚ヌションごずに 1 件。
-- 🔗 **リンク抜出**allow/deny パタヌン、ドメむンフィルタ、CSS/XPath による範囲指定、拡匵子フィルタ、正芏化に察応した独立した `LinkExtractor` を提䟛。テンプレヌト内でも単䜓でも䜿甚できたす。
-- 📊 **組み蟌み゚クスポヌト**フックや独自のパむプラむン、たたは組み蟌みの JSON/JSONL/CSV/XML で結果を゚クスポヌト。`result.items.to_json()`、`to_jsonl()`、`to_csv()`、`to_xml()` が䜿えたす。
-
-### Session サポヌト付き高床なりェブサむト取埗
-- **HTTP リク゚スト**`Fetcher` クラスで高速か぀ステルスな HTTP リク゚スト。ブラりザの TLS fingerprint、ヘッダヌを暡倣し、HTTP/3 を䜿甚可胜。
-- **動的読み蟌み**Playwright の Chromium ず Google Chrome をサポヌトする `StealthyFetcher` クラスによる完党なブラりザ自動化で動的りェブサむトを取埗。
-- **アンチボット回避**`StealthyFetcher` の高床なステルス機胜ずフィンガヌプリント停装。あらゆる皮類の Cloudflare Turnstile/Interstitial を自動で簡単に回避できたす。
-- **Session 管理**リク゚スト間で Cookie ず状態を管理するための `FetcherSession`、`StealthySession` クラスによる氞続的な Session サポヌト。
-- **Proxy 回転**すべおの Session タむプに察応したラりンドロビンたたはカスタム戊略の組み蟌み `ProxyRotator`、さらにリク゚ストごずの Proxy オヌバヌラむド。
-- **ドメむン広告ブロック**ブラりザベヌスの Fetcher で特定のドメむンおよびそのサブドメむンぞのリク゚ストをブロック、たたは内蔵広告ブロック玄3,500の既知の広告/トラッカヌドメむンを有効化。
-- **DNS リヌク防止**Proxy 䜿甚時の DNS リヌクを防ぐため、Cloudflare の DoH 経由で DNS ク゚リをルヌティングするオプションの DNS-over-HTTPS サポヌト。
-- **リモヌトブラりザ**ロヌカルでブラりザを起動する代わりに、`cdp_url` を䜿っお CDP 経由で既に起動しおいるブラりザに接続できたす。同じマシン䞊でも、別のホストでも、マネヌゞドブラりザサヌビスでも構いたせん。`executable_path` を䜿えば、任意のブラりザ Fetcher を独自ビルドの Chromium に向けるこずもできたす。
-- **バックグラりンド API キャプチャ**ブラりザヌセッションで `record_requests=True` を有効にし、`session.network.search(limit=None)` で保存枈みのレスポンスを怜玢できたす。リク゚ストを再送信せずに、耇数のペヌゞ読み蟌みで発生した API デヌタや HTTP ゚ラヌを確認できたす。履歎には保存䞊限があり、テキストのレスポンス本文を保存したす。
-- **async サポヌト**すべおの Fetcher および専甚 async Session クラス党䜓での完党な async サポヌト。
-
-### パヌスずデヌタ抜出
-- 🔄 **スマヌト芁玠远跡**むンテリゞェントな類䌌性アルゎリズムを䜿甚しおりェブサむトの倉曎埌に芁玠を再配眮。
-- 🎯 **スマヌト柔軟遞択**CSS セレクタ、XPath セレクタ、フィルタベヌス怜玢、テキスト怜玢、正芏衚珟怜玢など。
-- 🔍 **類䌌芁玠の怜出**芋぀かった芁玠に類䌌した芁玠を自動的に特定。
+### Spider本栌的なクロヌルフレヌムワヌク
+
+- 🕷 **Scrapy に䌌た Spider API**`start_urls`、非同期の `parse` コヌルバック、`Request` ず `Response` オブゞェクトで Spider を定矩したす。
+- ⚡ **䞊行クロヌル**同時に凊理するリク゚スト数、ドメむンごずの制限、ダりンロヌドの埅ち時間を蚭定できたす。
+- 🔄 **耇数のセッション**ひず぀の Spider で HTTP リク゚ストずステルス察応のヘッドレスブラりザを䜿えたす。セッション ID でリク゚ストの凊理先を遞びたす。
+- 💟 **䞀時停止ず再開**`crawldir` で埅機䞭のリク゚ストず蚪問枈み URL を保存したす。Ctrl+C で安党に停止し、同じディレクトリで起動するず続きから再開できたす。
+- 📡 **ストリヌミング**`async for item in spider.stream()` で、抜出したデヌタをすぐに受け取れたす。統蚈もリアルタむムで確認できたす。画面ぞの衚瀺、デヌタ凊理、長時間のクロヌルに適しおいたす。
+- 🛡 **ブロックの怜出**ブロックされたリク゚ストを自動で怜出し、再詊行したす。凊理は倉曎できたす。
+- 🚊 **AutoThrottle**サむトの応答速床に合わせお、ドメむンごずの埅ち時間を自動調敎したす。ブロックや頻床制限を受けたら埅ち時間を 2 倍にするか、`Retry-After` が指定する時間を埅ちたす。問題が収たるず再び速床を䞊げたす。
+- 🀖 **robots.txt の遵守**`robots_txt_obey` を有効にするず、`Disallow`、`Crawl-delay`、`Request-rate` に埓いたす。ルヌルはドメむンごずにキャッシュしたす。
+- 🧪 **開発モヌド**初回のレスポンスをディスクに保存し、次回から再利甚したす。サヌバヌに再床アクセスせずに `parse()` を調敎できたす。
+- 🧩 **すぐに䜿える Spider テンプレヌト**`CrawlSpider` はルヌルに沿っおリンクをたどり、`SitemapSpider` は sitemap や robots.txt を起点にクロヌルしたす。`XMLFeedSpider` ず `CSVFeedSpider` は XML・RSS・CSV フィヌドを読み取りたす。`ShopifySpider` は公開 Shopify ストアの商品を取埗し、バリ゚ヌションごずに 1 件のデヌタを出力したす。
+- 🔗 **リンク抜出**`LinkExtractor` はパタヌンによる蚱可ず陀倖、ドメむンや拡匵子の絞り蟌み、CSS ず XPath による範囲指定、URL の正芏化に察応したす。テンプレヌト内でも単䜓でも䜿えたす。
+- 📊 **デヌタの出力**フックず独自の凊理を䜿うか、組み蟌みの JSON・JSONL・CSV・XML 出力を䜿えたす。`result.items.to_json()`、`to_jsonl()`、`to_csv()`、`to_xml()` を呌び出したす。
+
+### セッションを䜿ったペヌゞの取埗
+
+- **HTTP リク゚スト**`Fetcher` で高速か぀怜出されにくい HTTP リク゚ストを送れたす。ブラりザの TLS フィンガヌプリントずヘッダヌの暡倣や、HTTP/3 に察応したす。
+- **動的なペヌゞの読み蟌み**`StealthyFetcher` のブラりザ自動化で動的なサむトを取埗できたす。Playwright の Chromium ず Google Chrome に察応したす。
+- **ボット怜出の回避**`StealthyFetcher` は自動化の痕跡を隠し、フィンガヌプリントを停装したす。Cloudflare Turnstile や Interstitial の各皮怜蚌を自動凊理できたす。
+- **セッション管理**`FetcherSession` ず `StealthySession` は、リク゚スト間で Cookie ず状態を保持したす。
+- **プロキシの切り替え**`ProxyRotator` は、すべおのセッションで順番に、たたは独自のルヌルでプロキシを切り替えたす。リク゚ストごずにプロキシを指定するこずもできたす。
+- **ドメむンず広告のブロック**指定したドメむンずそのサブドメむンぞのリク゚ストを止められたす。ブラりザ Fetcher には広告ブロック機胜もあり、玄 3,500 の広告・远跡甚ドメむンに察応したす。
+- **DNS リヌクの防止**DNS-over-HTTPS を有効にするず、Cloudflare の DoH を通じお DNS を問い合わせたす。プロキシ䜿甚時の DNS リヌクを防ぎたす。
+- **リモヌトブラりザ**CDP ず `cdp_url` を䜿い、すでに動いおいるブラりザに接続できたす。同じパ゜コン、別のサヌバヌ、ブラりザ提䟛サヌビスのいずれでも䜿えたす。`executable_path` で、各ブラりザ Fetcher に独自の Chromium を指定するこずもできたす。
+- **バックグラりンド API レスポンスの蚘録**ブラりザセッションで `record_requests=True` を有効にし、`session.network.search(limit=None)` で保存枈みレスポンスを怜玢したす。リク゚ストを送り盎さずに、耇数のペヌゞ読み蟌みで発生した API デヌタや HTTP ゚ラヌを確認できたす。履歎には䞊限があり、テキストのレスポンス本文を保存したす。
+- **非同期察応**すべおの Fetcher で非同期凊理を䜿えたす。専甚の非同期セッションもありたす。
+
+### 解析ずデヌタ抜出
+
+- 🔄 **芁玠の再怜玢**サむトが倉わった埌も、類䌌床を䜿っお芁玠を芋぀け盎したす。
+- 🎯 **柔軟な遞択**CSS、XPath、フィルタヌ、テキスト、正芏衚珟などを䜿えたす。
+- 🔍 **類䌌芁玠の怜玢**芋぀けた芁玠に䌌た芁玠を自動で探したす。
### AI 機胜
-- 🀖 **MCP サヌバヌ**AI チャットボットや゚ヌゞェントClaude/Cursor などが Scrapling を通じおスクレむピングできるようにしたす。HTTP リク゚スト、ブラりザ操䜜、スクリヌンショット、保存枈みログむン状態、バックグラりンド API レスポンスを利甚できたす。独自のステルスブラりザず適切なツヌルで、十分な胜力を持぀ AI モデルが䜜業䞭に遭遇するどんな CAPTCHA でも回避できるようにしたすもちろん、独自の Cloudflare ゜ルバヌもありたす。モデルに送る内容の削枛、広告のブロック、プロンプトむンゞェクションからの保護にさたざたな手法を䜿いたす。CDP 経由のリモヌトブラりザず認蚌オプション付き HTTP トランスポヌトにも察応したす。[デモ動画](https://www.youtube.com/watch?v=qyFk3ZNwOxE)
-- 🧠 **Agent Skill**ラむブラリ党䜓をコヌディング゚ヌゞェントに教える、むンストヌルするだけの [Agent Skill](https://scrapling.readthedocs.io/en/latest/ai/agent-skill.html)。゚ヌゞェントが Scrapling で曞くコヌドが、掚枬ではなく珟圚の API に沿ったものになりたす。
-- 📚 **RAG 察応の Markdown**1 行`page.markdown()`で任意のペヌゞをクリヌンでサニタむズ枈みの LLM 向け Markdown に倉換したり、`ContentSpider` テンプレヌトでサむト党䜓を Markdown コヌパスずしおクロヌルしたりできたす。凊理に LLM は䞀切䜿いたせん。[ドキュメント](https://scrapling.readthedocs.io/en/latest/ai/building-rag-systems.html)
-
-### 高性胜で実戊テスト枈みのアヌキテクチャ
-- 🚀 **超高速**ほずんどの Python スクレむピングラむブラリを䞊回る最適化されたパフォヌマンス。
-- 🔋 **メモリ効率**最小のメモリフットプリントのための最適化されたデヌタ構造ず遅延読み蟌み。
-- ⚡ **高速 JSON シリアル化**暙準ラむブラリの 10 倍の速床。
-- 🏗 **実戊テスト枈み**Scrapling は 92% のテストカバレッゞず完党な型ヒントカバレッゞを備えおいるだけでなく、過去1幎間に数癟人の Web Scraper によっお毎日䜿甚されおきたした。
-
-### 開発者/Web Scraper にやさしい䜓隓
-- 🎯 **むンタラクティブ Web Scraping Shell**Scrapling 統合、ショヌトカット、curl リク゚ストを Scrapling リク゚ストに倉換したり、ブラりザでリク゚スト結果を衚瀺したりするなどの新しいツヌルを備えたオプションの組み蟌み IPython Shell で、Web Scraping スクリプトの開発を加速。
-- 🚀 **タヌミナルから盎接䜿甚**オプションで、コヌドを䞀行も曞かずに Scrapling を䜿甚しお URL をスクレむプできたす
-- 🛠 **豊富なナビゲヌション API**芪、兄匟、子のナビゲヌションメ゜ッドによる高床な DOM トラバヌサル。
-- 🧬 **匷化されたテキスト凊理**組み蟌みの正芏衚珟、クリヌニングメ゜ッド、最適化された文字列操䜜。
-- 📝 **自動セレクタ生成**任意の芁玠に察しお堅牢な CSS/XPath セレクタを生成。
-- 🔌 **銎染みのある API**Scrapy/Parsel で䜿甚されおいる同じ疑䌌芁玠を持぀ Scrapy/BeautifulSoup に䌌た蚭蚈。
-- 🀝 **Scrapy ずのシヌムレスな統合**すでに Scrapy を䜿っおいたすか任意のコヌルバックを `scrapling_response` でデコレヌトするだけで、既に取埗しおいるレスポンスを Scrapling のパヌサヌで解析できたす。曞き盎しは䞍芁です。
-- 📘 **完党な型カバレッゞ**優れた IDE サポヌトずコヌド補完のための完党な型ヒント。コヌドベヌス党䜓が倉曎のたびに**PyRight**ず**MyPy**で自動的にスキャンされたす。
-- 🔋 **すぐに䜿える Docker むメヌゞ**各リリヌスで、すべおのブラりザを含む Docker むメヌゞが自動的にビルドおよびプッシュされたす。
+
+- 🀖 **MCP サヌバヌ**Claude や Cursor などの AI アシスタントず゚ヌゞェントが Scrapling を䜿っおデヌタを抜出できたす。HTTP リク゚スト、ブラりザ操䜜、スクリヌンショット、保存枈みログむン状態、バックグラりンド API レスポンスに察応したす。ステルスブラりザずツヌルを䜿い、察応する胜力を持぀モデルが CAPTCHA を凊理できるようにしたす。Cloudflare 怜蚌の凊理機胜もありたす。モデルぞ送る内容を枛らし、広告をブロックし、プロンプトむンゞェクションから保護したす。CDP によるリモヌトブラりザ接続や、認蚌付きの HTTP 接続にも察応したす。[デモ動画](https://www.youtube.com/watch?v=qyFk3ZNwOxE)
+- 🧠 **Agent Skill**むンストヌルしお䜿える [Agent Skill](https://scrapling.readthedocs.io/en/latest/ja/ai/agent-skill.html) が、コヌディング゚ヌゞェントにラむブラリの䜿い方を䌝えたす。珟圚の API に合ったコヌドを曞く助けになりたす。
+- 📚 **RAG 向けの Markdown**1 行のコヌド`page.markdown()`で、ペヌゞを敎理・クリヌニングした LLM 向けの Markdown に倉換したす。`ContentSpider` テンプレヌトを䜿えば、サむト党䜓を Markdown ファむルに保存できたす。この凊理に LLM は䞍芁です。[ドキュメント](https://scrapling.readthedocs.io/en/latest/ja/ai/building-rag-systems.html)
+
+### 高速で、実際の䜜業にも䜿われおいたす
+
+- 🚀 **高速な凊理**最適化により、倚くの Python スクレむピングラむブラリを䞊回る速床を実珟しおいたす。
+- 🔋 **少ないメモリ䜿甚量**最適化したデヌタ構造ず、必芁なずきだけ読み蟌む仕組みを䜿っおいたす。
+- ⚡ **高速な JSON 出力**暙準ラむブラリの 10 倍の速床です。
+- 🏗 **実際の䜜業で怜蚌枈み**テストカバレッゞは 92% で、すべおのコヌドに型ヒントがありたす。この 1 幎間、数癟人が毎日のデヌタ抜出に䜿っおきたした。
+
+### 開発ずデヌタ抜出のためのツヌル
+
+- 🎯 **察話型シェル**Scrapling ず連携した IPython シェルを远加できたす。ショヌトカットやツヌルでスクリプトの開発を助けたす。curl リク゚ストを Scrapling のリク゚ストに倉換し、結果をブラりザで確認できたす。
+- 🚀 **タヌミナルからの利甚**コヌドを曞かずに URL の内容を取埗できたす。
+- 🛠 **DOM の移動**芪芁玠、兄匟芁玠、子芁玠をたどれたす。
+- 🧬 **テキスト凊理**正芏衚珟、テキストのクリヌニング、最適化した文字列操䜜を䜿えたす。
+- 📝 **セレクタヌの生成**任意の芁玠に察する CSS ず XPath のセレクタヌを生成したす。
+- 🔌 **䜿い慣れた API**Scrapy や BeautifulSoup に䌌た API で、Scrapy ず Parsel ず同じ疑䌌芁玠を䜿えたす。
+- 🀝 **Scrapy ずの連携**コヌルバックに `scrapling_response` デコレヌタヌを付けるず、取埗枈みのレスポンスを Scrapling のパヌサヌで解析できたす。プログラムを曞き盎す必芁はありたせん。
+- 📘 **すべおのコヌドに型ヒント**゚ディタヌでの確認ずコヌド補完を助けたす。倉曎のたびに、すべおのコヌドを **PyRight** ず **MyPy** で自動チェックしたす。
+- 🔋 **すぐに䜿える Docker むメヌゞ**リリヌスごずに、すべおのブラりザを含む Docker むメヌゞを自動で䜜成・公開したす。
## はじめに
-深く掘り䞋げずに、Scrapling にできるこずの簡単な抂芁をお芋せしたしょう。
+よく䜿う機胜をいく぀か玹介したす。
### 基本的な䜿い方
-Session サポヌト付き HTTP リク゚スト
+セッションを䜿った HTTP リク゚スト
```python
from scrapling.fetchers import Fetcher, FetcherSession
@@ -328,7 +334,7 @@ data = page.css('.quote .text::text').getall()
```
### Spider
-䞊行リク゚スト、耇数の Session タむプ、Pause & Resume を備えた本栌的なクロヌラヌを構築
+䞊行リク゚スト、耇数のセッション、䞀時停止ず再開に察応したクロヌラヌを䜜れたす。
```python
from scrapling.spiders import Spider, Response
@@ -352,7 +358,7 @@ result = QuotesSpider().start()
print(f"{len(result.items)}件の匕甚をスクレむプしたした")
result.items.to_json("quotes.json")
```
-単䞀の Spider で耇数の Session タむプを䜿甚
+ひず぀の Spider で、耇数の皮類のセッションを䜿えたす。
```python
from scrapling.spiders import Spider, Request, Response
from scrapling.fetchers import FetcherSession, AsyncStealthySession
@@ -373,13 +379,13 @@ class MultiSessionSpider(Spider):
else:
yield Request(link, sid="fast", callback=self.parse) # 明瀺的な callback
```
-Checkpoint を䜿甚しお長時間のクロヌルをPause & Resume
+進捗を保存すれば、長時間のクロヌルを䞀時停止しお再開できたす。次のように Spider を起動したす。
```python
QuotesSpider(crawldir="./crawl_data").start()
```
`crawldir` を蚭定しお Ctrl+C を抌すず、保留䞭のリク゚ストず蚪問枈み URL が保存されたす。同じ `crawldir` で再起動するず再開できたす。抜出デヌタは別途保存しおください。
-あるいは、すぐに䜿えるテンプレヌトでクロヌルのロゞックを曞くこず自䜓を省略できたす。たずえば Shopify ストアのカタログを䞞ごず取埗する堎合
+すぐに䜿えるテンプレヌトもありたす。たずえば、Shopify ストアの商品党䜓を取埗できたす。
```python
from scrapling.spiders import ShopifySpider
@@ -388,9 +394,9 @@ class MyStore(ShopifySpider):
result = MyStore().start() # ストア内の党商品を、バリ゚ヌションごずに 1 件取埗
```
-テンプレヌトは公開コレクション API が提䟛する商品を、バリ゚ヌションごずに 1 件取埗したす。
+このテンプレヌトは公開されおいるコレクション API から商品を読み取り、バリ゚ヌションごずに 1 件のデヌタを出力したす。
-### 高床なパヌスずナビゲヌション
+### さらに詳しい解析ず芁玠の移動
```python
from scrapling.fetchers import Fetcher
@@ -420,15 +426,15 @@ parent_container = first_quote.parent
similar_elements = first_quote.find_similar()
below_elements = first_quote.below_elements
```
-りェブサむトを取埗せずにパヌサヌをすぐに䜿甚するこずもできたす
+ペヌゞを取埗せずに、パヌサヌを盎接䜿うこずもできたす。
```python
from scrapling.parser import Selector
page = Selector("<html>...</html>")
```
-たったく同じ方法で動䜜したす
+䜿い方は同じです。
-### 非同期 Session 管理の䟋
+### 非同期セッションの䟋
```python
import asyncio
from scrapling.fetchers import FetcherSession, AsyncStealthySession
@@ -447,13 +453,13 @@ async def main():
asyncio.run(main())
```
-## CLI ずむンタラクティブ Shell
+## CLI ず察話型シェル
-Scrapling には匷力なコマンドラむンむンタヌフェヌスが含たれおいたす
+タヌミナルからも Scrapling を䜿えたす。
[![asciicast](https://asciinema.org/a/736339.svg)](https://asciinema.org/a/736339)
-むンタラクティブ Web Scraping Shell を起動
+スクレむピング甚の察話型シェルを起動したす。
```bash
pip install "scrapling[shell]"
scrapling shell
@@ -467,52 +473,52 @@ scrapling extract fetch 'https://nopecha.com/demo/cloudflare' captchas.html --cs
```
> [!NOTE]
-> MCP サヌバヌやむンタラクティブ Web Scraping Shell など、他にも倚くの远加機胜がありたすが、このペヌゞは簡朔に保ちたいず思いたす。完党なドキュメントは[こちら](https://scrapling.readthedocs.io/en/latest/)をご芧ください
+> MCP サヌバヌや察話型シェルなど、ほかの機胜は[ドキュメント](https://scrapling.readthedocs.io/en/latest/ja/)をご芧ください。
-## パフォヌマンスベンチマヌク
+## 性胜テスト
-Scrapling は匷力であるだけでなく、超高速です。以䞋のベンチマヌクは、Scrapling のパヌサヌを他の人気ラむブラリの最新バヌゞョンず比范しおいたす。
+Scrapling は凊理速床も重芖しおいたす。以䞋では、そのパヌサヌず他のよく䜿われるラむブラリの最新バヌゞョンを比范したす。
-### テキスト抜出速床テスト5000 個のネストされた芁玠
+### テキスト抜出の速床5,000 個の入れ子の芁玠
-| # | ラむブラリ | 時間 (ms) | vs Scrapling |
+| # | ラむブラリ | 時間ミリ秒 | Scrapling ずの比范 |
|---|:-----------------:|:---------:|:------------:|
| 1 | Scrapling | 1.99 | 1.0x |
| 2 | Parsel/Scrapy | 2.06 | 1.035 |
-| 3 | Raw Lxml | 2.56 | 1.286 |
+| 3 | Lxml 単䜓 | 2.56 | 1.286 |
| 4 | PyQuery | 23.98 | ~12x |
| 5 | Selectolax | 197.02 | ~99x |
| 6 | MechanicalSoup | 1545.15 | ~776.5x |
-| 7 | BS4 with Lxml | 1562.1 | ~785.0x |
-| 8 | BS4 with html5lib | 3412.73 | ~1714.9x |
+| 7 | BS4 + Lxml | 1562.1 | ~785.0x |
+| 8 | BS4 + html5lib | 3412.73 | ~1714.9x |
-### 芁玠類䌌性ずテキスト怜玢のパフォヌマンス
+### 類䌌芁玠ずテキストの怜玢
-Scrapling の適応型芁玠怜玢機胜は代替手段を倧幅に䞊回りたす
+Scrapling の適応型の芁玠怜玢は、他の方法より高速です。
-| ラむブラリ | 時間 (ms) | vs Scrapling |
+| ラむブラリ | 時間ミリ秒 | Scrapling ずの比范 |
|-------------|:---------:|:------------:|
| Scrapling | 2.3 | 1.0x |
| AutoScraper | 12.58 | 5.47x |
-> すべおのベンチマヌクは 100 回以䞊の実行の平均を衚したす。方法論に぀いおは[benchmarks.py](https://github.com/D4Vinci/Scrapling/blob/main/benchmarks.py)を参照しおください。
+> 各結果は、100 回以䞊の実行の平均です。枬定方法は [benchmarks.py](https://github.com/D4Vinci/Scrapling/blob/main/benchmarks.py) をご芧ください。
## むンストヌル
-Scrapling には Python 3.10 以䞊が必芁です
+Scrapling には Python 3.10 以䞊が必芁です。
```bash
pip install scrapling
```
> [!IMPORTANT]
-> このむンストヌルにはパヌサヌ゚ンゞンずその䟝存関係のみが含たれおおり、Fetcher やコマンドラむン䟝存関係は含たれおいたせん。 そのため、このむンストヌルのみでは、䞊蚘の䟋のように `scrapling.fetchers` や `scrapling.spiders` から䜕かをむンポヌトするず `ModuleNotFoundError` が発生したす。Fetcher や Spider を䜿甚する堎合は、以䞋のように、たず Fetcher の䟝存関係をむンストヌルしおください。
+> このコマンドはパヌサヌずその䟝存パッケヌゞだけをむンストヌルしたす。Fetcher やコマンドラむンツヌルは含たれたせん。この状態で䞊の䟋のように `scrapling.fetchers` や `scrapling.spiders` からむンポヌトするず、`ModuleNotFoundError` が発生したす。Fetcher や Spider を䜿う堎合は、先に以䞋の手順で Fetcher の䟝存パッケヌゞをむンストヌルしおください。
-### オプションの䟝存関係
+### 远加の䟝存パッケヌゞ
-1. 以䞋の远加機胜、Fetcher、たたはそれらのクラスのいずれかを䜿甚する堎合は、Fetcher の䟝存関係ずブラりザの䟝存関係を次のようにむンストヌルする必芁がありたす
+1. Fetcher、関連するクラス、以䞋の远加機胜を䜿う堎合は、Fetcher ずブラりザに必芁なパッケヌゞをむンストヌルしたす。
```bash
pip install "scrapling[fetchers]"
@@ -520,9 +526,9 @@ pip install scrapling
scrapling install --force # force reinstall
```
- これにより、すべおのブラりザ、およびそれらのシステム䟝存関係ずfingerprint 操䜜䟝存関係がダりンロヌドされたす。
+ すべおのブラりザ、必芁なシステムパッケヌゞ、フィンガヌプリントを倉曎するツヌルがダりンロヌドされたす。
- たたは、コマンドを実行する代わりにコヌドからむンストヌルするこずもできたす
+ コマンドの代わりに、Python のコヌドからむンストヌルするこずもできたす。
```python
from scrapling.cli import install
@@ -531,46 +537,46 @@ pip install scrapling
```
2. 远加機胜
- - MCP サヌバヌ機胜をむンストヌル
+ - MCP サヌバヌをむンストヌル
```bash
pip install "scrapling[ai]"
```
- - [RAG システムの構築](https://scrapling.readthedocs.io/en/latest/ai/building-rag-systems.html)甚の䟝存関係をむンストヌル
+ - [RAG システムの構築](https://scrapling.readthedocs.io/en/latest/ja/ai/building-rag-systems.html)に必芁なパッケヌゞをむンストヌル
```bash
pip install "scrapling[rag]"
```
- - Shell 機胜Web Scraping Shell ず`extract`コマンドをむンストヌル
+ - 察話型シェルず `extract` コマンドをむンストヌル
```bash
pip install "scrapling[shell]"
```
- - すべおをむンストヌル
+ - すべおの機胜をむンストヌル
```bash
pip install "scrapling[all]"
```
- ブラりザ fetcher を䜿う堎合は `scrapling install` を実行しおください。HTTP リク゚ストにはブラりザのむンストヌルは䞍芁です。
+ ブラりザ Fetcher を䜿う堎合は `scrapling install` を実行しおください。HTTP リク゚ストにはブラりザのむンストヌルは䞍芁です。
### Docker
-DockerHub から次のコマンドですべおの远加機胜ずブラりザを含む Docker むメヌゞをむンストヌルするこずもできたす
+すべおの远加機胜ずブラりザを含む Docker むメヌゞを DockerHub から取埗するこずもできたす。
```bash
docker pull pyd4vinci/scrapling
```
-たたは GitHub レゞストリからダりンロヌド
+GitHub のレゞストリからも取埗できたす。
```bash
docker pull ghcr.io/d4vinci/scrapling:latest
```
-このむメヌゞは、GitHub Actions ずリポゞトリのメむンブランチを䜿甚しお自動的にビルドおよびプッシュされたす。
+このむメヌゞはリポゞトリのメむンブランチを䜿い、GitHub Actions で自動䜜成・公開されたす。
-## 貢献
+## 開発ぞの参加
-貢献を歓迎したす始める前に[貢献ガむドラむン](https://github.com/D4Vinci/Scrapling/blob/main/CONTRIBUTING.md)をお読みください。
+開発ぞの参加を歓迎したす。始める前に[参加ガむド](https://github.com/D4Vinci/Scrapling/blob/main/CONTRIBUTING.md)をお読みください。
## 免責事項
> [!CAUTION]
-> このラむブラリは教育および研究目的のみで提䟛されおいたす。このラむブラリを䜿甚するこずにより、地域および囜際的なデヌタスクレむピングおよびプラむバシヌ法に準拠するこずに同意したものずみなされたす。著者および貢献者は、この゜フトりェアの誀甚に぀いお責任を負いたせん。垞にりェブサむトの利甚芏玄ずrobots.txt ファむルを尊重しおください。
+> このラむブラリは孊習ず研究のために提䟛しおいたす。利甚する堎合は、地域および囜際的なデヌタ取埗ずプラむバシヌの法埋に埓うこずに同意したものずしたす。䜜者ず開発ぞの参加者は、゜フトりェアの悪甚に責任を負いたせん。サむトの利甚芏玄ず robots.txt に埓っおください。
## 🎓 匕甚
-研究目的で圓ラむブラリを䜿甚された堎合は、以䞋の参考文献で匕甚しおください
+研究でこのラむブラリを䜿った堎合は、次の圢匏で匕甚しおください。
```text
@misc{scrapling,
author = {Karim Shoair},
@@ -583,12 +589,12 @@ docker pull ghcr.io/d4vinci/scrapling:latest
## ラむセンス
-この䜜品は BSD-3-Clause ラむセンスの䞋でラむセンスされおいたす。
+本プロゞェクトは BSD-3-Clause ラむセンスで公開しおいたす。
## 謝蟞
-このプロゞェクトには次から適応されたコヌドが含たれおいたす
-- ParselBSD ラむセンス- [translator](https://github.com/D4Vinci/Scrapling/blob/main/scrapling/core/translator.py) サブモゞュヌルに䜿甚
+本プロゞェクトには、次のプロゞェクトをもずにしたコヌドが含たれたす。
+- ParselBSD ラむセンス[translator](https://github.com/D4Vinci/Scrapling/blob/main/scrapling/core/translator.py) サブモゞュヌルで䜿甚
---
-<div align="center"><small>Karim Shoair によっお❀でデザむンおよび䜜成されたした。</small></div><br>
+<div align="center"><small>Karim Shoair が❀を蟌めおデザむン・制䜜したした。</small></div><br>
diff --git a/docs/locales/ja/ai/agent-skill.md b/docs/locales/ja/ai/agent-skill.md
new file mode 100644
index 0000000..d65dea0
--- /dev/null
+++ b/docs/locales/ja/ai/agent-skill.md
@@ -0,0 +1,42 @@
+---
+title: "Scrapling Agent Skill のむンストヌルず䜿い方"
+description: "コヌディング゚ヌゞェントに Scrapling Skill をむンストヌルしたす。ペヌゞ取埗、解析、クロヌルに䜿える最新 API の䟋ずリファレンスを提䟛したす。"
+---
+
+# Scrapling Agent Skill {#scrapling-agent-skill}
+
+[MCP サヌバヌ](mcp-server.md)は AI チャットボットに Web サむトをスクレむピングするツヌルを提䟛したす。**Scrapling Agent Skill** は、コヌディング゚ヌゞェントにラむブラリ自䜓の䜿い方を教えたす。これにより、叀い孊習デヌタから掚枬するのではなく、珟圚の API に合った Scrapling コヌドを曞けるようになりたす。
+
+この Skill は [AgentSkills](https://agentskills.io/specification) 仕様に埓っおいるため、[Claude Code](https://claude.com/product/claude-code)、[OpenClaw](https://github.com/openclaw/openclaw) などの゚ヌゞェントツヌルで読み蟌めたす。ペヌゞ取埗、解析、クロヌル、MCP、RAG のガむドが、必芁に応じお読み蟌む Markdown リファレンスずしおたずめられおいたす。そのたた実行できる䟋も含たれおいるため、゚ディタヌを離れずに、Scrapling に関する倚くの質問に答え、正しいスクレむピングコヌドを曞けたす。
+
+Skill はリポゞトリの [agent-skill](https://github.com/D4Vinci/Scrapling/tree/main/agent-skill) ディレクトリに `scrapling-official` ずいう名前で眮かれおいたす。バヌゞョンは垞にラむブラリのバヌゞョンに合わせおいたす。
+
+## むンストヌル {#installation}
+
+### Skills.sh {#skillssh}
+
+[skills.sh](https://skills.sh) CLI を䜿っお、リポゞトリから Skill をむンストヌルしたす。
+```bash
+npx skills add D4Vinci/Scrapling --skill scrapling-official
+```
+CLI がむンストヌル枈みの゚ヌゞェントを怜出し、それぞれに Skill を远加したす。
+
+### Clawhub {#clawhub}
+
+OpenClaw を䜿っおいる堎合は、[Clawhub](https://docs.openclaw.ai/tools/clawhub) からむンストヌルできたす。
+```bash
+clawhub install scrapling-official
+```
+[Clawhub のペヌゞ](https://clawhub.ai/D4Vinci/scrapling-official)からもむンストヌルできたす。
+
+### 手動ダりンロヌド {#manual-download}
+
+Skill の ZIP ファむルを[リポゞトリから盎接ダりンロヌド](https://github.com/D4Vinci/Scrapling/raw/refs/heads/main/agent-skill/Scrapling-Skill.zip)し、゚ヌゞェントの Skill ディレクトリに展開したす。Claude Code では `~/.claude/skills/` です。
+
+## 含たれるもの {#whats-inside}
+
+- **`SKILL.md`**゚ヌゞェントが最初に読むファむルです。セットアップ、Fetcher の遞び方、守るべき安党䞊のルヌルを説明しおいたす。䟋えば、プロンプトむンゞェクションを防ぐため、CLI コマンドには垞に `--ai-targeted` を枡したす。
+- **`references/`**ドキュメントペヌゞの Markdown 版です。解析、ペヌゞ取埗、Spider、MCP サヌバヌ、連携機胜を扱いたす。必芁なずきに読み蟌むため、それたでぱヌゞェントのコンテキストを消費したせん。
+- **`examples/`**゚ヌゞェントがコピヌしお䜿える、実行可胜なスクリプトです。
+
+この Skill は OpenClaw ず Claude Code でテストしおいたす。問題があれば [Issue](https://github.com/D4Vinci/Scrapling/issues/new/choose) を䜜成するか、[Discord サヌバヌ](https://discord.gg/EMgGbDceNQ)でお知らせください。
diff --git a/docs/locales/ja/ai/building-rag-systems.md b/docs/locales/ja/ai/building-rag-systems.md
new file mode 100644
index 0000000..11a075b
--- /dev/null
+++ b/docs/locales/ja/ai/building-rag-systems.md
@@ -0,0 +1,109 @@
+---
+title: "Scrapling で Web サむトをクロヌルし、RAG 甚の Markdown を䜜る"
+description: "ペヌゞのレスポンスを Markdown に倉換する方法ず、ContentSpider でサむトを収集する方法を玹介したす。RAG の分割ずむンデックス䜜成に䜿う文曞集合を準備したす。"
+---
+
+# Scrapling で RAG システムを䜜る {#building-rag-systems-with-scrapling}
+
+RAG パむプラむンの品質は、入力するテキストの品質に巊右されたす。生の HTML には、マヌクアップ、ナビゲヌション、スクリプト、トラッキング関連の䞍芁な内容が含たれ、トヌクンを消費したす。隠されたプロンプトむンゞェクションの内容が、そのたた LLM に枡るこずもありたす。Scrapling は LLM を䜿わずに、ペヌゞやサむト党䜓を、䞍芁な内容を取り陀いた Markdown に倉換したす。取り蟌み凊理が速く、ペヌゞごずの LLM 費甚もかかりたせん。
+
+## むンストヌル {#installation}
+
+```bash
+pip install "scrapling[rag]"
+
+scrapling install
+```
+
+`rag` の远加䟝存関係には、Fetcher ず Markdown 倉換機胜が含たれおいたす。`ai`、`shell`、`all` にも含たれたす。`scrapling install` コマンドはブラりザの䟝存関係をダりンロヌドしたす。これはブラりザを䜿う Fetcher にだけ必芁です。
+
+## 1 ペヌゞを Markdown に倉換する {#one-page-to-markdown}
+
+すべおの [Response](../fetching/choosing.md#response-object) に `markdown()` メ゜ッドがありたす。
+
+```python
+from scrapling.fetchers import Fetcher
+
+markdown = Fetcher.get("https://example.com").markdown(main_content_only=True)
+```
+
+すべおの Fetcher で䜿えるため、Cloudflare で保護されたペヌゞも 1 行で倉換できたす。
+
+```python
+from scrapling.fetchers import StealthyFetcher
+
+markdown = StealthyFetcher.fetch("https://protected.example.com", solve_cloudflare=True).markdown(main_content_only=True)
+```
+
+出力は次の 2 ぀の匕数で調敎できたす。
+
+- `main_content_only`ペヌゞの `<body>` タグ内だけを倉換したす。
+- `css_selector`CSS セレクタヌに䞀臎する芁玠だけを倉換したす。すべおの䞀臎結果が結合されたす。パむプラむンに必芁な郚分だけを取り出し、トヌクンを節玄できたす。
+
+```python
+markdown = Fetcher.get("https://example.com/docs/page").markdown(css_selector="article")
+```
+
+匕数にかかわらず、倉換前には必ずスクリプト、スタむル、隠された内容を取り陀きたす。これは、[MCP サヌバヌ](mcp-server.md)が AI ゚ヌゞェントをプロンプトむンゞェクションから守るために䜿う凊理ず同じです。むンラむンスタむルで隠された芁玠、`aria-hidden="true"` の芁玠、隠されたスロット、`<template>` タグ、HTML コメント、れロ幅文字を倉換前に削陀したす。MCP サヌバヌは `main_content_only=True` のずきにこの凊理を䜿いたす。
+
+## サむト党䜓を Markdown の文曞集合に倉換する {#a-whole-website-to-a-markdown-corpus}
+
+`ContentSpider` テンプレヌトは、サむトをクロヌルしお各ペヌゞを倉換したす。[Spider フレヌムワヌク](../spiders/architecture.md)を䜿うため、䞊行凊理、AutoThrottle、robots.txt ぞの察応、䞀時停止ず再開も利甚できたす。
+
+```python
+from scrapling.spiders import ContentSpider
+
+class DocsSpider(ContentSpider):
+ name = "docs"
+ start_urls = ["https://example.com/docs/"]
+ allowed_domains = {"example.com"}
+ output_dir = "docs_markdown"
+ max_pages = 200
+
+result = DocsSpider().start()
+result.items.to_jsonl("docs.jsonl")
+```
+
+クロヌルした各ペヌゞは、`url`、`title`、`markdown` キヌを持぀ 1 ぀のデヌタ項目になりたす。`output_dir` を蚭定するず、各ペヌゞを URL に基づく名前の Markdown ファむルにも保存したす。䞊の実行䟋では、`.md` ファむルのフォルダヌず、取り蟌みに䜿える `docs.jsonl` の䞡方が埗られたす。
+
+察象サむトの倖ぞクロヌルが広がらないよう、このテンプレヌトには `allowed_domains` が必芁です。蚭定できるオプションは次のずおりです。
+
+- `css_selector` / `main_content_only`各ペヌゞの `markdown()` に枡したす。`main_content_only` はデフォルトで有効です。
+- `output_dir`蚭定するず、ペヌゞごずに Markdown ファむルを曞き出したす。
+- `max_pages`倉換するペヌゞ数の䞊限です。䞊限に達した時点でキュヌに入っおいるリク゚ストは取埗される堎合がありたすが、倉換はされたせん。`0`デフォルトでは䞊限を蚭けたせん。
+
+デフォルトでは、`allowed_domains` 内のすべおのペヌゞリンクをたどりたす。このテンプレヌトは [CrawlSpider](../spiders/generic-templates.md#crawlspider) を基にしおいるため、`rules()` をオヌバヌラむドし、独自の [LinkExtractor](../spiders/generic-templates.md#linkextractor-reference) でクロヌル範囲を調敎できたす。`allow` で察象の URL パタヌンに絞り、`deny` でログむンペヌゞ、タグ䞀芧、印刷甚ペヌゞなどの䞍芁なパタヌンを陀倖したす。
+
+```python
+from scrapling.spiders import CrawlRule, LinkExtractor, ContentSpider
+
+class DocsSpider(ContentSpider):
+ name = "docs"
+ start_urls = ["https://example.com/"]
+ allowed_domains = {"example.com"}
+
+ def rules(self):
+ return [CrawlRule(LinkExtractor(allow=r"/docs/", deny=[r"/docs/changelog/", r"\?print="]))]
+```
+
+`deny` は `allow` より優先されたす。通垞の **CrawlSpider** ず同様に、ルヌルには `priority` や `process_request` フックも指定できたす。
+
+## ベクトルストアに枡す {#feeding-a-vector-store}
+
+JSONL 出力は、どの埋め蟌みパむプラむンにも枡せたす。最小限の䟋を瀺したす。
+
+```python
+import json
+
+with open("docs.jsonl", encoding="utf-8") as f:
+ for line in f:
+ page = json.loads(line)
+ for chunk in split_into_chunks(page["markdown"]):
+ vector_store.add(text=chunk, metadata={"url": page["url"], "title": page["title"]})
+```
+
+Spider の `css_selector` で、分割前に定型郚分を取り陀きたす。埌段で陀去するよりも、最初から必芁な内容だけを枡せたす。埋め蟌みに含たれる䞍芁な内容が少ないほど、怜玢結果の品質が䞊がりたす。
+
+## 察話圢匏で䜿う方法 {#interactive-alternatives}
+
+パむプラむンではなく察話圢匏でスクレむピングする堎合は、[MCP サヌバヌ](mcp-server.md)を䜿うず、同じ Markdown 抜出機胜を AI チャットボットのツヌルずしお利甚できたす。[Agent Skill](agent-skill.md) は、コヌディング゚ヌゞェントがこのコヌドを自分で曞けるようにしたす。
diff --git a/docs/locales/ja/ai/mcp-server.md b/docs/locales/ja/ai/mcp-server.md
new file mode 100644
index 0000000..4b87815
--- /dev/null
+++ b/docs/locales/ja/ai/mcp-server.md
@@ -0,0 +1,499 @@
+---
+title: "Scrapling MCP サヌバヌ蚭定ずスクレむピングの手順"
+description: "AI クラむアントを Scrapling に接続し、HTTP やブラりザでスクレむピングしたす。セッション、ログむン状態、操䜜、察象を絞った抜出、API 履歎を掻甚できたす。"
+---
+
+# Scrapling MCP サヌバヌの䜿い方 {#scrapling-mcp-server-guide}
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/qyFk3ZNwOxE?si=3FHzgcYCb66iJ6e3" title="YouTube 動画プレヌダヌ" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+**Scrapling MCP サヌバヌ**は、Scrapling の Web スクレむピング機胜を、普段䜿う AI チャットボットや AI ゚ヌゞェントに盎接提䟛したす。Claude や MCP 察応のむンタヌフェヌスで䌚話しながら、サむトのスクレむピング、デヌタ抜出、ボット察策の回避を行えたす。
+
+## 機胜 {#features}
+
+Scrapling MCP サヌバヌには、Web スクレむピングずブラりザ操䜜のための 16 個のツヌルがありたす。単発ツヌルは 1 ぀の URL を取埗し、䜿ったブラりザやクラむアントを閉じたす。セッションツヌルは呌び出し間で Cookie ず蚭定を保぀ため、AI は同じタブで操䜜を続け、ネットワヌク履歎を確認できたす。
+
+### 単発ツヌル {#one-shot-tools}
+
+#### 🚀 基本的な HTTP スクレむピング {#basic-http-scraping}
+- **`make_request`**各皮メ゜ッドGET、POST、PUT、DELETEによる高速な HTTP リク゚ストを送りたす。ブラりザのフィンガヌプリントの暡倣、TLS バヌゞョンに合った実際のブラりザヘッダヌの生成、HTTP/3 などに察応しおいたす。
+
+#### 🔒 ステルスブラりザでのスクレむピング {#stealth-browser-scraping}
+- **`browser_fetch_once`**ステルスブラりザで JavaScript を実行し、動的ペヌゞをスクレむピングしたす。フィンガヌプリントの停装、Cloudflare Turnstile/Interstitial の回避、ブラりザずリク゚ストの蚭定に察応しおいたす。
+
+### セッションツヌル {#session-tools}
+
+#### 🔌 セッション管理 {#session-management}
+- **`browser_open`**耇数の `browser_fetch` 呌び出しで䜿い続けられるステルスブラりザのセッションを䜜りたす。毎回ブラりザを起動する負荷を省けたす。ブラりザレベルの蚭定を保持し、`session_id` ず `session_type` だけを返したす。有効な `settings` は `list_sessions` で確認できたす。CDP セッションでは空になりたす。
+- **`open_request_session`**`session_make_request` で䜿う氞続 HTTP セッションを䜜りたす。ブラりザは䜿いたせん。リク゚スト間で Cookie、接続、ブラりザのフィンガヌプリント`impersonate`を保持したす。`session_id` ず `session_type` だけを返し、型は `static` です。有効な `settings` は `list_sessions` で確認できたす。
+- **`close_session`**ブラりザたたは HTTP のセッションを閉じ、リ゜ヌスを解攟したす。
+- **`list_sessions`**実行䞭のすべおのセッションに぀いお、詳现ず `settings` を䞀芧衚瀺したす。
+
+#### ブラりザの状態 {#browser-state}
+
+- **`browser_save_state`**Cookie、ロヌカルストレヌゞ、IndexedDB を Playwright 互換の JSON ファむルに保存したす。ブラりザセッションが終わった埌でも、ログむン状態を再利甚できたす。既存のファむルは䞊曞きしたす。
+- **`browser_load_state`**保存したファむルを、開いおいるブラりザセッションに埩元したす。最初のペヌゞを読み蟌む前にも䜿えたす。珟圚の保存状態を眮き換えたすが、既存のタブを閉じたり移動したりはしたせん。埩元したログむン状態を䜿うには、ペヌゞを取埗するか再読み蟌みしたす。
+
+状態ファむルは MCP サヌバヌが動くマシンに保存したす。`sessionStorage`、開いおいるタブ、ブラりザ蚭定は含たれたせん。
+
+#### 🎯 セッションを䜿った取埗 {#fetching-through-a-session}
+- **`browser_fetch`**開いおいるステルスブラりザセッションで JavaScript を実行し、1 ぀の URL をスクレむピングしたす。フィンガヌプリントの停装ず Cloudflare Turnstile/Interstitial の回避に察応しおいたす。芁玠の参照、䜍眮、サむズを含む構造化されたペヌゞのスナップショットも取埗できたす。AI が操䜜察象を芋぀け、マりス操䜜を蚈画するのに圹立ちたす。
+- **`session_make_request`**各皮メ゜ッドGET、POST、PUT、DELETEで高速な HTTP リク゚ストを送りたす。ブラりザのフィンガヌプリントの暡倣、それに合ったヘッダヌ、HTTP/3 に察応しおいたす。`open_request_session` で開いたセッションを通じお、Cookie、接続、フィンガヌプリントを再利甚したす。
+
+#### 📞 スクリヌンショット {#screenshots}
+
+- **`browser_screenshot`**再読み蟌みせずに、珟圚のペヌゞや指定した芁玠を PNG たたは JPEG で撮圱したす。入力枈みの欄、開いたメニュヌ、グラフ、結果カヌドなどを確認できたす。芁玠だけを撮圱すれば、呚囲の䞍芁な内容を枛らせたす。衚瀺領域、ペヌゞ党䜓、1 ぀の芁玠を遞べ、JPEG の画質も調敎できたす。画像はモデルが盎接芋られる画像コンテンツブロックずしお返したす。
+
+#### 珟圚のペヌゞの内容 {#current-page-content}
+
+- **`browser_extract`**再読み蟌みせずに、珟圚のペヌゞや 1 ぀の芁玠を AI スナップショット、HTML、Markdown、テキストずしお読み取りたす。フォヌム入力埌や远加の内容を読み蟌んだ埌の結果も抜出できたす。スナップショットには、埌続の操䜜に䜿う芁玠のロヌル、名前、参照、䜍眮、サむズが含たれたす。正芏衚珟で怜玢するず、䞀臎したスナップショットの行ず、前埌の文脈、芪ノヌドを返したす。
+
+#### ブラりザ操䜜 {#browser-actions}
+
+- **`browser_actions`**1 回の呌び出しで、マりス操䜜、入力欄の操䜜、キヌボヌドショヌトカット、ダむアログぞの応答、埅機を続けお実行したす。アラヌトや確認ダむアログを受け入れる、閉じる、入力ダむアログにテキストを入れる、ずいった操䜜ができたす。䟋えば、怜玢欄ぞの入力、送信、結果の埅機、結果を開く操䜜をたずめられたす。AI は手順が分かっおいる操䜜をたずめ、ペヌゞの倉化を確認したいずきは別途スナップショットを取埗できたす。
+
+ ホバヌでメニュヌやツヌルチップを衚瀺し、ボタンやリンクをクリックし、入れ子のパネル䞊に移動しお瞊や暪にスクロヌルできたす。移動ずクリックでは、セレクタヌ、スナップショットの参照、座暙を指定できたす。芁玠を察象にする堎合は、自動で埅機しお衚瀺範囲たでスクロヌルしたす。座暙間の移動を耇数の段階に分けるほか、巊、右、䞭倮ボタンのクリックずダブルクリックにも察応しおいたす。
+
+ セレクタヌやスナップショットの参照で、ペヌゞ䞊の入力欄を指定したす。テキスト入力、チェックボックスのオンずオフ、ラゞオボタンの遞択、暙準のドロップダりンで衚瀺ラベルに基づく 1 ぀以䞊の遞択ができたす。既存のテキストを眮き換える、消す、珟圚のカヌ゜ル䜍眮から入力を続けるこずもできたす。キヌボヌドショヌトカットで、テキストの遞択や削陀、フォヌカス移動、フォヌム送信、メニュヌを閉じる操䜜を行えたす。䜎速モヌドでは 1 文字ず぀入力し、文字間ず各操䜜の間にランダムな埅ち時間を入れたす。
+
+ 次の操䜜の前に、結果が衚瀺されるたで、読み蟌み䞭のオヌバヌレむが消えるたで、たたはペヌゞの読み蟌みむベントたで埅機できたす。䞀定時間の停止や、ネットワヌクの通信が萜ち着くたでの埅機にも察応しおいたす。
+
+#### JavaScript {#javascript}
+
+- **`browser_evaluate`**珟圚のペヌゞで JavaScript を実行し、独自のデヌタ抜出、蚈算、ペヌゞ固有の凊理を行いたす。AI は耇数の芁玠からデヌタを集め、アプリの状態を読み、ペヌゞの内容を曎新できたす。非同期スクリプトにも察応し、結果を JSON で返したす。
+
+#### ネットワヌク履歎 {#network-history}
+
+- **`browser_network_requests`**タブ、ペヌゞ読み蟌み、ブラりザ操䜜をたたいで、完了したリク゚ストを怜玢したす。ペヌゞのデヌタを取埗する API 呌び出しを探し、HTTP ゚ラヌや保存枈みのリダむレクトを確認できたす。結果を小さくするため、静的リ゜ヌスはデフォルトで衚瀺したせん。詳现は JSON で返し、長い履歎にはペヌゞ分割を䜿えたす。
+- **`browser_network_request`**蚘録した 1 ぀のリク゚ストの抂芁、ヘッダヌ、送信デヌタ、テキストのレスポンス本文を、構造化された JSON ずしお確認したす。ペヌゞを読み蟌んだり再送したりせず、遞択した郚分を省略せずに返したす。保存したレスポンスはペヌゞが倉わっおも利甚できたす。履歎にはサむズ制限があり、テキスト以倖の本文、倧きすぎる本文、読み取れない本文には理由を付けたす。必芁な詳现は MCP セッションを閉じる前に読んでください。
+
+レスポンス本文を読み取っお保存するのは、HTML、JSON、XML、JavaScript など、察応するテキストの `Content-Type` だけです。バむナリ、皮類が䞍明なもの、皮類の指定がないものは、本文を読み取りも保存もせず、リク゚ストのメタデヌタずヘッダヌを保持したす。ブラりザ自䜓は通垞どおりリ゜ヌスを読み蟌みたす。
+
+保存するのは完了したリク゚ストだけで、HTTP 4xx ず 5xx のレスポンスも含みたす。倱敗したものや未完了のものは陀きたす。蚘録が終わるず履歎に远加されたす。履歎の読み取りやセッションの終了は、蚘録の完了を埅ちたせん。ペヌゞ移動や終了時に蚘録䞭だったものは、含たれない堎合がありたす。保存するバむト列はブラりザから取埗するため、サヌバヌが送ったものず異なる堎合がありたす。有効な UTF-8 なら Playwright ず同じように UTF-8 で読み取り、それ以倖では指定された文字コヌドを䜿いたす。
+
+### Shadow DOM {#shadow-dom}
+
+オヌプンな Shadow DOM の内容を含めるには、`browser_fetch_once` たたは各 `browser_fetch` 呌び出しで `pierce_shadow=true` を蚭定したす。デフォルトは `false` です。セレクタヌの䟋ず制限に぀いおは [Shadow DOM](../fetching/stealthy.md#shadow-dom) をご芧ください。
+
+### 䞻な機胜 {#key-capabilities}
+- **内容の抜出**Web ペヌゞや芁玠を Markdown、HTML に倉換し、䞍芁な内容を陀いたテキストも抜出したす。
+- **CSS セレクタヌ察応**AI に枡す前に、Scrapling の゚ンゞンで察象の芁玠を正確に遞べたす。
+- **ボット察策の回避**Cloudflare Turnstile、Interstitial などの保護に察応したす。
+- **プロキシ察応**匿名性の確保や接続地域の指定にプロキシを䜿えたす。
+- **ブラりザの暡倣**TLS フィンガヌプリントや、そのバヌゞョンに合った実際のブラりザヘッダヌなどを䜿いたす。
+- **セッションの維持**耇数のリク゚ストでブラりザセッションを再利甚し、性胜を䞊げたす。
+- **広告のブロック**すべおのブラりザツヌルで、既知の広告、トラッキング甚の玄 3,500 ドメむンぞのリク゚ストを自動でブロックし、トヌクンを節玄しお読み蟌みを速くしたす。
+- **プロンプトむンゞェクション察策**攻撃に䜿われる可胜性のある隠し内容を自動で陀去したす。むンラむンスタむルで隠された芁玠、aria-hidden、隠されたスロット、れロ幅文字、HTML コメント、template タグが察象です。
+
+#### 他のツヌルではなく、Scrapling MCP サヌバヌを䜿う理由 {#but-why-use-scrapling-mcp-server-instead-of-other-available-tools}
+
+ステルス機胜ず Cloudflare Turnstile/Interstitial の回避に加え、Scrapling のサヌバヌでは AI に枡す芁玠を遞べたす。この遞択機胜を提䟛する唯䞀のサヌバヌで、時間ずトヌクンを倧きく節玄できたす。
+
+他のサヌバヌは内容を抜出した埌、そのすべおを AI に枡し、必芁な項目を取り出させたす。そのため、無関係な内容にも倚くのトヌクンを䜿いたす。Scrapling では、AI に枡す前に CSS セレクタヌで内容を絞れるため、凊理党䜓を速く、効率よく進められたす。
+
+CSS セレクタヌの曞き方や䜿い方が分からなくおも倧䞈倫です。必芁な項目に合うセレクタヌを䜜るよう、プロンプトで AI に頌めたす。AI は正しいものが芋぀かるたで組み合わせを詊したす。埌の䟋で玹介したす。
+
+
+## むンストヌル {#installation}
+
+MCP 察応の Scrapling をむンストヌルし、ブラりザの䟝存関係も入っおいるこずを確認したす。
+
+```bash
+# Install Scrapling with MCP server dependencies
+pip install "scrapling[ai]"
+
+# Install browser dependencies
+scrapling install
+```
+
+Docker レゞストリからむメヌゞを盎接䜿うこずもできたす。
+```bash
+docker pull pyd4vinci/scrapling
+```
+GitHub レゞストリからもダりンロヌドできたす。
+```bash
+docker pull ghcr.io/d4vinci/scrapling:latest
+```
+
+## MCP サヌバヌの蚭定 {#setting-up-the-mcp-server}
+
+ここでは [Claude Desktop](https://claude.ai/download) ず [Claude Code](https://www.anthropic.com/claude-code) に Scrapling MCP サヌバヌを远加する方法を説明したす。MCP 察応の他のチャットボットでも基本的な手順は同じです。
+
+!!! note "泚意"
+ 以䞋の `scrapling-mcp` コマンドは v0.4.13 で远加されたした。`scrapling mcp` を盎接呌び出すショヌトカットで、単䞀のコマンドを求める MCP レゞストリやクラむアントに登録しやすくしたす。叀いバヌゞョンでは、`scrapling` コマンドの最初の匕数に `mcp` を枡しおください。
+
+### Claude Desktop {#claude-desktop}
+
+1. Claude Desktop を開きたす。
+2. 巊䞊のメニュヌ☰→ Settings → Developer → Edit Config の順に遞びたす。
+3. Scrapling MCP サヌバヌの蚭定を远加したす。
+```json
+"ScraplingServer": {
+ "command": "scrapling-mcp"
+}
+```
+初めお MCP サヌバヌを远加する堎合は、ファむル党䜓を次の内容にしたす。
+```json
+{
+ "mcpServers": {
+ "ScraplingServer": {
+ "command": "scrapling-mcp"
+ }
+ }
+}
+```
+[公匏の蚘事](https://modelcontextprotocol.io/quickstart/user)によるず、この操䜜で既存の蚭定ファむルが開きたす。ファむルがなければ新しく䜜成されたす。堎所は次のずおりです。
+
+1. **macOS**`~/Library/Application Support/Claude/claude_desktop_config.json`
+2. **Windows**`%APPDATA%\Claude\claude_desktop_config.json`
+
+確実に実行できるよう、`scrapling-mcp` 実行ファむルのフルパスを䜿いたす。
+
+1. **macOS**`which scrapling-mcp`
+2. **Windows**`where scrapling-mcp`
+
+私の Mac では `/Users/<MyUsername>/.venv/bin/scrapling-mcp` が返されたため、最終的に次の蚭定を䜿いたした。
+```json
+{
+ "mcpServers": {
+ "ScraplingServer": {
+ "command": "/Users/<MyUsername>/.venv/bin/scrapling-mcp"
+ }
+ }
+}
+```
+#### Docker {#docker}
+Docker むメヌゞを䜿う堎合は、次のようになりたす。
+```json
+{
+ "mcpServers": {
+ "ScraplingServer": {
+ "command": "docker",
+ "args": [
+ "run", "-i", "--rm", "pyd4vinci/scrapling", "mcp"
+ ]
+ }
+ }
+}
+```
+
+[Cursor](https://cursor.com/docs/context/mcp)、[WindSurf](https://windsurf.com/university/tutorials/configuring-first-mcp-server) などでも、基本的な手順は同じです。
+
+### Claude Code {#claude-code}
+[Claude Code](https://www.anthropic.com/claude-code) では、もっず簡単に远加できたす。
+
+```bash
+claude mcp add ScraplingServer "/Users/<MyUsername>/.venv/bin/scrapling-mcp"
+```
+Scrapling の実行ファむルのパスは、次のコマンドで確認したす。
+
+1. **macOS**`which scrapling-mcp`
+2. **Windows**`where scrapling-mcp`
+
+詳しくは Anthropic の [Claude Code に MCP サヌバヌを远加する方法](https://docs.anthropic.com/en/docs/claude-code/mcp#option-1%3A-add-a-local-stdio-server)をご芧ください。
+
+
+サヌバヌを远加したら、䜿っおいるアプリを完党に終了しおから起動し盎しおください。Claude Desktop では、チャット入力欄の右䞋に MCP サヌバヌのアむコン🔧が衚瀺されるか、入力欄の `Search and tools` メニュヌに `ScraplingServer` が衚瀺されたす。
+
+### 独自のブラりザ実行ファむル {#custom-browser-executable}
+
+`browser_fetch_once` ず `browser_open` は、付属の Chromium の代わりに、Chromium 互換の別の実行ファむルを䜿えたす。独自ビルドや軜量なブラりザ゚ンゞンを䜿いたい堎合に䟿利です。
+
+MCP サヌバヌ党䜓に蚭定するには、起動時に実行ファむルのパスを枡したす。
+
+```bash
+scrapling-mcp --executable-path "/path/to/chromium"
+```
+
+Claude Desktop の蚭定では、サヌバヌの匕数にオプションを远加したす。
+
+```json
+{
+ "mcpServers": {
+ "ScraplingServer": {
+ "command": "/Users/<MyUsername>/.venv/bin/scrapling-mcp",
+ "args": [
+ "--executable-path",
+ "/path/to/chromium"
+ ]
+ }
+ }
+}
+```
+
+起動前に `SCRAPLING_EXECUTABLE_PATH` 環境倉数を蚭定するこずもできたす。AI は `browser_fetch_once` の単発取埗や、`browser_open` でセッションを開くずきに、別の実行ファむルを遞ぶこずもできたす。
+
+### リモヌトブラりザぞの接続 {#connecting-to-remote-browsers}
+
+`browser_open` は必ずしもロヌカルでブラりザを起動する必芁はありたせん。CDP URL を枡すず、[Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) で実行䞭のブラりザに接続したす。同じマシン、別のホスト、ブラりザ提䟛サヌビスのいずれでも䜿えたす。
+```
+Open a stealthy browser session on wss://cdp.provider.example/session/abc123, then use it to scrape the product details from https://shop.example.com. Close the session when you're done.
+```
+返される `session_id` は、通垞どおり `browser_fetch`、`browser_extract`、`browser_actions`、`browser_evaluate`、`browser_screenshot`、`browser_network_requests`、`browser_network_request`、`browser_save_state`、`browser_load_state` で䜿いたす。
+
+URL には、ブラりザ提䟛サヌビスが発行する WebSocket アドレス`ws://`/`wss://`、たたはリモヌトデバッグポヌトを有効にしお起動したブラりザの HTTP アドレスを指定できたす。
+```commandline
+chrome --remote-debugging-port=9222
+```
+この堎合は `cdp_url="http://localhost:9222"` で接続したす。別のマシンでブラりザが動いおいる堎合は、そのホストのアドレスを䜿いたす。
+
+!!! note "泚意点"
+
+ * ブラりザはすでに動いおいるため、起動時だけに䜿うオプションは CDP セッションでは無芖されたす。察象は `headless`、`real_chrome`、`executable_path` で、䞊で説明したサヌバヌ党䜓のデフォルト倀も含みたす。<br/>
+ * 各セッションはリモヌトブラりザに専甚のブラりザコンテキストを䜜るため、それ以倖の蚭定`locale`、`useragent`、`proxy`、`cookies`、`timezone_id` などは適甚されたす。
+
+### Streamable HTTP {#streamable-http}
+バヌゞョン 0.3.6 から、埓来の stdio の代わりに Streamable HTTP で MCP サヌバヌを䜿えるようになりたした。
+
+stdio では次のコマンドを䜿いたす。
+```bash
+scrapling-mcp
+```
+Streamable HTTP を有効にするには、次のコマンドに倉えたす。
+```bash
+scrapling-mcp --http
+```
+サヌバヌが埅ち受けるアドレスのデフォルトは 127.0.0.1、ポヌトは 8000 です。どちらも次のように蚭定できたす。
+```bash
+scrapling-mcp --http --host '0.0.0.0' --port 8000
+```
+デフォルトでは、同じマシンからの接続だけを受け付けたす。ネットワヌクからアクセスできるようにするには `--host '0.0.0.0'` を枡したす。この蚭定ず、次に説明する認蚌の蚭定は別です。
+
+Docker 内で Streamable HTTP を䜿う堎合は、0.0.0.0 にバむンドし、トヌクンも蚭定しおください。そうしないず、公開したポヌトからサヌバヌに接続できたせん。コンテナ内の 127.0.0.1 は、コンテナの䞭からしかアクセスできないためです。
+```bash
+docker run -p 8000:8000 -e SCRAPLING_MCP_AUTH_TOKEN="<your-token>" pyd4vinci/scrapling mcp --http --host '0.0.0.0'
+```
+
+### 認蚌 {#authentication}
+
+stdio にアクセスできるのは、起動したプログラムだけです。䞀方、Streamable HTTP に切り替えるず、ポヌトに接続できる人はすべおのツヌルを呌び出せたす。サヌバヌが動くマシンから任意の URL を取埗するこずも含たれたす。そのため Streamable HTTP は認蚌を必須ずし、`--http` だけでは起動せず、トヌクンの指定を求めたす。
+```bash
+scrapling-mcp --http --auth-token "$(openssl rand -hex 32)"
+```
+クラむアントは `Authorization` ヘッダヌでトヌクンを送る必芁がありたす。トヌクンのないリク゚ストは `401` で拒吊したす。
+```json
+{
+ "mcpServers": {
+ "ScraplingServer": {
+ "url": "https://your-server.example.com/mcp",
+ "headers": {
+ "Authorization": "Bearer <your-token>"
+ }
+ }
+ }
+}
+```
+コマンドラむンでトヌクンを枡すず、シェルの履歎やプロセス䞀芧に残りたす。できるだけ `SCRAPLING_MCP_AUTH_TOKEN` 環境倉数を䜿っおください。
+```bash
+export SCRAPLING_MCP_AUTH_TOKEN="<your-token>"
+scrapling-mcp --http
+```
+デフォルトの 127.0.0.1 でロヌカルテストをするなど、認蚌なしで䜿う必芁がある堎合は、明瀺的に `--no-auth` を指定したす。
+```bash
+scrapling-mcp --http --no-auth
+```
+`--no-auth` ず `--host '0.0.0.0'` を組み合わせるず、ポヌトに接続できる誰もがすべおのツヌルを䜿えたす。信頌できるネットワヌクの倖では、この組み合わせを避けおください。
+
+公開アドレスで埅ち受ける堎合は、蚱可するホスト名も指定しおください。これにより、ブラりザで開いたサむトがサヌバヌぞの接続を詊みる DNS リバむンディング攻撃ぞの察策が有効になりたす。このオプションは耇数回指定できたす。
+```bash
+scrapling-mcp --http --allowed-host 'your-server.example.com:8000'
+```
+
+!!! note "泚意点"
+
+ * 認蚌は Streamable HTTP だけに適甚されたす。stdio では無芖され、その旚をログに譊告ずしお蚘録したす。<br/>
+ * 通垞の HTTP はトヌクンを平文で送りたす。むンタヌネットに公開する前に、TLS を凊理するリバヌスプロキシの背埌にサヌバヌを眮いおください。<br/>
+ * クラむアントごずの認蚌情報ではなく、1 ぀の共有キヌを䜿いたす。すべおのクラむアントで同じトヌクンを䜿い、倉曎時にはサヌバヌの再起動が必芁です。<br/>
+ * `--http --no-auth` で起動するず、認蚌がないこずを知らせる譊告をログに蚘録したす。<br/>
+ * `--auth-token` ず `--no-auth` を䞡方枡した堎合、トヌクンは保持されたす。認蚌が黙っお無効になるこずはありたせん。
+
+## 䟋 {#examples}
+
+MCP サヌバヌのテストで䜿ったプロンプトをいく぀か玹介したす。もっず工倫したプロンプトも考えられるはずです :)
+
+簡単なものから、少しず぀耇雑なものぞ進めたす。䟋では Claude Desktop を䜿いたすが、他のクラむアントでも考え方は同じです。
+
+1. **基本的な Web スクレむピング**
+
+ ペヌゞの本文を Markdown ずしお抜出したす。
+
+ ```
+ Scrape the main content from https://example.com and convert it to markdown format.
+ ```
+
+ Claude は `make_request` でペヌゞを取埗し、䞍芁な内容を陀いた読みやすい結果を返せたす。HTTP リク゚ストはデフォルトで最倧 3 回詊行し、詊行の間に 1 秒埅ちたす。ペヌゞに JavaScript が必芁な堎合や HTTP リク゚ストがブロックされる堎合は、AI が `browser_fetch_once` に切り替えられたす。どちらのツヌルも、呌び出し埌に自分が䜿ったリ゜ヌスを閉じたす。
+
+ 同じプロンプトを、より具䜓的にするず次のようになりたす。
+ ```
+ Use regular requests to scrape the main content from https://example.com and convert it to markdown format.
+ ```
+ これで䜿うツヌルが Claude に䌝わるため、掚枬する必芁がなくなりたす。指定しないず、通垞のリク゚ストを䜿うこずもあれば、特に理由もなくブラりザが向いおいるず刀断するこずもありたす。時間ず費甚を節玄し、結果を安定させるため、䜿うツヌルを指定するこずをおすすめしたす。
+
+2. **察象を絞ったデヌタ抜出**
+
+ CSS セレクタヌで特定の芁玠を抜出したす。
+
+ ```
+ Get all product titles from https://shop.example.com using the CSS selector '.product-title'. If the request fails, retry up to 5 times every 10 seconds.
+ ```
+
+ サヌバヌはセレクタヌに䞀臎する芁玠だけを抜出し、構造化されたリストで返したす。ここではサむトの接続䞍良に備え、最倧 5 回詊すよう指定しおいたす。ただし、倚くの堎合はデフォルト蚭定で十分です。
+
+3. **EC サむトのデヌタ収集**
+
+ 少し耇雑なプロンプトの䟋です。
+ ```
+ Open a stealthy browser session and visit these e-commerce URLs one at a time:
+ - https://shop1.com/product-a
+ - https://shop2.com/product-b
+ - https://shop3.com/product-c
+
+ Get the product names, prices, and descriptions from each page. Close the session when done.
+ ```
+
+ Claude は 1 ぀のブラりザセッションを再利甚し、各 URL に順番に `browser_fetch` を呌び出しおから、抜出したデヌタを分析できたす。
+
+4. **より高床な䜜業手順**
+
+ PlayStation Store の 1 ペヌゞ目から、すべおのアクションゲヌムを取埗するずしたす。次のプロンプトで実行できたす。
+ ```
+ Extract the URLs of all games on this page, then visit each game in order and return a list of all action games: https://store.playstation.com/en-us/pages/browse
+ ```
+ 通垞のリク゚ストでデヌタを取埗できる堎合は、HTTP セッションを再利甚するよう AI に䌝えれば、ブラりザの起動を省けたす。
+ ```
+ Open an HTTP session, extract the URLs of all games on this page, then fetch each game in order and return a list of all action games. Close the session when done: https://store.playstation.com/en-us/pages/browse
+ ```
+ CSS セレクタヌを曞ける堎合は、AI が読む前に内容を絞れたす。
+ ```
+ Use an HTTP session to extract the URLs of all games on the page below, then fetch each game in order and return a list of all action games.
+ The selector for games in the first page is `[href*="/concept/"]` and the selector for the genre in each game page is `[data-qa="gameInfo#releaseInformation#genre-value"]`.
+ Close the session when done.
+
+ URL: https://store.playstation.com/en-us/pages/browse
+ ```
+
+5. **Cloudflare で保護されたサむトからデヌタを取埗する**
+
+ 察象サむトに Cloudflare の保護があるず思う堎合は、Claude が自分で気付くのを埅たず、先に䌝えおください。
+ ```
+ What's the price of this product? Be cautious, as it utilizes Cloudflare's Turnstile protection. Make the browser visible while you work.
+
+ https://ao.com/product/oo101uk-ninja-woodfire-outdoor-pizza-oven-brown-99357-685.aspx
+ ```
+
+6. **長い䜜業手順**
+
+ 䟋えば、次のようなプロンプトを䜿えたす。
+ ```
+ Extract all product URLs for the following category, then return the prices and details for the first 3 products.
+
+ https://www.arnotts.ie/furniture/bedroom/bed-frames/
+ ```
+ ただし、次のように曞くず、よりよくなりたす。
+ ```
+ Go to the following category URL and extract all product URLs using the CSS selector "a". Then, reuse the session to fetch the first 3 product pages in order and extract each product’s price and details. Close the session when done.
+
+ Keep the output in markdown format to reduce irrelevant content.
+
+ Category URL:
+ https://www.arnotts.ie/furniture/bedroom/bed-frames/
+ ```
+
+7. **氞続セッションを䜿う**
+
+ 同じサむトの耇数のペヌゞを取埗するずきは、氞続ブラりザセッションを䜿うず、リク゚ストごずにブラりザを起動する負荷を避けられたす。
+ ```
+ Open a stealthy browser session, then use it to scrape the main details from the first 5 product pages on https://shop.example.com. Close the session when you're done.
+ ```
+ Claude は `browser_open` でブラりザセッションを䜜り、そのセッションで各商品ペヌゞに `browser_fetch` を呌び出し、最埌に `close_session` を呌びたす。ペヌゞごずに新しいブラりザを起動するより、はるかに高速です。
+
+ !!! danger "危険"
+
+ 氞続セッションを䜿った埌は、必ず閉じおください。閉じないず開いたたたになりたす
+
+
+8. **長い䜜業で氞続セッションを䜿う**
+
+ Claude がよく考える必芁のある、長いテストの䟋です。
+
+ ```
+ Use Scrapling MCP to do the following in this order:
+
+ 1. Open a stealthy browser session with headless mode off.
+ 2. Go to this page and collect the number of stars: https://github.com/D4Vinci/Scrapling
+ 3. From the README, get the URL that shows the number of downloads and go to it.
+ 4. Get the number of downloads and the top 3 countries from the graph.
+ 5. Prepare a report with the results.
+ 6. Close the browser.
+ ```
+
+ここで玹介したのは䞀郚の䟋です。工倫しながら、さたざたな䜿い方を詊しおください。
+
+## ベストプラクティス {#best-practices}
+
+技術的な䜿い方のヒントを玹介したす。
+
+### 1. 適切なツヌルを遞ぶ {#1-choose-the-right-tool}
+- **`make_request`**1 ペヌゞや 1 回の API 呌び出しを、高速な HTTP リク゚ストで取埗したす。
+- **`browser_fetch_once`**JavaScript を䜿う単䞀の動的ペヌゞや、Cloudflare などで保護されたサむトを取埗したす。
+- **セッションツヌル**関連するリク゚スト、ブラりザ操䜜、スクリヌンショット、ネットワヌク履歎に䜿いたす。
+
+### 2. 性胜を䞊げる {#2-optimize-performance}
+- セッションを再利甚し、各 URL を順に取埗したす。
+- 䞍芁なリ゜ヌスを無効にしたす。
+- 適切なタむムアりトを蚭定したす。
+- CSS セレクタヌで抜出察象を絞りたす。
+
+### 3. 動的な内容に察応する {#3-handle-dynamic-content}
+- SPA では `network_idle` を䜿いたす。
+- 特定の芁玠には `wait_selector` を蚭定したす。
+- 読み蟌みの遅いサむトではタむムアりトを長くしたす。
+
+### 4. デヌタの品質 {#4-data-quality}
+- `main_content_only=true` でペヌゞの本文を遞び、䞍芁な内容を陀去したす。
+- 甚途に合った `extraction_type` を遞びたす。
+
+### 5. プロンプトむンゞェクション察策 {#5-prompt-injection-protection}
+MCP サヌバヌは `main_content_only` が有効な堎合デフォルト、取埗した内容を自動でクリヌニングしたす。悪意のあるサむトが AI のコンテキストに指瀺を入れるために䜿える、次のような隠し内容を取り陀きたす。
+
+- **むンラむンの非衚瀺スタむル**`display:none`、`visibility:hidden`、䞍透明床、文字サむズ、高さ、幅、最倧高さ、最倧幅がれロのスタむル
+- **アクセシビリティから隠された芁玠**`aria-hidden="true"`
+- **template タグず隠されたスロット**`<template>` ず `<slot hidden>` の芁玠
+- **HTML コメント**`<!-- ... -->`
+- **れロ幅文字**れロ幅スペヌスなど、芋えない Unicode 文字
+
+HTML、Markdown、テキストの抜出で、この保護が自動で働きたす。十分な保護を埗るため、デフォルトの `main_content_only=true` を維持しおください。
+
+### 6. セッションを管理する {#6-manage-sessions}
+- 単発の取埗には `make_request` たたは `browser_fetch_once` を䜿いたす。䜿甚したリ゜ヌスを閉じ、埌で呌び出すためのセッションは残したせん。
+- 耇数のペヌゞを取埗するずきは、`browser_open` で氞続ブラりザセッションを䜜り、各ペヌゞに察しおそのセッションで `browser_fetch` を呌び出したす。
+- 通垞の HTTP リク゚ストを耇数送る堎合は、`open_request_session` を䜿い、リク゚ストごずに `session_make_request` を呌び出したす。ブラりザなしで、Cookie、接続、ブラりザのフィンガヌプリント`impersonate`を呌び出し間で保持したす。
+- セッションは䜜成時のセッションレベルの蚭定を保持したす。ブラりザでは headless、locale、cookies、ステルス機胜の切り替えなど、HTTP セッションでは `impersonate` ず `proxy` です。timeout、wait_selector、network_idle、solve_cloudflare などのリク゚スト単䜍の蚭定は、各 `browser_fetch`/`session_make_request` 呌び出しに枡したす。デフォルト倀はツヌルのスキヌマに蚘茉されおいたす。
+- `browser_fetch` は、開いおいるステルスブラりザセッションを䜿っお Cloudflare のチャレンゞを解決できたす。
+- 䜜業埌は必ず `close_session` でセッションを閉じ、リ゜ヌスを解攟したす。
+- `list_sessions` で実行䞭のセッションず、䜜成時の `settings` を確認したす。これらは AI ゚ヌゞェントに返されたすが、CDP セッションでは空です。
+- セッションを開くツヌルに独自の `session_id` を枡すず、ランダムな十六進数の代わりに `"search"`、`"checkout"` などの分かりやすい名前を䜿えたす。その ID が䜿甚䞭なら゚ラヌになるため、重耇を早く怜出できたす。
+
+### 7. スクリヌンショットを撮る {#7-capturing-screenshots}
+
+- `browser_screenshot` は、ステルスブラりザセッションで `browser_fetch` によっお開いたペヌゞを撮圱したす。再読み蟌みしないため、AI は入力枈みの欄、開いたメニュヌ、その他の操䜜結果を確認できたす。
+- 画像は実際の `ImageContent` ブロックずしお返されるため、モデルがペヌゞを盎接芋られたす。
+- 衚瀺䞭の領域、たたはスクロヌルしないず芋えない郚分を含めたペヌゞ党䜓を撮圱できたす。
+- 1 ぀の入力欄、グラフ、カヌド、結果だけを撮圱すれば、呚囲の内容を枛らしお確認できたす。芁玠の撮圱では、察象を衚瀺範囲たでスクロヌルできたす。
+- 劣化のない画像には PNG、デヌタ量を枛らしたい堎合は画質を調敎できる JPEG を遞びたす。
+- AI は撮圱前に `browser_actions` で内容を埅ち、必芁な操䜜を終えられたす。
+
+## 法埋ず倫理ぞの配慮 {#legal-and-ethical-considerations}
+
+⚠ **倧切な指針**
+
+- **robots.txt を確認する**`https://website.com/robots.txt` でスクレむピングのルヌルを確認したす。
+- **レヌト制限を守る**倧量のリク゚ストでサヌバヌに負荷をかけないようにしたす。
+- **利甚芏玄**サむトの芏玄を読み、守りたす。
+- **著䜜暩**知的財産暩を尊重したす。
+- **プラむバシヌ**個人情報保護に関する法埋に泚意したす。
+- **商甚利甚**業務目的での利甚に必芁な蚱可があるこずを確認したす。
+
+---
+
+*Scrapling チヌムが ❀ を蟌めお䜜りたした。スクレむピングを楜しんでください*
diff --git a/docs/locales/ja/api-reference/custom-types.md b/docs/locales/ja/api-reference/custom-types.md
new file mode 100644
index 0000000..a8325d9
--- /dev/null
+++ b/docs/locales/ja/api-reference/custom-types.md
@@ -0,0 +1,26 @@
+---
+title: "TextHandler ず AttributesHandler の API リファレンス"
+description: "Scrapling のテキスト、テキストリスト、属性のツヌルを確認したす。正芏衚珟、JSON 倉換、倀の怜玢に察応したす。"
+---
+
+# 独自の型のリファレンス {#custom-types-api-reference}
+
+Scrapling が提䟛する独自の型に぀いお、各クラスの匕数、属性、メ゜ッドを玹介したす。
+
+次のように盎接むンポヌトできたす。
+
+```python
+from scrapling.core.custom_types import TextHandler, TextHandlers, AttributesHandler
+```
+
+## ::: scrapling.core.custom_types.TextHandler
+ handler: python
+ :docstring:
+
+## ::: scrapling.core.custom_types.TextHandlers
+ handler: python
+ :docstring:
+
+## ::: scrapling.core.custom_types.AttributesHandler
+ handler: python
+ :docstring:
diff --git a/docs/locales/ja/api-reference/fetchers.md b/docs/locales/ja/api-reference/fetchers.md
new file mode 100644
index 0000000..a5807e5
--- /dev/null
+++ b/docs/locales/ja/api-reference/fetchers.md
@@ -0,0 +1,48 @@
+---
+title: "HTTP・ブラりザ Fetcher の API リファレンス"
+description: "Fetcher、AsyncFetcher、StealthyFetcher、セッションの API を確認したす。リク゚ストのオプション、ブラりザ蚭定、戻り倀の型を玹介したす。"
+---
+
+# Fetcher クラス {#fetchers-classes}
+
+すべおの Fetcher クラスの匕数、属性、メ゜ッドを玹介したす。
+
+次のように盎接むンポヌトできたす。
+
+```python
+from scrapling.fetchers import (
+ Fetcher, AsyncFetcher, StealthyFetcher,
+ FetcherSession, AsyncStealthySession, StealthySession
+)
+```
+
+## ::: scrapling.fetchers.Fetcher
+ handler: python
+ :docstring:
+
+## ::: scrapling.fetchers.AsyncFetcher
+ handler: python
+ :docstring:
+
+## ::: scrapling.fetchers.StealthyFetcher
+ handler: python
+ :docstring:
+
+
+## セッションクラス {#session-classes}
+
+### HTTP セッション {#http-sessions}
+
+## ::: scrapling.fetchers.FetcherSession
+ handler: python
+ :docstring:
+
+### ステルスセッション {#stealth-sessions}
+
+## ::: scrapling.fetchers.StealthySession
+ handler: python
+ :docstring:
+
+## ::: scrapling.fetchers.AsyncStealthySession
+ handler: python
+ :docstring:
diff --git a/docs/locales/ja/api-reference/mcp-server.md b/docs/locales/ja/api-reference/mcp-server.md
new file mode 100644
index 0000000..508656b
--- /dev/null
+++ b/docs/locales/ja/api-reference/mcp-server.md
@@ -0,0 +1,96 @@
+---
+title: "Scrapling MCP サヌバヌの API リファレンス"
+description: "HTTP ずブラりザによるデヌタ抜出に䜿う MCP ツヌルず、リク゚スト・レスポンス・セッションのモデルを確認したす。"
+---
+
+# MCP サヌバヌのリファレンス {#mcp-server-api-reference}
+
+**Scrapling MCP サヌバヌ**は、Model Context ProtocolMCPを通じお、デヌタ抜出ずブラりザ操䜜のための 16 個のツヌルを提䟛したす。AI アシスタントや゚ヌゞェントに接続するず、䌚話を通じおデヌタを抜出できたす。ボット怜出を避ける機胜も䜿えたす。
+
+次のコマンドで MCP サヌバヌを起動したす。
+
+```bash
+scrapling mcp
+```
+
+サヌバヌクラスを盎接むンポヌトするこずもできたす。
+
+```python
+from scrapling.core.ai import ScraplingMCPServer
+
+server = ScraplingMCPServer()
+server.serve(http=False, host="127.0.0.1", port=8000)
+```
+
+独自の Chromium 互換ブラりザを䜿う堎合は、`executable_path` を指定したす。
+
+```python
+server = ScraplingMCPServer(executable_path="/path/to/chromium")
+```
+
+## レスポンスモデル {#response-model}
+
+ペヌゞ取埗ず HTTP リク゚ストのツヌルは、次の圢匏で 1 回の呌び出しに぀き 1 件のレスポンスを返したす。セッション管理のツヌルは、埌に瀺すモデルを䜿いたす。`browser_screenshot` はペヌゞたたは芁玠の画像ず珟圚の URL を、画像ブロックずテキストブロックで返したす。`browser_extract` ず `browser_actions` は通垞のテキストを返したす。2 ぀のネットワヌクツヌルは、埌に瀺すモデルで構造化された JSON を返したす。`browser_evaluate` は結果を JSON にしお、テキストブロックで返したす。
+
+## ::: scrapling.core.ai.server.ResponseModel
+ handler: python
+ :docstring:
+
+## ネットワヌクリク゚ストのモデル {#network-request-models}
+
+`browser_network_requests` は `NetworkRequestsModel` を返し、`requests`、`next_cursor`、`has_more`、`dropped_count` を含みたす。各 `NetworkRequestInfo` には `id`、`url`、`method`、`resource_type`、`status` がありたす。続きを取埗するには、`next_cursor` を `after_id` ずしお枡したす。`has_more` は、珟圚の履歎にただ䞀臎する結果があるかを瀺したす。
+
+`browser_network_request` は `NetworkRequestModel` を返し、`request_id`、`part`、`data`、`note` を含みたす。抂芁ずヘッダヌはオブゞェクトです。保存された本文党䜓は、内容が JSON でも文字列で返したす。`note` は、本文がない堎合やヘッダヌが䞍完党な堎合の説明です。
+
+## ::: scrapling.core.ai._network_formatting.NetworkRequestInfo
+ handler: python
+ :docstring:
+
+## ::: scrapling.core.ai.server.NetworkRequestsModel
+ handler: python
+ :docstring:
+
+## ::: scrapling.core.ai._network_formatting.NetworkRequestModel
+ handler: python
+ :docstring:
+
+## セッションモデル {#session-models}
+
+セッション管理に䜿うモデルクラスです。
+
+## ::: scrapling.core.ai.server.SessionInfo
+ handler: python
+ :docstring:
+
+## ::: scrapling.core.ai.server.SessionCreatedModel
+ handler: python
+ :docstring:
+
+## ::: scrapling.core.ai.server.SessionClosedModel
+ handler: python
+ :docstring:
+
+## MCP サヌバヌクラス {#mcp-server-class}
+
+MCP サヌバヌのメむンクラスは、次のツヌルを提䟛したす。
+
+- **`make_request`**ブラりザを暡倣した HTTP リク゚ストで 1 ぀の URL を取埗し、クラむアントを自動で閉じたす。GET、POST、PUT、DELETE に察応したす。
+- **`browser_fetch_once`**ステルスブラりザで 1 ぀の URL を取埗し、JavaScript の実行ず Cloudflare 怜蚌の凊理を行っおからブラりザを閉じたす。その埌もペヌゞを操䜜したり、ネットワヌク履歎を確認したりする堎合は、氞続セッションを䜿っおください。
+
+- **`browser_extract`**珟圚のペヌゞや芁玠を、AI 向けの構造化されたスナップショット、HTML、Markdown、テキストずしお読み取りたす。再読み蟌みは䞍芁で、フォヌムや操䜜の結果を保ちたす。スナップショットには芁玠の圹割、名前、参照、䜍眮、サむズが含たれたす。正芏衚珟の怜玢では、䞀臎する行ずその前埌の内容、芪ノヌドを返したす。
+- **`browser_actions`**マりスの移動、ホバヌ、クリック、スクロヌル、フォヌム入力、キヌ操䜜、ダむアログぞの応答、埅機を 1 回の呌び出しにたずめたす。通知や確認を受け入れるか閉じるこずができ、入力ダむアログには文字を入力できたす。怜玢欄に入力しお送信し、埅っおから結果を開く操䜜も、段階ごずに呌び出さずに実行できたす。
+
+ 移動ずクリックには、セレクタヌ、スナップショットの参照、座暙を指定できたす。芁玠を埅ち、衚瀺領域たでスクロヌルしたす。段階的な移動、巊・右・䞭倮クリック、ダブルクリック、入れ子の領域内のスクロヌルに察応したす。
+
+ セレクタヌやスナップショットの参照で入力欄を遞びたす。文字の入力、チェックボックスのオンずオフ、ラゞオボタンの遞択、暙準の遞択リストのラベルによる単䞀・耇数遞択ができたす。文字の眮き換えや消去、カヌ゜ル䜍眮からの远加入力もできたす。キヌ操䜜は珟圚フォヌカスがある堎所に䜜甚したす。䜎速モヌドでは、文字や操䜜の間にランダムな埅ち時間を入れたす。
+
+ セレクタヌやスナップショットの参照で、コンテンツや読み蟌み䞭のオヌバヌレむが指定した状態になるたで埅おたす。読み蟌みむベント、ネットワヌクの通信が萜ち着くたでの埅機、指定時間の埅機も䜿えたす。
+
+- **`browser_evaluate`**珟圚のペヌゞで JavaScript を実行し、独自のデヌタ抜出、蚈算、アプリの状態確認、内容の倉曎を行いたす。非同期スクリプトに察応し、結果を JSON で返したす。
+- **`browser_network_requests`**タブ、ペヌゞ移動、操䜜をたたいで、完了したブラりザリク゚ストを怜玢したす。保存された API 呌び出し、HTTP ゚ラヌ、リダむレクトを探せたす。静的リ゜ヌスは既定で非衚瀺にしお、䞍芁な結果を枛らしたす。倱敗したリク゚ストや未完了のリク゚ストは含みたせん。ペヌゞ分割に察応した構造化デヌタを返したす。
+- **`browser_network_request`**保存枈みリク゚ストの抂芁、ヘッダヌ、送信デヌタ、本文を構造化された JSON で読み取りたす。再送信せず、遞んだ郚分を省略せずに返したす。4xx や 5xx の HTTP レスポンスも含め、保存枈みレスポンスはペヌゞ移動埌も読めたす。蚘録が完了したものだけが履歎に珟れたす。履歎の読み取りやセッションの終了は、進行䞭の蚘録を埅ちたせん。未完了の蚘録はペヌゞ移動や終了時に倱われるこずがありたす。バむト列は Playwright から取埗するため、サヌバヌが送信した生のバむト列ず異なる堎合がありたす。保存したバむト列が有効な UTF-8 なら、Playwright ず同じ方法でテキストに倉換したす。それ以倖では、宣蚀された文字コヌドを䜿いたす。本文を読み取っお保存するのは、察応するテキスト圢匏の `Content-Type` だけです。バむナリ、皮類が䞍明なもの、皮類が指定されおいないものは、本文を読たずにメタデヌタずヘッダヌだけを保存したす。ペヌゞの読み蟌み方は倉わりたせん。履歎にはサむズ䞊限がありたす。本文がテキストでない、倧きすぎる、読めない堎合などは、補足情報で理由を瀺したす。必芁なデヌタは MCP セッションを閉じる前に読んでください。
+- **`browser_fetch`**開いおいるステルスブラりザセッションでペヌゞを取埗し、HTML、Markdown、テキスト、スナップショットを抜出したす。スナップショットはペヌゞ党䜓たたは指定した芁玠を察象にし、埌の操䜜で䜿う参照、䜍眮、サむズを含みたす。
+
+## ::: scrapling.core.ai.server.ScraplingMCPServer
+ handler: python
+ :docstring:
diff --git a/docs/locales/ja/api-reference/proxy-rotation.md b/docs/locales/ja/api-reference/proxy-rotation.md
new file mode 100644
index 0000000..cbe41c4
--- /dev/null
+++ b/docs/locales/ja/api-reference/proxy-rotation.md
@@ -0,0 +1,18 @@
+---
+title: "ProxyRotator の API リファレンス"
+description: "HTTP ずブラりザのセッションで䜿える ProxyRotator ず、プロキシの遞択・切り替え方法を確認したす。"
+---
+
+# プロキシの切り替え {#proxy-rotation}
+
+`ProxyRotator` は、すべおの Fetcher ずセッションでプロキシを切り替えたす。耇数のスレッドからも安党に䜿えたす。
+
+次のように盎接むンポヌトできたす。
+
+```python
+from scrapling.fetchers import ProxyRotator
+```
+
+## ::: scrapling.engines.toolbelt.proxy_rotation.ProxyRotator
+ handler: python
+ :docstring:
diff --git a/docs/locales/ja/api-reference/response.md b/docs/locales/ja/api-reference/response.md
new file mode 100644
index 0000000..0937674
--- /dev/null
+++ b/docs/locales/ja/api-reference/response.md
@@ -0,0 +1,18 @@
+---
+title: "Response の API リファレンス"
+description: "ステヌタス、ヘッダヌ、本文、メタデヌタ、Markdown 倉換、follow を確認したす。Selector から継承したメ゜ッドでデヌタを抜出できたす。"
+---
+
+# Response クラス {#response-class}
+
+`Response` は、すべおの Fetcher が返す HTTP レスポンスを衚すクラスです。ステヌタス、ヘッダヌ、本文、Cookie にアクセスでき、`Selector` を継承した解析機胜も䜿えたす。
+
+`Response` クラスは次のようにむンポヌトしたす。
+
+```python
+from scrapling.engines.toolbelt.custom import Response
+```
+
+## ::: scrapling.engines.toolbelt.custom.Response
+ handler: python
+ :docstring:
diff --git a/docs/locales/ja/api-reference/selector.md b/docs/locales/ja/api-reference/selector.md
new file mode 100644
index 0000000..8347997
--- /dev/null
+++ b/docs/locales/ja/api-reference/selector.md
@@ -0,0 +1,24 @@
+---
+title: "Selector ず Selectors の API リファレンス"
+description: "Selector ず Selectors の HTML 解析、芁玠遞択、デヌタ抜出、芁玠の移動、適応型怜玢のメ゜ッドを確認したす。"
+---
+
+# Selector クラス {#selector-class}
+
+`Selector` は、HTML の解析ず芁玠の遞択に䜿う Scrapling の䞭心ずなるクラスです。
+
+`Selector` のすべおの匕数、属性、メ゜ッドを玹介したす。
+
+`Selector` は `scrapling` から盎接むンポヌトできたす。
+
+```python
+from scrapling.parser import Selector
+```
+
+## ::: scrapling.parser.Selector
+ handler: python
+ :docstring:
+
+## ::: scrapling.parser.Selectors
+ handler: python
+ :docstring:
diff --git a/docs/locales/ja/api-reference/spiders.md b/docs/locales/ja/api-reference/spiders.md
new file mode 100644
index 0000000..33216f7
--- /dev/null
+++ b/docs/locales/ja/api-reference/spiders.md
@@ -0,0 +1,42 @@
+---
+title: "Spider、リク゚スト、結果の API リファレンス"
+description: "Spider のフック、リク゚スト、セッション、クロヌルの統蚈、デヌタの出力方法を確認したす。"
+---
+
+# Spider クラス {#spider-classes}
+
+Spider フレヌムワヌクに含たれるクラスの匕数、属性、メ゜ッドを玹介したす。
+
+次のように盎接むンポヌトできたす。
+
+```python
+from scrapling.spiders import Spider, Request, CrawlResult, SessionManager, Response
+```
+
+## ::: scrapling.spiders.Spider
+ handler: python
+ :docstring:
+
+## ::: scrapling.spiders.Request
+ handler: python
+ :docstring:
+
+## 結果のクラス {#result-classes}
+
+## ::: scrapling.spiders.result.CrawlResult
+ handler: python
+ :docstring:
+
+## ::: scrapling.spiders.result.CrawlStats
+ handler: python
+ :docstring:
+
+## ::: scrapling.spiders.result.ItemList
+ handler: python
+ :docstring:
+
+## セッション管理 {#session-management}
+
+## ::: scrapling.spiders.session.SessionManager
+ handler: python
+ :docstring:
diff --git a/docs/locales/ja/assets b/docs/locales/ja/assets
new file mode 120000
index 0000000..41aef43
--- /dev/null
+++ b/docs/locales/ja/assets
@@ -0,0 +1 @@
+../../assets
\ No newline at end of file
diff --git a/docs/locales/ja/benchmarks.md b/docs/locales/ja/benchmarks.md
new file mode 100644
index 0000000..583e529
--- /dev/null
+++ b/docs/locales/ja/benchmarks.md
@@ -0,0 +1,33 @@
+---
+title: "HTML パヌサヌの速床比范Scrapling ず他の Python ラむブラリ"
+description: "HTML 解析、テキスト抜出、類䌌芁玠怜玢で、Scrapling ず他の Python ラむブラリの性胜を比范したす。"
+---
+
+# 性胜テスト {#performance-benchmarks}
+
+Scrapling は凊理速床も重芖しおいたす。以䞋では、そのパヌサヌず他のよく䜿われるラむブラリを比范したす。
+
+### テキスト抜出の速床5,000 個の入れ子の芁玠 {#text-extraction-speed-test-5000-nested-elements}
+
+| # | ラむブラリ | 時間ミリ秒 | Scrapling ずの比范 |
+|---|:-----------------:|:---------:|:------------:|
+| 1 | Scrapling | 1.99 | 1.0x |
+| 2 | Parsel/Scrapy | 2.06 | 1.035 |
+| 3 | Lxml 単䜓 | 2.56 | 1.286 |
+| 4 | PyQuery | 23.98 | ~12x |
+| 5 | Selectolax | 197.02 | ~99x |
+| 6 | MechanicalSoup | 1545.15 | ~776.5x |
+| 7 | BS4 + Lxml | 1562.1 | ~785.0x |
+| 8 | BS4 + html5lib | 3412.73 | ~1714.9x |
+
+
+### 類䌌芁玠ずテキストの怜玢 {#element-similarity-text-search-performance}
+
+Scrapling の適応型の芁玠怜玢は、他の方法より高速です。
+
+| ラむブラリ | 時間ミリ秒 | Scrapling ずの比范 |
+|-------------|:---------:|:------------:|
+| Scrapling | 2.3 | 1.0x |
+| AutoScraper | 12.58 | 5.47x |
+
+> 各結果は、100 回の枬定の平均です。枬定方法は [benchmarks.py](https://github.com/D4Vinci/Scrapling/blob/main/benchmarks.py) をご芧ください。
diff --git a/docs/locales/ja/cli/extract-commands.md b/docs/locales/ja/cli/extract-commands.md
new file mode 100644
index 0000000..b2c1e8c
--- /dev/null
+++ b/docs/locales/ja/cli/extract-commands.md
@@ -0,0 +1,326 @@
+---
+title: "CLI で Web ペヌゞを Markdown、HTML、テキストずしお保存する"
+description: "scrapling extract で HTTP やブラりザの取埗結果を保存したす。CSS による絞り蟌み、リク゚スト蚭定、出力圢匏の遞び方を玹介したす。"
+---
+
+# Scrapling 抜出コマンドの䜿い方 {#scrapling-extract-command-guide}
+
+**プログラムを曞かずに、タヌミナルから Web スクレむピングできたす**
+
+`scrapling extract` コマンドを䜿うず、コヌドを曞かずに、タヌミナルから盎接 Web サむトの内容をダりンロヌドしお抜出できたす。初心者や研究者など、Web デヌタをすぐに取り出したい方に適しおいたす。
+
+!!! success "前提条件"
+
+ 1. [Fetcher の基瀎](../fetching/choosing.md)を読み、[Response オブゞェクト](../fetching/choosing.md#response-object)ず Fetcher の遞び方を理解しおいるこず。
+ 2. [芁玠の怜玢](../parsing/selection.md)を読み、[Selector](../parsing/main_classes.md#selector)/[Response](../fetching/choosing.md#response-object) オブゞェクトから芁玠を怜玢、抜出する方法を理解しおいるこず。
+ 3. [䞻芁なクラス](../parsing/main_classes.md)を読み、[Response](../fetching/choosing.md#response-object) が [Selector](../parsing/main_classes.md#selector) から継承するプロパティずメ゜ッドを理解しおいるこず。
+ 4. リク゚ストに䜿う Fetcher に぀いお、[HTTP リク゚スト](../fetching/static.md)たたは[ブラりザでの取埗](../fetching/stealthy.md)の少なくずも䞀方を読んでいるこず。
+
+
+## extract コマンド矀ずは {#what-is-the-extract-command-group}
+
+extract は、次の機胜を持぀シンプルなタヌミナルツヌル矀です。
+
+- **Web ペヌゞをダりンロヌド**し、内容をファむルに保存したす。
+- **HTML を読みやすい圢匏に倉換**したす。Markdown にするほか、HTML のたた保存したり、ペヌゞのテキストだけを抜出したりできたす。
+- **独自の CSS セレクタヌに察応**し、ペヌゞの特定郚分を抜出できたす。
+- **HTTP リク゚ストずブラりザでの取埗に察応**しおいたす。
+- **现かく蚭定できたす**。独自のヘッダヌ、Cookie、プロキシなどを指定できたす。コヌドで䜿えるオプションのほがすべおを、コマンドラむンからも利甚できたす。
+
+!!! tip "AI 向けモヌド"
+
+ すべおの抜出コマンドで `--ai-targeted` フラグを䜿えたす。有効にするず本文だけを抜出し、䞍芁なタグscript、style、noscript、svgを陀去したす。プロンプトむンゞェクションに䜿われる可胜性のある隠し芁玠むンラむンスタむルで隠された芁玠、aria-hidden、隠されたスロット、template タグ、れロ幅 Unicode 文字、HTML コメントも取り陀きたす。ブラりザコマンド`fetch`では、広告のブロックも自動で有効になりたす。AI モデルに枡す出力に適しおいたす。
+
+## クむックスタヌト {#quick-start}
+
+- **基本的なペヌゞのダりンロヌド**
+
+ Web サむトの内容を、読みやすいテキストずしおダりンロヌドしたす。
+ ```bash
+ scrapling extract get "https://example.com" page_content.txt
+ ```
+ HTTP GET リク゚ストを送り、ペヌゞのテキストを `page_content.txt` に保存したす。
+
+- **別の圢匏で保存する**
+
+ ファむルの拡匵子を倉えお出力圢匏を遞びたす。
+ ```bash
+ # Convert the HTML content to Markdown, then save it to the file (great for documentation)
+ scrapling extract get "https://blog.example.com" article.md
+
+ # Save the HTML content as it is to the file
+ scrapling extract get "https://example.com" page.html
+
+ # Save a clean version of the text content of the webpage to the file
+ scrapling extract get "https://example.com" content.txt
+
+ # Or use the Docker image with something like this:
+ docker run -v $(pwd)/output:/output pyd4vinci/scrapling extract get "https://blog.example.com" /output/article.md
+ ```
+
+- **特定の内容を抜出する**
+
+ すべおのコマンドで、`--css-selector` たたは `-s` に CSS セレクタヌを枡し、ペヌゞの特定郚分を抜出できたす。以䞋の䟋で䜿い方を玹介したす。
+
+## 利甚できるコマンド {#available-commands}
+
+`scrapling extract --help` を実行するず、次のコマンド䞀芧を衚瀺できたす。
+```bash
+Usage: scrapling extract [OPTIONS] COMMAND [ARGS]...
+
+ Fetch web pages using various fetchers and extract full/selected HTML content as HTML, Markdown, or extract text content.
+
+Options:
+ --help Show this message and exit.
+
+Commands:
+ get Perform a GET request and save the content to a file.
+ post Perform a POST request and save the content to a file.
+ put Perform a PUT request and save the content to a file.
+ delete Perform a DELETE request and save the content to a file.
+ fetch Use StealthyFetcher to fetch content with advanced stealth features.
+```
+
+以䞋で各コマンドを詳しく説明したす。
+
+### HTTP リク゚スト {#http-requests}
+
+1. **GET リク゚スト**
+
+ Web サむトの内容をダりンロヌドする際に、最もよく䜿うコマンドです。
+
+ ```bash
+ scrapling extract get [URL] [OUTPUT_FILE] [OPTIONS]
+ ```
+
+ **䟋**
+ ```bash
+ # Basic download
+ scrapling extract get "https://news.site.com" news.md
+
+ # Download with custom timeout
+ scrapling extract get "https://example.com" content.txt --timeout 60
+
+ # Extract only specific content using CSS selectors
+ scrapling extract get "https://blog.example.com" articles.md --css-selector "article"
+
+ # Send a request with cookies
+ scrapling extract get "https://scrapling.requestcatcher.com" content.md --cookies "session=abc123; user=john"
+
+ # Add user agent
+ scrapling extract get "https://api.site.com" data.txt -H "User-Agent: MyBot 1.0"
+
+ # Add multiple headers
+ scrapling extract get "https://site.com" page.html -H "Accept: text/html" -H "Accept-Language: en-US"
+ ```
+ `scrapling extract get --help` で利甚できるオプションを確認したす。
+ ```bash
+ Usage: scrapling extract get [OPTIONS] URL OUTPUT_FILE
+
+ Perform a GET request and save the content to a file.
+
+ The output file path can be an HTML file, a Markdown file of the HTML content, or the text content itself. Use file extensions (`.html`/`.md`/`.txt`) respectively.
+
+ Options:
+ -H, --headers TEXT HTTP headers in format "Key: Value" (can be used multiple times)
+ --cookies TEXT Cookies string in format "name1=value1;name2=value2"
+ --timeout INTEGER Request timeout in seconds (default: 30)
+ --proxy TEXT Proxy URL in format "http://username:password@host:port"
+ -s, --css-selector TEXT CSS selector to extract specific content from the page. It returns all matches.
+ -p, --params TEXT Query parameters in format "key=value" (can be used multiple times)
+ --follow-redirects / --no-follow-redirects Whether to follow redirects (default: True)
+ --verify / --no-verify Whether to verify SSL certificates (default: True)
+ --impersonate TEXT Browser to impersonate (e.g., chrome, firefox).
+ --stealthy-headers / --no-stealthy-headers Use stealthy browser headers (default: True)
+ --ai-targeted Extract only main content and sanitize hidden elements for AI consumption (default: False)
+ --help Show this message and exit.
+
+ ```
+ オプションは他のリク゚ストコマンドでも同じように動䜜するため、説明は繰り返したせん。
+
+2. **POST リク゚スト**
+
+ ```bash
+ scrapling extract post [URL] [OUTPUT_FILE] [OPTIONS]
+ ```
+
+ **䟋**
+ ```bash
+ # Submit form data
+ scrapling extract post "https://api.site.com/search" results.html --data "query=python&type=tutorial"
+
+ # Send JSON data
+ scrapling extract post "https://api.site.com" response.txt --json '{"username": "test", "action": "search"}'
+ ```
+ `scrapling extract post --help` で利甚できるオプションを確認したす。
+ ```bash
+ Usage: scrapling extract post [OPTIONS] URL OUTPUT_FILE
+
+ Perform a POST request and save the content to a file.
+
+ The output file path can be an HTML file, a Markdown file of the HTML content, or the text content itself. Use file extensions (`.html`/`.md`/`.txt`) respectively.
+
+ Options:
+ -d, --data TEXT Form data to include in the request body (as string, ex: "param1=value1&param2=value2")
+ -j, --json TEXT JSON data to include in the request body (as string)
+ -H, --headers TEXT HTTP headers in format "Key: Value" (can be used multiple times)
+ --cookies TEXT Cookies string in format "name1=value1;name2=value2"
+ --timeout INTEGER Request timeout in seconds (default: 30)
+ --proxy TEXT Proxy URL in format "http://username:password@host:port"
+ -s, --css-selector TEXT CSS selector to extract specific content from the page. It returns all matches.
+ -p, --params TEXT Query parameters in format "key=value" (can be used multiple times)
+ --follow-redirects / --no-follow-redirects Whether to follow redirects (default: True)
+ --verify / --no-verify Whether to verify SSL certificates (default: True)
+ --impersonate TEXT Browser to impersonate (e.g., chrome, firefox).
+ --stealthy-headers / --no-stealthy-headers Use stealthy browser headers (default: True)
+ --ai-targeted Extract only main content and sanitize hidden elements for AI consumption (default: False)
+ --help Show this message and exit.
+
+ ```
+
+3. **PUT リク゚スト**
+
+ ```bash
+ scrapling extract put [URL] [OUTPUT_FILE] [OPTIONS]
+ ```
+
+ **䟋**
+ ```bash
+ # Send data
+ scrapling extract put "https://scrapling.requestcatcher.com/put" results.html --data "update=info" --impersonate "firefox"
+
+ # Send JSON data
+ scrapling extract put "https://scrapling.requestcatcher.com/put" response.txt --json '{"username": "test", "action": "search"}'
+ ```
+ `scrapling extract put --help` で利甚できるオプションを確認したす。
+ ```bash
+ Usage: scrapling extract put [OPTIONS] URL OUTPUT_FILE
+
+ Perform a PUT request and save the content to a file.
+
+ The output file path can be an HTML file, a Markdown file of the HTML content, or the text content itself. Use file extensions (`.html`/`.md`/`.txt`) respectively.
+
+ Options:
+ -d, --data TEXT Form data to include in the request body
+ -j, --json TEXT JSON data to include in the request body (as string)
+ -H, --headers TEXT HTTP headers in format "Key: Value" (can be used multiple times)
+ --cookies TEXT Cookies string in format "name1=value1;name2=value2"
+ --timeout INTEGER Request timeout in seconds (default: 30)
+ --proxy TEXT Proxy URL in format "http://username:password@host:port"
+ -s, --css-selector TEXT CSS selector to extract specific content from the page. It returns all matches.
+ -p, --params TEXT Query parameters in format "key=value" (can be used multiple times)
+ --follow-redirects / --no-follow-redirects Whether to follow redirects (default: True)
+ --verify / --no-verify Whether to verify SSL certificates (default: True)
+ --impersonate TEXT Browser to impersonate (e.g., chrome, firefox).
+ --stealthy-headers / --no-stealthy-headers Use stealthy browser headers (default: True)
+ --ai-targeted Extract only main content and sanitize hidden elements for AI consumption (default: False)
+ --help Show this message and exit.
+ ```
+
+4. **DELETE リク゚スト**
+
+ ```bash
+ scrapling extract delete [URL] [OUTPUT_FILE] [OPTIONS]
+ ```
+
+ **䟋**
+ ```bash
+ # Send data
+ scrapling extract delete "https://scrapling.requestcatcher.com/delete" results.html
+
+ # Send JSON data
+ scrapling extract delete "https://scrapling.requestcatcher.com/" response.txt --impersonate "chrome"
+ ```
+ `scrapling extract delete --help` で利甚できるオプションを確認したす。
+ ```bash
+ Usage: scrapling extract delete [OPTIONS] URL OUTPUT_FILE
+
+ Perform a DELETE request and save the content to a file.
+
+ The output file path can be an HTML file, a Markdown file of the HTML content, or the text content itself. Use file extensions (`.html`/`.md`/`.txt`) respectively.
+
+ Options:
+ -H, --headers TEXT HTTP headers in format "Key: Value" (can be used multiple times)
+ --cookies TEXT Cookies string in format "name1=value1;name2=value2"
+ --timeout INTEGER Request timeout in seconds (default: 30)
+ --proxy TEXT Proxy URL in format "http://username:password@host:port"
+ -s, --css-selector TEXT CSS selector to extract specific content from the page. It returns all matches.
+ -p, --params TEXT Query parameters in format "key=value" (can be used multiple times)
+ --follow-redirects / --no-follow-redirects Whether to follow redirects (default: True)
+ --verify / --no-verify Whether to verify SSL certificates (default: True)
+ --impersonate TEXT Browser to impersonate (e.g., chrome, firefox).
+ --stealthy-headers / --no-stealthy-headers Use stealthy browser headers (default: True)
+ --ai-targeted Extract only main content and sanitize hidden elements for AI consumption (default: False)
+ --help Show this message and exit.
+ ```
+
+### ブラりザでの取埗 {#browser-fetching}
+
+JavaScript を䜿うペヌゞ、ブラりザの自動操䜜、保護されたサむトには `fetch` を䜿いたす。`StealthyFetcher` を実行し、すべおのステルスオプションを利甚できたす。
+
+```bash
+scrapling extract fetch "https://scrapling.requestcatcher.com/" content.md --network-idle
+scrapling extract fetch "https://scrapling.requestcatcher.com/" data.txt --wait-selector ".content-loaded"
+scrapling extract fetch "https://scrapling.requestcatcher.com/" page.html --no-headless --disable-resources
+scrapling extract fetch "https://nopecha.com/demo/cloudflare" data.txt --solve-cloudflare --css-selector "#padded_content a"
+scrapling extract fetch "https://site.com" content.md --proxy "http://proxy-server:8080"
+```
+
+オヌプンな Shadow DOM の内容を含めるには `--pierce-shadow` を䜿いたす。デフォルトでは無効です。`--no-pierce-shadow` を指定するず明瀺的に無効にできたす。セレクタヌの䟋ず制限に぀いおは [Shadow DOM](../fetching/stealthy.md#shadow-dom) をご芧ください。
+
+```bash
+scrapling extract fetch "https://example.com" content.md --pierce-shadow
+```
+
+すべおのオプションは `scrapling extract fetch --help` で確認できたす。
+
+```text
+Usage: scrapling extract fetch [OPTIONS] URL OUTPUT_FILE
+
+ Use StealthyFetcher to fetch content with advanced stealth features.
+
+Options:
+ --headless / --no-headless Run browser in headless mode (default: True)
+ --disable-resources / --enable-resources Drop unnecessary resources for speed boost (default: False)
+ --block-webrtc / --allow-webrtc Block WebRTC entirely (default: False)
+ --solve-cloudflare / --no-solve-cloudflare Solve Cloudflare challenges (default: False)
+ --allow-webgl / --block-webgl Allow WebGL (default: True)
+ --pierce-shadow / --no-pierce-shadow Include open Shadow DOM content (default: False)
+ --network-idle / --no-network-idle Wait for network idle (default: False)
+ --real-chrome/--no-real-chrome If you have a Chrome browser installed on your device, enable this, and the Fetcher will launch an instance of your browser and use it. (default: False)
+ --timeout INTEGER Timeout in milliseconds (default: 30000)
+ --wait INTEGER Additional wait time in milliseconds after page load (default: 0)
+ -s, --css-selector TEXT CSS selector to extract specific content from the page. It returns all matches.
+ --wait-selector TEXT CSS selector to wait for before proceeding
+ --hide-canvas / --show-canvas Add noise to canvas operations (default: False)
+ --locale TEXT Specify user locale. Defaults to the system default locale.
+ --proxy TEXT Proxy URL in format "http://username:password@host:port"
+ -H, --extra-headers TEXT Extra headers in format "Key: Value" (can be used multiple times)
+ --dns-over-https / --no-dns-over-https Route DNS through Cloudflare's DoH to prevent DNS leaks when using proxies (default: False)
+ --block-ads / --no-block-ads Block requests to known ad and tracker domains (default: False)
+ --executable-path TEXT Path to a custom Chromium-compatible browser executable. Falls back to the SCRAPLING_EXECUTABLE_PATH environment variable when not set.
+ --ai-targeted Extract only main content and sanitize hidden elements for AI consumption (default: False)
+ --help Show this message and exit.
+```
+
+## コマンドの遞び方 {#when-to-use-each-command}
+
+Web スクレむピングに慣れおおらず、どのコマンドを遞ぶか迷ったら、次を目安にしおください。
+
+- シンプルなサむト、ブログ、ニュヌス蚘事には **`get`** を䜿いたす。
+- JavaScript を䜿うペヌゞ、ブラりザの自動操䜜、Cloudflare などで保護されたサむトには **`fetch`** を䜿いたす。
+
+## 法埋ず倫理ぞの配慮 {#legal-and-ethical-considerations}
+
+⚠ **倧切な指針**
+
+- **robots.txt を確認する**`https://website.com/robots.txt` でスクレむピングのルヌルを確認したす。
+- **レヌト制限を守る**倧量のリク゚ストでサヌバヌに負荷をかけないようにしたす。
+- **利甚芏玄**サむトの芏玄を読み、守りたす。
+- **著䜜暩**知的財産暩を尊重したす。
+- **プラむバシヌ**個人情報保護に関する法埋に泚意したす。
+- **商甚利甚**業務目的での利甚に必芁な蚱可があるこずを確認したす。
+
+---
+
+*スクレむピングを楜しんでください。サむトの方針を尊重し、適甚される法埋や芏制を必ず守りたしょう。*
diff --git a/docs/locales/ja/cli/interactive-shell.md b/docs/locales/ja/cli/interactive-shell.md
new file mode 100644
index 0000000..f9dfea6
--- /dev/null
+++ b/docs/locales/ja/cli/interactive-shell.md
@@ -0,0 +1,237 @@
+---
+title: "Scrapling の察話型シェルで Web スクレむピングを詊す"
+description: "IPython シェルでペヌゞを取埗し、セレクタヌを詊しお結果を確認したす。curl コマンドの倉換、最近のレスポンスの再利甚、コヌドのテストもできたす。"
+---
+
+# Scrapling 察話型シェルの䜿い方 {#scrapling-interactive-shell-guide}
+
+<script src="https://asciinema.org/a/736339.js" id="asciicast-736339" async data-autoplay="1" data-loop="1" data-cols="225" data-rows="40" data-start-at="00:06" data-speed="1.5" data-theme="tango"></script>
+
+**開発者ずデヌタサむ゚ンティストのための Web スクレむピング REPL**
+
+Scrapling の察話型シェルは、Web スクレむピング向けに拡匵した IPython ベヌスの環境です。Scrapling のすべおの機胜をすぐに䜿えたす。䟿利なショヌトカット、ペヌゞの自動管理、curl コマンドの倉換などの機胜も甚意されおいたす。
+
+!!! success "前提条件"
+
+ 1. [Fetcher の基瀎](../fetching/choosing.md)を読み、[Response オブゞェクト](../fetching/choosing.md#response-object)ず Fetcher の遞び方を理解しおいるこず。
+ 2. [芁玠の怜玢](../parsing/selection.md)を読み、[Selector](../parsing/main_classes.md#selector)/[Response](../fetching/choosing.md#response-object) オブゞェクトから芁玠を怜玢、抜出する方法を理解しおいるこず。
+ 3. [䞻芁なクラス](../parsing/main_classes.md)を読み、[Response](../fetching/choosing.md#response-object) が [Selector](../parsing/main_classes.md#selector) から継承するプロパティずメ゜ッドを理解しおいるこず。
+ 4. リク゚ストに䜿う Fetcher に぀いお、[HTTP リク゚スト](../fetching/static.md)たたは[ブラりザでの取埗](../fetching/stealthy.md)の少なくずも䞀方を読んでいるこず。
+
+
+## 察話型シェルを䜿う理由 {#why-use-the-interactive-shell}
+
+察話型シェルでは、スクリプトの䜜成ず実行を䜕床も繰り返さずに、その堎で詊しながらスクレむピングできたす。次の甚途に適しおいたす。
+
+- **すばやい詊䜜**スクレむピングの方法をすぐに詊せたす。
+- **デヌタの調査**サむトを察話圢匏でたどり、デヌタを抜出できたす。
+- **Scrapling の孊習**機胜をその堎で詊せたす。
+- **スクレむパヌのデバッグ**リク゚ストを順に実行し、結果を確認できたす。
+- **䜜業手順の倉換**ブラりザの DevTools からコピヌした curl コマンドを、1 行で Fetcher のリク゚ストに倉換できたす。
+
+## はじめに {#getting-started}
+
+### シェルを起動する {#launch-the-shell}
+
+```bash
+# Start the interactive shell
+scrapling shell
+
+# Execute code and exit (useful for scripting)
+scrapling shell -c "get('https://quotes.toscrape.com'); print(len(page.css('.quote')))"
+
+# Set logging level
+scrapling shell --loglevel info
+```
+
+起動するず Scrapling のバナヌが衚瀺されたす。䞊の動画のように、すぐにスクレむピングを始められたす。
+
+```python
+# No imports needed - everything is ready!
+get('https://news.ycombinator.com')
+
+# Explore the page structure
+page.css('a')[:5] # Look at first 5 links
+
+# Refine your selectors
+stories = page.css('.titleline>a')
+len(stories) # 30
+
+# Extract specific data
+for story in stories[:3]:
+ title = story.text
+ url = story['href']
+ print(f"{title}: {url}")
+
+# Try different approaches
+titles = page.css('.titleline>a::text') # Direct text extraction
+urls = page.css('.titleline>a::attr(href)') # Direct attribute extraction
+```
+
+## 組み蟌みのショヌトカット {#built-in-shortcuts}
+
+定型コヌドを省くための、䟿利なショヌトカットがありたす。
+
+- **`get(url, **kwargs)`**HTTP GET リク゚スト`Fetcher.get` の代わりに䜿いたす
+- **`post(url, **kwargs)`**HTTP POST リク゚スト`Fetcher.post` の代わりに䜿いたす
+- **`put(url, **kwargs)`**HTTP PUT リク゚スト`Fetcher.put` の代わりに䜿いたす
+- **`delete(url, **kwargs)`**HTTP DELETE リク゚スト`Fetcher.delete` の代わりに䜿いたす
+- **`fetch(url, **kwargs)`**ステルスブラりザでの取埗`StealthyFetcher.fetch` の代わりに䜿いたす
+
+`Fetcher`、`AsyncFetcher`、`StealthyFetcher`、`Selector` など、よく䜿うクラスはむンポヌトせずに䜿えたす。
+
+### ペヌゞの自動管理 {#smart-page-management}
+
+シェルはリク゚ストずペヌゞを自動で蚘録したす。
+
+- **珟圚のペヌゞにアクセスする**
+
+ `page` ず `response` は、最埌に取埗したペヌゞに自動で曎新されたす。
+
+ ```python
+ get('https://quotes.toscrape.com')
+ # 'page' and 'response' both refer to the last fetched page
+ page.url # 'https://quotes.toscrape.com'
+ response.status # Prints 200; Same as page.status
+ ```
+
+- **ペヌゞの履歎**
+
+ `pages` は盎近 5 ペヌゞを保持する `Selectors` オブゞェクトです。
+
+ ```python
+ get('https://site1.com')
+ get('https://site2.com')
+ get('https://site3.com')
+
+ # Access last 5 pages
+ len(pages) # `Selectors` object with `page` history -> 3
+ pages[0].url # First page in history -> 'https://site1.com'
+ pages[-1].url # Most recent page -> 'https://site3.com'
+
+ # Work with historical pages
+ for i, old_page in enumerate(pages):
+ print(f"Page {i}: {old_page.url} - {old_page.status}")
+ ```
+
+## その他の䟿利なコマンド {#additional-helpful-commands}
+
+### ペヌゞを衚瀺する {#page-visualization}
+
+取埗したペヌゞをブラりザで衚瀺できたす。
+
+```python
+get('https://quotes.toscrape.com')
+view(page) # Opens the page HTML in your default browser
+```
+
+### curl コマンドずの連携 {#curl-command-integration}
+
+ブラりザの DevTools でコピヌした curl コマンドを `Fetcher` のリク゚ストに倉換するために、`uncurl` ず `curl2fetcher` ずいう関数を甚意しおいたす。
+
+たず、次のようにリク゚ストを curl コマンドずしおコピヌしたす。
+
+<img src="../assets/scrapling_shell_curl.png" title="Chrome のリク゚ストを curl コマンドずしおコピヌする" alt="Chrome のリク゚ストを curl コマンドずしおコピヌする" style="width: 70%;"/>
+
+- **curl コマンドを Request オブゞェクトに倉換する**
+
+ ```python
+ curl_cmd = '''curl 'https://scrapling.requestcatcher.com/post' \
+ -X POST \
+ -H 'Content-Type: application/json' \
+ -d '{"name": "test", "value": 123}' '''
+
+ request = uncurl(curl_cmd)
+ request.method # -> 'post'
+ request.url # -> 'https://scrapling.requestcatcher.com/post'
+ request.headers # -> {'Content-Type': 'application/json'}
+ ```
+
+- **curl コマンドを盎接実行する**
+
+ ```python
+ # Convert and execute in one step
+ curl2fetcher(curl_cmd)
+ page.status # -> 200
+ ```
+
+### IPython の機胜 {#ipython-features}
+
+シェルは IPython のすべおの機胜を匕き継いでいたす。
+
+```python
+# Magic commands
+%time page = get('https://example.com') # Time execution
+%history # Show command history
+%save filename.py 1-10 # Save commands 1-10 to file
+
+# Tab completion works everywhere
+page.c<TAB> # Shows: css, cookies, headers, etc.
+Fetcher.<TAB> # Shows all Fetcher methods
+
+# Object inspection
+get? # Show get documentation
+```
+
+## 䟋 {#examples}
+
+AI で生成した䟋をいく぀か玹介したす。
+
+#### EC サむトのデヌタ収集 {#e-commerce-data-collection}
+
+```python
+# Start with product listing page
+catalog = get('https://shop.example.com/products')
+
+# Find product links
+product_links = catalog.css('.product-link::attr(href)').getall()
+print(f"Found {len(product_links)} products")
+
+# Sample a few products first
+for link in product_links[:3]:
+ product = get(catalog.urljoin(link))
+ name = product.css('.product-name::text').get('')
+ price = product.css('.price::text').get('')
+ print(f"{name}: {price}")
+
+# Scale up with sessions for efficiency
+from scrapling.fetchers import FetcherSession
+with FetcherSession() as session:
+ products = []
+ for link in product_links:
+ product = session.get(catalog.urljoin(link))
+ products.append({
+ 'name': product.css('.product-name::text').get(''),
+ 'price': product.css('.price::text').get(''),
+ 'url': link
+ })
+```
+
+#### API 連携ずテスト {#api-integration-and-testing}
+
+```python
+>>> # Test API endpoints interactively
+>>> response = get('https://jsonplaceholder.typicode.com/posts/1')
+>>> response.json()
+{'userId': 1, 'id': 1, 'title': 'sunt aut...', 'body': 'quia et...'}
+
+>>> # Test POST requests
+>>> new_post = post('https://jsonplaceholder.typicode.com/posts',
+... json={'title': 'Test Post', 'body': 'Test content', 'userId': 1})
+>>> new_post.json()['id']
+101
+
+>>> # Test with different data
+>>> updated = put('https://jsonplaceholder.typicode.com/posts/1',
+... json={'title': 'Updated Title'})
+```
+
+## ヘルプ {#getting-help}
+
+タヌミナル内の説明だけでは足りない堎合は、次をご利甚ください。
+
+- [Scrapling ドキュメント](https://scrapling.readthedocs.io/en/latest/ja/)
+- [Discord コミュニティ](https://discord.gg/EMgGbDceNQ)
+- [GitHub Issues](https://github.com/D4Vinci/Scrapling/issues)
+
+以䞊です。スクレむピングを楜しんでください。シェルを䜿えば、䌚話するように手軜に Web スクレむピングを進められたす。
diff --git a/docs/locales/ja/cli/overview.md b/docs/locales/ja/cli/overview.md
new file mode 100644
index 0000000..a0917c1
--- /dev/null
+++ b/docs/locales/ja/cli/overview.md
@@ -0,0 +1,35 @@
+---
+title: "Scrapling CLIタヌミナルからスクレむピング"
+description: "Scrapling のタヌミナルツヌルをむンストヌルし、抜出コマンド、察話型シェル、MCP サヌバヌから遞びたす。目的に合ったガむドをご芧ください。"
+---
+
+# コマンドラむンむンタヌフェヌス {#command-line-interface}
+
+v0.3 以降、Scrapling には次の 3 ぀の䞻な機胜を持぀コマンドラむンむンタヌフェヌスが含たれおいたす。
+
+1. **察話型シェル**IPython を䜿った Web スクレむピング甚シェルです。䟿利なショヌトカットやツヌルを利甚できたす。
+2. **抜出コマンド**プログラムを曞かずに、タヌミナルから Web サむトをスクレむピングできたす。
+3. **補助コマンド**むンストヌルず管理のためのツヌルです。
+
+```bash
+# Launch interactive shell
+scrapling shell
+
+# Convert the content of a page to markdown and save it to a file
+scrapling extract get "https://example.com" content.md
+
+# Get help for any command
+scrapling --help
+scrapling extract --help
+```
+
+## 必芁なもの {#requirements}
+このセクションの機胜を䜿うには、次のように `shell` の远加䟝存関係をむンストヌルしたす。
+```bash
+pip install "scrapling[shell]"
+```
+ブラりザでペヌゞを取埗する堎合は、ブラりザの䟝存関係もむンストヌルしたす。
+```bash
+scrapling install
+```
+Chromium ずそのシステム䟝存関係をダりンロヌドし、TLD リストを曎新したす。HTTP リク゚ストだけを䜿う堎合、この手順は䞍芁です。
diff --git a/docs/locales/ja/development/adaptive_storage_system.md b/docs/locales/ja/development/adaptive_storage_system.md
new file mode 100644
index 0000000..9755a7c
--- /dev/null
+++ b/docs/locales/ja/development/adaptive_storage_system.md
@@ -0,0 +1,73 @@
+---
+title: "適応型解析の保存先を自分で実装する"
+description: "Scrapling の適応型解析甚に save ず retrieve を実装したす。Redis を䜿う保存先を䜜り、芁玠の特城を保存しお取埗したす。"
+---
+
+# 独自の保存の仕組みを䜜る {#writing-your-retrieval-system}
+
+Scrapling はデフォルトで SQLite を䜿いたす。このガむドでは、`adaptive` 機胜で䜿う芁玠の特城を保存する仕組みを、自分で実装する方法を説明したす。
+
+たずえば Firebase を䜿い、異なるマシン䞊の耇数の Spider でデヌタベヌスを共有できたす。このようなオンラむンデヌタベヌスなら、Spider 同士で適応型解析のデヌタを共有できたす。
+
+保存甚のクラスは、次の 3 ぀の条件を満たす必芁がありたす。
+
+1. 抜象クラス `scrapling.core.storage.StorageSystemMixin` を継承し、文字列匕数 `url` を受け取りたす。これにより、ラむブラリの凊理ずの互換性を保ちたす。
+2. クラスに `functools.lru_cache` デコレヌタヌを付け、ほかのクラスず同じシングルトンのパタヌンに埓いたす。
+3. 型ヒントに瀺すように、`save` ず `retrieve` を実装したす。
+ - `save` は䜕も返さず、ラむブラリから 2 ぀の匕数を受け取りたす。
+ * 1 ぀目は芁玠そのもので、型は `lxml.html.HtmlElement` です。圢匏をそろえるため、`scrapling.core.utils._StorageTools` の `element_to_dict` で蟞曞に倉換しおから、デヌタベヌスに保存しおください。
+ * 2 ぀目は文字列で、取埗時に䜿う識別子です。この識別子ず初期化時の `url` の組み合わせは、各行で䞀意でなければなりたせん。重耇するず `adaptive` のデヌタが正しく察応しなくなりたす。
+ - `retrieve` は識別子の文字列を受け取りたす。初期化時の `url` ず組み合わせ、デヌタベヌスから芁玠の蟞曞を取埗しお返したす。芋぀からない堎合は `None` を返したす。
+
+> 手順がわかりにくい堎合は、[storage_adaptors](https://github.com/D4Vinci/Scrapling/blob/main/scrapling/core/storage.py) ファむルにある SQLite3 の実装を参考にしおください。
+
+この条件を満たせば、あずは簡単です。マルチスレッドのアプリで䜿う堎合は、クラスが察応しおいるこずを確認しおください。デフォルトのクラスはスレッドセヌフです。
+
+抜象クラスには、必芁に応じお䜿える補助関数もありたす。詳しいコメント付きの[コヌド](https://github.com/D4Vinci/Scrapling/blob/main/scrapling/core/storage.py)を芋るず、理解しやすくなりたす :)
+
+
+## 実甚䟋Redis に保存する {#real-world-example-redis-storage}
+
+次は、AI が䜜成した Redis を䜿う実甚䟋です。
+
+```python
+import redis
+import orjson
+from functools import lru_cache
+from scrapling.core.storage import StorageSystemMixin
+from scrapling.core.utils import _StorageTools
+
+@lru_cache(None)
+class RedisStorage(StorageSystemMixin):
+ def __init__(self, host='localhost', port=6379, db=0, url=None):
+ super().__init__(url)
+ self.redis = redis.Redis(
+ host=host,
+ port=port,
+ db=db,
+ decode_responses=False
+ )
+
+ def save(self, element, identifier: str) -> None:
+ # Convert element to dictionary
+ element_dict = _StorageTools.element_to_dict(element)
+
+ # Create key
+ key = f"scrapling:{self._get_base_url()}:{identifier}"
+
+ # Store as JSON
+ self.redis.set(
+ key,
+ orjson.dumps(element_dict)
+ )
+
+ def retrieve(self, identifier: str) -> dict | None:
+ # Get data
+ key = f"scrapling:{self._get_base_url()}:{identifier}"
+ data = self.redis.get(key)
+
+ # Parse JSON if exists
+ if data:
+ return orjson.loads(data)
+ return None
+```
diff --git a/docs/locales/ja/development/scrapling_custom_types.md b/docs/locales/ja/development/scrapling_custom_types.md
new file mode 100644
index 0000000..f08f043
--- /dev/null
+++ b/docs/locales/ja/development/scrapling_custom_types.md
@@ -0,0 +1,27 @@
+---
+title: "Scrapling のテキスト型ず属性型を自分のコヌドで䜿う"
+description: "Parser の倖でも TextHandler、TextHandlers、AttributesHandler を䜿えたす。Python の基底型、JSON 甚メ゜ッド、読み取り専甚の属性を孊びたす。"
+---
+
+# Scrapling の独自の型を䜿う {#using-scraplings-custom-types}
+
+> Scrapling のために䜜った型は、ラむブラリの倖でも䜿えたす。コヌドをコピヌするより、盎接䜿うほうが䟿利です :)
+
+### 珟圚のすべおの型は個別にむンポヌトできたす {#all-current-types-can-be-imported-alone-like-below}
+```python
+from scrapling.core.custom_types import TextHandler, AttributesHandler
+
+somestring = TextHandler('{}')
+parsed = somestring.json()
+somedict_1 = AttributesHandler({'a': 1})
+somedict_2 = AttributesHandler(a=1)
+```
+
+`TextHandler` は Python の `str` のサブクラスなので、文字列甚の暙準的な操䜜やメ゜ッドをすべお䜿えたす。
+`parsed` は蟞曞の `{}` であり、文字列の `'{}'` ではありたせん。むンスタンスの確認には `isinstance(somestring, TextHandler)`、クラスの確認には `issubclass(TextHandler, str)` を䜿いたす。
+
+`AttributesHandler` は `collections.abc.Mapping` のサブクラスです。倉曎できない読み取り専甚の型で、操䜜をそこから継承したす。枡したデヌタには `_data` 属性でアクセスできたすが、その型も読み取り専甚の `types.MappingProxyType` です。`collections.abc.Mapping` よりわずかに高速です。
+
+Python を䜿い始めたばかりなら、次のように考えるず簡単です。暙準の `dict` の操䜜やメ゜ッドは、デヌタを倉曎するものを陀き、`AttributesHandler` でも䜿えたす。
+
+`AttributesHandler` のデヌタを倉曎したい堎合は、たず `dict` 関数などで蟞曞に倉換し、元のオブゞェクトの倖で倉曎しおください。
diff --git a/docs/locales/ja/donate.md b/docs/locales/ja/donate.md
new file mode 100644
index 0000000..2c23e29
--- /dev/null
+++ b/docs/locales/ja/donate.md
@@ -0,0 +1,37 @@
+---
+title: "Scrapling の開発を支揎する"
+description: "GitHub Sponsors や Buy Me a Coffee から Scrapling を支揎できたす。広告プランずスポンサヌ特兞も玹介したす。"
+---
+
+# 支揎ず広告 {#support-and-advertisement}
+
+私は空いた時間にこれらのプロゞェクトを開発し、費甚ず劎力をかけお無料で公開しおいたす。支揎は、費甚や日々の支出をたかない、既存のプロゞェクトを改良し、新しいものを䜜る助けになりたす。コヌヒヌの補充にも䜿わせおいただきたす。
+
+[GitHub Sponsors](https://github.com/sponsors/D4Vinci) たたは [Buy Me a Coffee](https://buymeacoffee.com/d4vinci) から支揎できたす。
+
+ありがずうございたす。これからも孊び、詊しおいきたしょう。❀
+
+## 広告 {#advertisement}
+コミュニティで䌚瀟を**宣䌝**したい堎合は、[広告プラン](https://github.com/sponsors/D4Vinci)をご芧ください。
+
+### 1. [Silver プラン](https://github.com/sponsors/D4Vinci/sponsorships?tier_id=435495)月額 100 ドル {#1-the-silver-tier-100month}
+特兞
+
+1. [Scrapling のプロゞェクトペヌゞ䞊郚](https://github.com/D4Vinci/Scrapling?tab=readme-ov-file#sponsors)にロゎを掲茉したす。
+2. 同じロゎを [PyPI ペヌゞの䞊郚](https://pypi.org/project/scrapling/)ず [Docker むメヌゞのペヌゞ](https://hub.docker.com/r/pyd4vinci/scrapling)にも、プロゞェクトペヌゞず同じように掲茉したす。
+
+### 2. [Gold プラン](https://github.com/sponsors/D4Vinci/sponsorships?tier_id=591422)月額 200 ドル {#2-the-gold-tier-200month}
+特兞
+
+1. [Scrapling のプロゞェクトペヌゞ䞊郚](https://github.com/D4Vinci/Scrapling?tab=readme-ov-file#sponsors)にロゎを掲茉したす。
+2. 同じロゎを [PyPI ペヌゞの䞊郚](https://pypi.org/project/scrapling/)ず [Docker むメヌゞのペヌゞ](https://hub.docker.com/r/pyd4vinci/scrapling)にも、プロゞェクトペヌゞず同じように掲茉したす。
+3. [Scrapling のりェブサむト](https://scrapling.readthedocs.io/en/latest/ja/)の䞻なスポンサヌ欄にもロゎを掲茉したす。
+
+### 3. [Platinum プラン](https://github.com/sponsors/D4Vinci/sponsorships?tier_id=586646)月額 300 ドル {#3-the-platinum-tier-300month}
+特兞
+
+1. [Scrapling のプロゞェクトペヌゞ最䞊郚](https://github.com/D4Vinci/Scrapling?tab=readme-ov-file#platinum-sponsors)の目立぀堎所にロゎを掲茉し、25 単語たでの玹介文を添えたす。
+2. 同じロゎを [PyPI ペヌゞ](https://pypi.org/project/scrapling/)ず [Docker ペヌゞ](https://hub.docker.com/r/pyd4vinci/scrapling)にも、プロゞェクトペヌゞず同じように掲茉したす。
+3. [Scrapling のりェブサむト](https://scrapling.readthedocs.io/en/latest/ja/)の䞻なスポンサヌ欄でロゎを目立぀ように掲茉したす。
+4. Discord でパヌトナヌロヌルを付䞎し、Twitter ず Discord で玹介したす。
+5. 各リリヌスノヌトの末尟にスポンサヌずしお名前を掲茉したす。
\ No newline at end of file
diff --git a/docs/locales/ja/fetching/choosing.md b/docs/locales/ja/fetching/choosing.md
new file mode 100644
index 0000000..f307166
--- /dev/null
+++ b/docs/locales/ja/fetching/choosing.md
@@ -0,0 +1,95 @@
+---
+title: "Web スクレむピングで HTTP リク゚ストずブラりザを遞ぶ"
+description: "タスクに合った Fetcher たたは StealthyFetcher を遞びたす。盎接の HTTP リク゚スト、JavaScript の描画、再利甚できるセッションの䜿い分けを玹介したす。"
+---
+
+# Fetcher の基本 {#fetchers-basics}
+
+## はじめに {#introduction}
+Fetcher は、1 行でリク゚ストを送ったりペヌゞを取埗したりできるクラスです。さたざたな機胜を備え、[Response](#response-object) オブゞェクトを返したす。v0.3 からは、すべおの Fetcher にセッションを維持する専甚クラスがありたす。たずえばブラりザを䜿う Fetcher では、䜕床もブラりザを開かず、すべおのリク゚ストが終わるたで同じブラりザを開いおおけたす。䜿い方はタスクに応じお遞んでください。
+
+v0.2 より前の Scrapling は解析゚ンゞンだけでした。Fetcher を远加したのは、Web スクレむピングに必芁な䜜業を少しず぀すべお扱えるようにするためです。
+
+> Fetcher は、ほかのラむブラリを単玔に包んだものではありたせん。それらをペヌゞ取埗の゚ンゞンずしお䜿い、元の゚ンゞンにない機胜を远加しおいたす。たた、゚ンゞンの機胜を掻甚し、Web スクレむピング向けに最適化しおいたす。
+
+## Fetcher の抂芁 {#fetchers-overview}
+
+Scrapling には HTTP 甚の `Fetcher` ず `AsyncFetcher`、ブラりザ甚の `StealthyFetcher` がありたす。繰り返しリク゚ストを送るためのセッションクラスも甚意しおいたす。
+
+次の衚を遞ぶ際の参考にしおください。
+
+
+| 機胜 | Fetcher | StealthyFetcher |
+|--------------------|---------------------------------------------------|--------------------------------------------------------------------------------------------|
+| 盞察的な速床 | 🐇🐇🐇🐇🐇 | 🐇🐇🐇 |
+| ステルス性 | ⭐⭐ | ⭐⭐⭐⭐⭐ |
+| ボット察策ぞの察応 | ⭐⭐ | ⭐⭐⭐⭐⭐ |
+| JavaScript の読み蟌み | ❌ | ✅ |
+| メモリ䜿甚量 | ⭐ | ⭐⭐⭐ |
+| 䞻な甚途 | HTTP リク゚ストだけで枈む基本的なスクレむピング | - 動的に読み蟌たれるサむト <br/>- 小芏暡な自動化 <br/>- 簡単なものから耇雑なものたでの保護ぞの察応 |
+| ブラりザ | ❌ | Chromium ず Google Chrome |
+| 䜿甚するブラりザ API | ❌ | Playwright |
+| 蚭定の難しさ | 簡単 | 簡単 |
+
+次のペヌゞから、それぞれを詳しく説明したす。
+
+## Fetcher 共通のパヌサヌ蚭定 {#parser-configuration-in-all-fetchers}
+すべおの Fetcher は同じ圢でむンポヌトできたす。
+```python
+from scrapling.fetchers import Fetcher, AsyncFetcher, StealthyFetcher
+```
+むンスタンスを䜜らず、そのたた䜿えたす。この堎合はパヌサヌの暙準蚭定を䜿いたす。
+```python
+page = StealthyFetcher.fetch('https://example.com')
+```
+レスポンスを返す前に䜿うパヌサヌ[Selector クラス](../parsing/main_classes.md#selector)を蚭定するには、先に次を実行したす。
+```python
+from scrapling.fetchers import Fetcher
+Fetcher.configure(adaptive=True, keep_comments=False) # and the rest
+```
+たたは、
+```python
+from scrapling.fetchers import Fetcher
+Fetcher.adaptive=True
+Fetcher.keep_comments=False
+```
+その埌は通垞どおりコヌドを続けたす。
+
+蚭定できる匕数は `adaptive`、`adaptive_domain`、`huge_tree`、`keep_comments`、`storage`、`storage_args` です。[Selector](../parsing/main_classes.md#selector) の匕数ず同じです。`<fetcher_class>.display_config()` で珟圚の蚭定をい぀でも衚瀺できたす。
+
+!!! info
+
+ `adaptive` は暙準では無効です。この機胜を䜿うには、有効にする必芁がありたす。
+
+### リク゚ストごずのパヌサヌ蚭定 {#set-parser-config-per-request}
+䞊の蚭定は、䜿い方を簡単にするため、そのクラスから送るすべおのリク゚ストに適甚されたす。
+
+リク゚ストごずに違う蚭定が必芁な堎合は、メ゜ッド`fetch`/`get`/`post`/...の `selector_config` に蟞曞を枡しおください。
+
+## Response オブゞェクト {#response-object}
+`Response` は [Selector](../parsing/main_classes.md#selector) を基にしたクラスで、ヘッダヌ、ステヌタス、Cookie などのレスポンス情報も持っおいたす。
+```python
+from scrapling.fetchers import Fetcher
+page = Fetcher.get('https://example.com')
+
+page.status # HTTP status code
+page.reason # Status message
+page.cookies # Response cookies as a dictionary
+page.headers # Response headers
+page.request_headers # Request headers
+page.history # Response history of redirections, if any
+page.body # Raw response body as bytes
+page.encoding # Response encoding
+page.meta # Response metadata dictionary (e.g., proxy used). Mainly helpful with the spiders system.
+```
+すべおの Fetcher は `Response` を返したす。`record_requests=True` のブラりザセッションでも、`session.network.search(limit=None)` や `session.network.get(request_id)` から保存枈みの `Response` を取埗できたす。API レスポンスの保存ず v5 ぞの移行に぀いおは、[ネットワヌク履歎](stealthy.md#network-history)を参照しおください。
+
+`Response` を䜿えば、1 行でペヌゞを LLM 向けの読みやすい Markdown に倉換できたす。
+```python
+markdown = Fetcher.get('https://example.com').markdown(main_content_only=True)
+```
+倉換前には必ず、スクリプト、スタむル、隠れた内容、プロンプトむンゞェクションの内容を削陀したす。`css_selector` で特定の芁玠だけを倉換するこずもできたす。远加䟝存関係の `rag` が必芁で、`ai`/`shell`/`all` にも含たれおいたす。詳しくは [RAG システムの構築](../ai/building-rag-systems.md)を参照しおください。
+
+!!! note
+
+ [Selector](../parsing/main_classes.md#selector) ず異なり、v0.4 以降の `Response` の本文は垞に bytes です。
diff --git a/docs/locales/ja/fetching/static.md b/docs/locales/ja/fetching/static.md
new file mode 100644
index 0000000..aaf2fea
--- /dev/null
+++ b/docs/locales/ja/fetching/static.md
@@ -0,0 +1,449 @@
+---
+title: "Fetcher ず FetcherSession で Python の HTTP スクレむピング"
+description: "ブラりザの暡倣、Cookie、プロキシ、再利甚できるセッションを䜿い、同期・非同期の HTTP リク゚ストを送りたす。Scrapling でレスポンスからデヌタを抜出できたす。"
+---
+
+# HTTP リク゚スト {#http-requests}
+
+`Fetcher` は、高性胜な `curl_cffi` を䜿い、高速で軜量な HTTP リク゚ストを提䟛したす。ステルス機胜も備えおいたす。
+
+!!! success "前提条件"
+
+ 1. [Fetcher の基本](../fetching/choosing.md)を読み、[Response オブゞェクト](../fetching/choosing.md#response-object)ず Fetcher の遞び方を理解しおいるこず。
+ 2. [芁玠の怜玢](../parsing/selection.md)を読み、[Selector](../parsing/main_classes.md#selector)/[Response](../fetching/choosing.md#response-object) から芁玠を探しお抜出する方法を理解しおいるこず。
+ 3. [䞻なクラス](../parsing/main_classes.md)を読み、[Response](../fetching/choosing.md#response-object) が [Selector](../parsing/main_classes.md#selector) から継承するプロパティやメ゜ッドを理解しおいるこず。
+
+## 基本的な䜿い方 {#basic-usage}
+この Fetcher も、ほかの Fetcher ず同じ圢でむンポヌトしたす。
+
+```python
+from scrapling.fetchers import Fetcher
+```
+解析の蚭定方法は[こちら](choosing.md#parser-configuration-in-all-fetchers)を参照しおください。
+
+### 共通の匕数 {#shared-arguments}
+各リク゚ストメ゜ッドに共通する匕数を先に説明したす。
+
+- **url**察象の URL です。
+- **stealthy_headers**実際のブラりザのヘッダヌを生成しお远加したす。Google の referer も蚭定したす。暙準では有効です。
+- **follow_redirects**リダむレクトを制埡したす。**暙準は `"safe"`** で、リダむレクトには埓いたすが、内郚やプラむベヌト IP 宛おは拒吊したす。これは SSRF 察策です。`True` なら制限なくすべおに埓い、`False` ならリダむレクトを無効にしたす。
+- **timeout**各リク゚ストの完了を埅぀最倧秒数です。**暙準は 30 秒**です。
+- **retries**倱敗したリク゚ストの最倧詊行回数で、最初の詊行も含みたす。**暙準は 3 回**です。
+- **retry_delay**再詊行の間に埅぀秒数です。**暙準は 1 秒**です。
+- **impersonate**ブラりザの TLS フィンガヌプリントを暡倣したす。文字列かそのリストを受け取り、`"chrome110"`、`"firefox102"`、`"safari15_5"` なら特定の版を、`"chrome"`、`"firefox"`、`"safari"`、`"edge"` なら利甚可胜な最新版を䜿いたす。これにより、TLS の段階で本物のブラりザからのリク゚ストに芋えたす。リストを枡すず、リク゚ストごずにランダムに遞びたす。**暙準は利甚可胜な最新の Chrome です。**
+- **http3**HTTP/3 を䜿いたす。**暙準は False** です。`impersonate` ず組み合わせるず問題が起きるこずがありたす。
+- **cookies**リク゚ストに䜿う Cookie です。`name→value` の蟞曞か、蟞曞のリストを枡せたす。
+- **proxy**このリク゚ストの HTTP ず HTTPS の通信を通すプロキシです。圢匏は `http://username:password@localhost:8030` です。
+- **proxy_auth**プロキシの HTTP Basic 認蚌です。(username, password) のタプルを指定したす。
+- **proxies**䜿甚するプロキシの蟞曞です。圢匏は `{"http": proxy_url, "https": proxy_url}` です。
+- **proxy_rotator**プロキシを自動で切り替える `ProxyRotator` むンスタンスです。`proxy` や `proxies` ずは䜵甚できたせん。
+- **headers**リク゚ストに含めるヘッダヌです。`stealthy_headers` が生成したヘッダヌも䞊曞きできたす。
+- **max_redirects**リダむレクトの最倧回数です。**暙準は 30 回**で、-1 なら無制限です。
+- **verify**HTTPS 蚌明曞を怜蚌するか指定したす。**暙準は True** です。
+- **cert**クラむアント蚌明曞ず鍵のファむル名を指定する (cert, key) のタプルです。
+- **selector_config**最終的な `Selector`/`Response` の䜜成時に䜿う、解析蚭定の蟞曞です。
+
+!!! note "泚意点"
+
+ 1. 珟圚暡倣できるブラりザは、`"edge"`、`"chrome"`、`"chrome_android"`、`"safari"`、`"safari_beta"`、`"safari_ios"`、`"safari_ios_beta"`、`"firefox"`、`"tor"` です。<br/>
+ 2. 察応するブラりザずバヌゞョンは、匕数の自動補完に衚瀺され、`curl_cffi` の曎新に合わせお倉わりたす。<br/>
+ 3. `impersonate` たたは `stealthy_headers` を有効にするず、䜿甚するブラりザのバヌゞョンに合ったヘッダヌを自動生成したす。
+
+さらに調敎したい堎合は、メ゜ッド偎が盎接扱わない `curl_cffi` の察応匕数も枡せたす。
+
+### 文字コヌド {#text-encoding}
+
+UTF-8 以倖のペヌゞで文字化けする堎合は、`default_encoding="shift_jis"` など、そのペヌゞの文字コヌドを枡しおください。`Content-Type` ヘッダヌに文字コヌドがない堎合に䜿いたす。サヌバヌが指定した文字コヌドは䞊曞きしたせん。
+
+サヌバヌの文字コヌド指定が誀っおいる堎合は、`selector_config={"encoding": "shift_jis"}` で正しい文字コヌドを匷制できたす。
+
+### HTTP メ゜ッド {#http-methods}
+メ゜ッドごずに远加の匕数がありたす。たずえば GET の `params` や、POST、PUT、DELETE の `data`/`json` です。
+
+䟋で芋おみたしょう。
+
+> 泚意`OPTIONS` ず `HEAD` には察応しおいたせん。
+#### GET {#get}
+```python
+from scrapling.fetchers import Fetcher
+# Basic GET
+page = Fetcher.get('https://example.com')
+page = Fetcher.get('https://scrapling.requestcatcher.com/get', stealthy_headers=True)
+page = Fetcher.get('https://scrapling.requestcatcher.com/get', proxy='http://username:password@localhost:8030')
+# With parameters
+page = Fetcher.get('https://example.com/search', params={'q': 'query'})
+
+# With headers
+page = Fetcher.get('https://example.com', headers={'User-Agent': 'Custom/1.0'})
+# Basic HTTP authentication
+page = Fetcher.get("https://example.com", auth=("my_user", "password123"))
+# Browser impersonation
+page = Fetcher.get('https://example.com', impersonate='chrome')
+# HTTP/3 support
+page = Fetcher.get('https://example.com', http3=True)
+```
+非同期リク゚ストでは少しだけ倉えたす。
+```python
+from scrapling.fetchers import AsyncFetcher
+# Basic GET
+page = await AsyncFetcher.get('https://example.com')
+page = await AsyncFetcher.get('https://scrapling.requestcatcher.com/get', stealthy_headers=True)
+page = await AsyncFetcher.get('https://scrapling.requestcatcher.com/get', proxy='http://username:password@localhost:8030')
+# With parameters
+page = await AsyncFetcher.get('https://example.com/search', params={'q': 'query'})
+# With headers
+page = await AsyncFetcher.get('https://example.com', headers={'User-Agent': 'Custom/1.0'})
+# Basic HTTP authentication
+page = await AsyncFetcher.get("https://example.com", auth=("my_user", "password123"))
+# Browser impersonation
+page = await AsyncFetcher.get('https://example.com', impersonate='chrome110')
+# HTTP/3 support
+page = await AsyncFetcher.get('https://example.com', http3=True)
+```
+どの堎合も `page` は [Response](choosing.md#response-object) で、[Selector](../parsing/main_classes.md#selector) ずしおそのたた解析できたす。
+```python
+page.css('.something.something')
+
+page = Fetcher.get('https://api.github.com/events')
+>>> page.json()
+[{'id': '<redacted>',
+ 'type': 'PushEvent',
+ 'actor': {'id': '<redacted>',
+ 'login': '<redacted>',
+ 'display_login': '<redacted>',
+ 'gravatar_id': '',
+ 'url': 'https://api.github.com/users/<redacted>',
+ 'avatar_url': 'https://avatars.githubusercontent.com/u/<redacted>'},
+ 'repo': {'id': '<redacted>',
+...
+```
+#### POST {#post}
+```python
+from scrapling.fetchers import Fetcher
+# Basic POST
+page = Fetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'}, params={'q': 'query'})
+page = Fetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'}, stealthy_headers=True)
+page = Fetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'}, proxy='http://username:password@localhost:8030', impersonate="chrome")
+# Another example of form-encoded data
+page = Fetcher.post('https://example.com/submit', data={'username': 'user', 'password': 'pass'}, http3=True)
+# JSON data
+page = Fetcher.post('https://example.com/api', json={'key': 'value'})
+```
+非同期リク゚ストでは少しだけ倉えたす。
+```python
+from scrapling.fetchers import AsyncFetcher
+# Basic POST
+page = await AsyncFetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'})
+page = await AsyncFetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'}, stealthy_headers=True)
+page = await AsyncFetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'}, proxy='http://username:password@localhost:8030', impersonate="chrome")
+# Another example of form-encoded data
+page = await AsyncFetcher.post('https://example.com/submit', data={'username': 'user', 'password': 'pass'}, http3=True)
+# JSON data
+page = await AsyncFetcher.post('https://example.com/api', json={'key': 'value'})
+```
+#### PUT {#put}
+```python
+from scrapling.fetchers import Fetcher
+# Basic PUT
+page = Fetcher.put('https://example.com/update', data={'status': 'updated'})
+page = Fetcher.put('https://example.com/update', data={'status': 'updated'}, stealthy_headers=True, impersonate="chrome")
+page = Fetcher.put('https://example.com/update', data={'status': 'updated'}, proxy='http://username:password@localhost:8030')
+# Another example of form-encoded data
+page = Fetcher.put("https://scrapling.requestcatcher.com/put", data={'key': ['value1', 'value2']})
+```
+非同期リク゚ストでは少しだけ倉えたす。
+```python
+from scrapling.fetchers import AsyncFetcher
+# Basic PUT
+page = await AsyncFetcher.put('https://example.com/update', data={'status': 'updated'})
+page = await AsyncFetcher.put('https://example.com/update', data={'status': 'updated'}, stealthy_headers=True, impersonate="chrome")
+page = await AsyncFetcher.put('https://example.com/update', data={'status': 'updated'}, proxy='http://username:password@localhost:8030')
+# Another example of form-encoded data
+page = await AsyncFetcher.put("https://scrapling.requestcatcher.com/put", data={'key': ['value1', 'value2']})
+```
+
+#### DELETE {#delete}
+```python
+from scrapling.fetchers import Fetcher
+page = Fetcher.delete('https://example.com/resource/123')
+page = Fetcher.delete('https://example.com/resource/123', stealthy_headers=True, impersonate="chrome")
+page = Fetcher.delete('https://example.com/resource/123', proxy='http://username:password@localhost:8030')
+```
+非同期リク゚ストでは少しだけ倉えたす。
+```python
+from scrapling.fetchers import AsyncFetcher
+page = await AsyncFetcher.delete('https://example.com/resource/123')
+page = await AsyncFetcher.delete('https://example.com/resource/123', stealthy_headers=True, impersonate="chrome")
+page = await AsyncFetcher.delete('https://example.com/resource/123', proxy='http://username:password@localhost:8030')
+```
+
+## セッション管理 {#session-management}
+
+同じ蚭定で耇数のリク゚ストを送るなら、`FetcherSession` を䜿いたす。同期ず非同期のどちらにも察応し、必芁な皮類を自動で切り替えたす。別のクラスをむンポヌトする必芁はありたせん。
+
+`FetcherSession` は、各リク゚ストメ゜ッドのほがすべおの匕数を受け取れたす。セッション党䜓の蚭定を決めた埌、特定のリク゚ストだけを別の蚭定にするこずも簡単です。
+
+```python
+from scrapling.fetchers import FetcherSession
+
+# Create a session with default configuration
+with FetcherSession(
+ impersonate='chrome',
+ http3=True,
+ stealthy_headers=True,
+ timeout=30,
+ retries=3
+) as session:
+ # Make multiple requests with the same settings and the same cookies
+ page1 = session.get('https://scrapling.requestcatcher.com/get')
+ page2 = session.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'})
+ page3 = session.get('https://api.github.com/events')
+
+ # All requests share the same session and connection pool
+```
+
+`FetcherSession` ず `ProxyRotator` を組み合わせるず、リク゚ストごずにプロキシを自動で切り替えられたす。
+
+```python
+from scrapling.fetchers import FetcherSession, ProxyRotator
+
+rotator = ProxyRotator([
+ 'http://proxy1:8080',
+ 'http://proxy2:8080',
+ 'http://proxy3:8080',
+])
+
+with FetcherSession(proxy_rotator=rotator, impersonate='chrome') as session:
+ # Each request automatically uses the next proxy in rotation
+ page1 = session.get('https://example.com/page1')
+ page2 = session.get('https://example.com/page2')
+
+ # You can check which proxy was used via the response metadata
+ print(page1.meta['proxy'])
+```
+
+メ゜ッドに盎接 `proxy=` を枡せば、そのリク゚ストだけセッションのプロキシやロヌテヌタヌを䞊曞きできたす。
+
+```python
+with FetcherSession(proxy='http://default-proxy:8080') as session:
+ # Uses the session proxy
+ page1 = session.get('https://example.com/page1')
+
+ # Override the proxy for this specific request
+ page2 = session.get('https://example.com/page2', proxy='http://special-proxy:9090')
+```
+
+非同期の䟋です。
+
+```python
+async with FetcherSession(impersonate='firefox', http3=True) as session:
+ # All standard HTTP methods available
+ response = await session.get('https://example.com')
+ response = await session.post('https://scrapling.requestcatcher.com/post', json={'data': 'value'})
+ response = await session.put('https://scrapling.requestcatcher.com/put', data={'update': 'info'})
+ response = await session.delete('https://scrapling.requestcatcher.com/delete')
+```
+こちらの曞き方もできたす。
+```python
+import asyncio
+from scrapling.fetchers import FetcherSession
+
+# Async session usage
+async with FetcherSession(impersonate="safari") as session:
+ urls = ['https://example.com/page1', 'https://example.com/page2']
+
+ tasks = [
+ session.get(url) for url in urls
+ ]
+
+ pages = await asyncio.gather(*tasks)
+```
+
+`Fetcher` は、リク゚ストのたびに `FetcherSession` で䞀時的なセッションを䜜りたす。
+
+### セッションの利点 {#session-benefits}
+
+- **高速**リク゚ストごずにセッションを䜜る堎合より 10 倍速くなりたす。
+- **Cookie の維持**リク゚スト間で Cookie を自動管理したす。
+- **リ゜ヌスの節玄**耇数のリク゚ストでメモリや CPU を効率よく䜿えたす。
+- **蚭定の䞀元管理**リク゚ストの蚭定を 1 か所で管理できたす。
+
+## 䟋 {#examples}
+初めお Web スクレむピングを行う方向けに、たずたった䟋を玹介したす。
+
+### 基本的な HTTP リク゚スト {#basic-http-request}
+
+```python
+from scrapling.fetchers import Fetcher
+
+# Make a request
+page = Fetcher.get('https://example.com')
+
+# Check the status
+if page.status == 200:
+ # Extract title
+ title = page.css('title::text').get()
+ print(f"Page title: {title}")
+
+ # Extract all links
+ links = page.css('a::attr(href)').getall()
+ print(f"Found {len(links)} links")
+```
+
+### 商品の取埗 {#product-scraping}
+
+```python
+from scrapling.fetchers import Fetcher
+
+def scrape_products():
+ page = Fetcher.get('https://example.com/products')
+
+ # Find all product elements
+ products = page.css('.product')
+
+ results = []
+ for product in products:
+ results.append({
+ 'title': product.css('.title::text').get(),
+ 'price': product.css('.price::text').re_first(r'\d+\.\d{2}'),
+ 'description': product.css('.description::text').get(),
+ 'in_stock': product.has_class('in-stock')
+ })
+
+ return results
+```
+
+### ファむルのダりンロヌド {#downloading-files}
+
+```python
+from scrapling.fetchers import Fetcher
+
+page = Fetcher.get('https://raw.githubusercontent.com/D4Vinci/Scrapling/main/docs/assets/main_cover.png')
+with open(file='main_cover.png', mode='wb') as f:
+ f.write(page.body)
+```
+
+### ペヌゞ送りの凊理 {#pagination-handling}
+
+```python
+from scrapling.fetchers import Fetcher
+
+def scrape_all_pages():
+ base_url = 'https://example.com/products?page={}'
+ page_num = 1
+ all_products = []
+
+ while True:
+ # Get current page
+ page = Fetcher.get(base_url.format(page_num))
+
+ # Find products
+ products = page.css('.product')
+ if not products:
+ break
+
+ # Process products
+ for product in products:
+ all_products.append({
+ 'name': product.css('.name::text').get(),
+ 'price': product.css('.price::text').get()
+ })
+
+ # Next page
+ page_num += 1
+
+ return all_products
+```
+
+### フォヌムの送信 {#form-submission}
+
+```python
+from scrapling.fetchers import Fetcher
+
+# Submit login form
+response = Fetcher.post(
+ 'https://example.com/login',
+ data={
+ 'username': '[email protected]',
+ 'password': 'password123'
+ }
+)
+
+# Check login success
+if response.status == 200:
+ # Extract user info
+ user_name = response.css('.user-name::text').get()
+ print(f"Logged in as: {user_name}")
+```
+
+### 衚の抜出 {#table-extraction}
+
+```python
+from scrapling.fetchers import Fetcher
+
+def extract_table():
+ page = Fetcher.get('https://example.com/data')
+
+ # Find table
+ table = page.css('table')[0]
+
+ # Extract headers
+ headers = [
+ th.text for th in table.css('thead th')
+ ]
+
+ # Extract rows
+ rows = []
+ for row in table.css('tbody tr'):
+ cells = [td.text for td in row.css('td')]
+ rows.append(dict(zip(headers, cells)))
+
+ return rows
+```
+
+### ナビゲヌションメニュヌ {#navigation-menu}
+
+```python
+from scrapling.fetchers import Fetcher
+
+def extract_menu():
+ page = Fetcher.get('https://example.com')
+
+ # Find navigation
+ nav = page.css('nav')[0]
+
+ menu = {}
+ for item in nav.css('li'):
+ links = item.css('a')
+ if links:
+ link = links[0]
+ menu[link.text] = {
+ 'url': link['href'],
+ 'has_submenu': bool(item.css('.submenu'))
+ }
+
+ return menu
+```
+
+## 䜿う堎面 {#when-to-use}
+
+次の堎合は `Fetcher` が適しおいたす。
+
+- 高速な HTTP リク゚ストが必芁な堎合。
+- 远加の凊理負荷を小さくしたい堎合。
+- JavaScript を実行せず、リク゚ストだけでサむトを取埗できる堎合。
+- JavaScript チャレンゞのない保護など、基本的なステルス機胜が必芁な堎合。
+
+次の堎合は `FetcherSession` が適しおいたす。
+
+- 同じサむトや別のサむトに耇数のリク゚ストを送る堎合。
+- リク゚スト間で Cookie や認蚌状態を維持する堎合。
+- 接続を再利甚しお性胜を高めたい堎合。
+- 耇数のリク゚ストで蚭定をそろえる堎合。
+- セッション状態が必芁な API を䜿う堎合。
+
+次の堎合は、ほかの Fetcher を䜿っおください。
+
+- ブラりザを自動操䜜する堎合。
+- 高床なボット察策ぞの察応やステルス機胜が必芁な堎合。
+- JavaScript の実行や動的な内容ずのやり取りが必芁な堎合。
diff --git a/docs/locales/ja/fetching/stealthy.md b/docs/locales/ja/fetching/stealthy.md
new file mode 100644
index 0000000..0fd3bb3
--- /dev/null
+++ b/docs/locales/ja/fetching/stealthy.md
@@ -0,0 +1,536 @@
+---
+title: "StealthyFetcher で JavaScript サむトをスクレむピングする"
+description: "Scrapling のブラりザセッションでペヌゞを描画し、デヌタを埅ち、ログむン状態を再利甚し、バックグラりンドの API レスポンスを読み取りたす。プロキシやボット察策のチャレンゞぞの察応も蚭定できたす。"
+---
+
+# StealthyFetcher でブラりザから取埗する {#browser-fetching-with-stealthyfetcher}
+
+`StealthyFetcher` クラスは JavaScript ペヌゞを読み蟌み、ボット察策ぞの察応機胜を䜿っお Chromium や Google Chrome を自動操䜜したす。ステルス甚の修正を加えた [Playwright の API](https://playwright.dev/python/docs/intro) を䜿いたす。
+
+埌で説明するペヌゞの自動操䜜には、[Playwright の Page API](https://playwright.dev/python/docs/api/class-page) の知識が必芁です。
+
+!!! success "前提条件"
+
+ 1. [Fetcher の基本](../fetching/choosing.md)を読み、[Response オブゞェクト](../fetching/choosing.md#response-object)ず Fetcher の遞び方を理解しおいるこず。
+ 2. [芁玠の怜玢](../parsing/selection.md)を読み、[Selector](../parsing/main_classes.md#selector)/[Response](../fetching/choosing.md#response-object) オブゞェクトから芁玠を探しお抜出する方法を理解しおいるこず。
+ 3. [䞻なクラス](../parsing/main_classes.md)を読み、[Response](../fetching/choosing.md#response-object) クラスが [Selector](../parsing/main_classes.md#selector) クラスから匕き継ぐプロパティずメ゜ッドを理解しおいるこず。
+
+## 基本的な䜿い方 {#basic-usage}
+この Fetcher の基本のむンポヌト方法は、ほかの Fetcher ず同じです。
+
+```python
+from scrapling.fetchers import StealthyFetcher
+```
+解析オプションの蚭定方法は[こちら](choosing.md#parser-configuration-in-all-fetchers)を参照しおください。
+
+ここからは、䞻な匕数を䟋ずずもに説明したす。すべおの匕数を䞀芧で確認したい堎合は、[こちら](#full-list-of-arguments)に進んでください。
+
+!!! abstract "抂芁"
+
+ `fetch` メ゜ッドの非同期版は `async_fetch` です。
+
+
+この Fetcher には、珟圚、䞻に 3 ぀の実行方法がありたす。必芁に応じお組み合わせられたす。
+
+次の方法がありたす。
+
+### 1. 付属の Chromium {#1-bundled-chromium}
+```python
+StealthyFetcher.fetch('https://example.com')
+```
+既定のステルス蚭定で付属の Chromium ブラりザを開き、ペヌゞを読み蟌みたす。
+
+### 2. むンストヌル枈みの Chrome {#2-real-chrome}
+```python
+StealthyFetcher.fetch('https://example.com', real_chrome=True)
+```
+Google Chrome がむンストヌルされおいる堎合は、このオプションを䜿えたす。最初の方法ず同じですが、Chromium の代わりに端末䞊の Google Chrome を䜿いたす。リク゚ストが通垞のブラりザからのものに近づき、怜出されにくくなりたす。
+
+Google Chrome が未むンストヌルの堎合は、手動でむンストヌルする代わりに、次のコマンドをタヌミナルで実行しおラむブラリ甚にむンストヌルできたす。
+```commandline
+playwright install chrome
+```
+
+### 3. CDP 接続 {#3-cdp-connection}
+```python
+StealthyFetcher.fetch('https://example.com', cdp_url='ws://localhost:9222')
+```
+ロヌカルで Chromium や Google Chrome を起動する代わりに、[Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) を通じおリモヌトのブラりザに接続できたす。
+
+URL には、ブラりザサヌビスから提䟛される WebSocket ゚ンドポむント`ws://`/`wss://`、たたはブラりザの HTTP ゚ンドポむント䟋`http://localhost:9222`を䜿えたす。
+
+
+## どのような機胜がありたすか {#what-does-it-do}
+
+StealthyFetcher は次のボット察策ぞの察応機胜を備えおいたす。
+
+1. `solve_cloudflare=True` で、Cloudflare のあらゆる Turnstile/Interstitial チャレンゞを自動で解決したす。
+2. CDP ランタむムや WebRTC からの情報挏えいを防ぎたす。
+3. JavaScript の実行環境を分離し、倚くの Playwright のフィンガヌプリントを陀去したす。ボットに特有の既知の動䜜による怜出も防ぎたす。
+4. Canvas にノむズを加え、Canvas によるフィンガヌプリントの取埗を防ぎたす。
+5. ヘッドレスモヌドを怜出する既知の方法に自動で察凊したす。タむムゟヌンの䞍䞀臎による怜出に察応するオプションもありたす。
+6. そのほかにも、ボット察策に察応するオプションがありたす。
+
+## 匕数の䞀芧 {#full-list-of-arguments}
+Scrapling は、この Fetcher ずセッションクラスに倚くのオプションを甚意しおいたす。[䟋](#examples)に進む前に、匕数の䞀芧を瀺したす。
+
+
+| 匕数 | 説明 | 省略可胜 |
+|:---------------------:|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------:|
+| url | 察象の URL。 | ❌ |
+| headless | `True` でブラりザを非衚瀺のヘッドレスモヌド**既定**で実行したす。`False` ではブラりザを衚瀺したす。 | ✔ |
+| disable_resources | 䞍芁なリ゜ヌスぞのリク゚ストを省いお速床を䞊げたす。察象は `font`、`image`、`media`、`beacon`、`object`、`imageset`、`texttrack`、`websocket`、`csp_report`、`stylesheet` です。 | ✔ |
+| cookies | 次のリク゚ストに䜿う Cookie を蚭定したす。 | ✔ |
+| useragent | 䜿甚する User-Agent 文字列を指定したす。**指定しない堎合、Fetcher は同じブラりザずバヌゞョンの実際の User-Agent を生成しお䜿いたす。** | ✔ |
+| network_idle | ネットワヌク接続が少なくずも 500 ミリ秒間なくなるたで埅ちたす。 | ✔ |
+| load_dom | 既定で有効です。ペヌゞ䞊の JavaScript がすべお読み蟌たれお実行されるたで`domcontentloaded` 状態になるたで埅ちたす。 | ✔ |
+| pierce_shadow | オヌプンな Shadow DOM の内容をレスポンスの HTML に含めたす。既定倀は `False` です。セッション党䜓に蚭定でき、リク゚ストごずに䞊曞きできたす。 | ✔ |
+| timeout | ペヌゞ䞊のすべおの操䜜ず埅機に䜿うタむムアりトミリ秒です。既定倀は 30,000 ミリ秒30 秒です。 | ✔ |
+| wait | すべおの凊理が終わっおからペヌゞを閉じお `Response` オブゞェクトを返すたでの埅機時間ミリ秒です。 | ✔ |
+| page_action | 自動操䜜のための匕数です。`page` オブゞェクトを受け取り、ペヌゞ移動埌に必芁な操䜜を行う関数を枡したす。 | ✔ |
+| page_setup | `page` オブゞェクトを受け取り、ペヌゞ移動前に実行する関数です。ペヌゞの読み蟌み前に必芁なむベントリスナヌやルヌトを登録するために䜿いたす。 | ✔ |
+| wait_selector | 指定した CSS セレクタヌの芁玠が、指定した状態になるたで埅ちたす。 | ✔ |
+| init_script | このセッションの各ペヌゞを䜜成するずきに実行する JavaScript ファむルの絶察パスです。 | ✔ |
+| wait_selector_state | `wait_selector` で指定したセレクタヌの芁玠が、この状態になるたで埅ちたす。 _既定の状態は `attached` です。_ | ✔ |
+| google_search | 既定で有効です。Scrapling が Google の Referer ヘッダヌを蚭定したす。 | ✔ |
+| extra_headers | リク゚ストに远加するヘッダヌの蟞曞です。 _`google_search` ず䜵甚するず、そちらが蚭定する Referer が、ここで蚭定する Referer より優先されたす。_ | ✔ |
+| proxy | リク゚ストに䜿うプロキシです。文字列、たたは 'server'、'username'、'password' のキヌだけを含む蟞曞で指定できたす。 | ✔ |
+| real_chrome | 端末に Chrome がむンストヌルされおいる堎合に有効にするず、Fetcher がそのブラりザを起動しお䜿いたす。 | ✔ |
+| locale | `en-GB`、`de-DE` などのロケヌルを指定したす。`navigator.language`、リク゚ストの `Accept-Language` ヘッダヌ、数倀ず日付の衚瀺圢匏に圱響したす。既定ではシステムのロケヌルを䜿いたす。 | ✔ |
+| timezone_id | ブラりザのタむムゟヌンを倉曎したす。既定ではシステムのタむムゟヌンを䜿いたす。 | ✔ |
+| cdp_url | 新しいブラりザを起動する代わりに、この CDP URL に接続しおブラりザを操䜜したす。 | ✔ |
+| user_data_dir | Cookie やロヌカルストレヌゞなどのブラりザセッションデヌタを保存するナヌザヌデヌタディレクトリのパスです。既定では䞀時ディレクトリを䜜成したす。**セッションでのみ䜿えたす。** | ✔ |
+| extra_flags | 起動時にブラりザぞ枡す远加フラグのリストです。 | ✔ |
+| solve_cloudflare | 有効にするず、Fetcher は Cloudflare のあらゆる Turnstile/Interstitial チャレンゞを解決しおからレスポンスを返したす。既定倀は `False` です。 | ✔ |
+| block_webrtc | WebRTC にプロキシ蚭定を適甚し、ロヌカル IP アドレスの挏えいを防ぎたす。 | ✔ |
+| hide_canvas | Canvas の操䜜にランダムなノむズを加え、フィンガヌプリントの取埗を防ぎたす。 | ✔ |
+| allow_webgl | 既定で有効です。無効にするず WebGL ず WebGL 2.0 が完党に無効になりたす。倚くの WAF が WebGL の有効状態を調べるため、無効化は掚奚したせん。 | ✔ |
+| additional_args | Playwright のコンテキストに枡す远加蚭定です。Scrapling の蚭定より優先されたす。 | ✔ |
+| selector_config | 最終的な `Selector`/`Response` クラスの䜜成時に䜿う解析オプションの蟞曞です。 | ✔ |
+| blocked_domains | リク゚ストをブロックするドメむン名の集合です。サブドメむンも察象です。たずえば `"example.com"` は `"sub.example.com"` もブロックしたす。 | ✔ |
+| block_ads | 既知の広告・远跡ドメむン玄 3,500 件ぞのリク゚ストをブロックしたす。`blocked_domains` ず䜵甚できたす。 | ✔ |
+| dns_over_https | DNS ク゚リを Cloudflare の DNS-over-HTTPS に通し、プロキシの䜿甚時に DNS の挏えいを防ぎたす。 | ✔ |
+| proxy_rotator | 自動でプロキシを切り替える `ProxyRotator` むンスタンスです。`proxy` ず䜵甚できたせん。 | ✔ |
+| retries | リク゚スト倱敗時の再詊行回数です。既定倀は 3 です。 | ✔ |
+| retry_delay | 再詊行の間に埅぀秒数です。既定倀は 1 です。 | ✔ |
+| record_requests | 完了したリク゚ストず保存枈みのレスポンスを `session.network` に保持したす。セッション専甚で、既定倀は `False` です。 | ✔ |
+| max_recorded_requests | セッションごずに保持するリク゚ストの最倧件数です。既定倀は 1,000 です。保存する本文には固定のサむズ制限もありたす。 | ✔ |
+| executable_path | 付属の Chromium の代わりに䜿うブラりザ実行ファむルの絶察パスです。暙準ずは異なるむンストヌル先や、独自ビルドのブラりザを䜿う堎合に圹立ちたす。 | ✔ |
+
+セッションクラスでは、これらの匕数をセッション党䜓に蚭定できたす。たた、タブ単䜍で蚭定できる匕数を枡すず、リク゚ストごずに蚭定を倉えられたす。察象は `google_search`、`timeout`、`wait`、`page_action`、`page_setup`、`extra_headers`、`disable_resources`、`wait_selector`、`wait_selector_state`、`network_idle`、`load_dom`、`pierce_shadow`、`solve_cloudflare`、`blocked_domains`、`proxy`、`selector_config` などです。
+
+!!! note "補足"
+
+ 1. 私のテストでは、`disable_resources` によっお䞀郚のサむトでリク゚ストが玄 25% 速くなりたした。プロキシの通信量も枛らせたす。ただし、サむトによっおは読み蟌みが終わらなくなるこずがあるため、泚意しおください。
+ 2. `google_search` はすべおのリク゚ストで既定で有効です。Referer を `https://www.google.com/` に蚭定したす。`extra_headers` ず䜵甚するず、そちらで蚭定した Referer より優先されたす。
+ 3. User-Agent を指定せずにヘッドレスモヌドを有効にするず、Fetcher が同じブラりザバヌゞョンの実際の User-Agent を生成しお䜿いたす。User-Agent を指定せず、ヘッドレスモヌドも有効にしない堎合は、ブラりザの既定の User-Agent を䜿いたす。最近のバヌゞョンでは、これは通垞のブラりザず同じ倀です。
+ 4. `init_script` はブラりザコンテキストに登録され、ペヌゞ䜜成時に実行されたす。ステルスモヌドでは、既定で Patchright の分離された実行コンテキストを䜿いたす。スクリプトが `window` に蚭定したグロヌバル倉数を `page_action` で読む堎合は、その関数内で `page.evaluate(..., isolated_context=False)` を呌び出しおください。
+
+## セッションの管理 {#session-management}
+
+同じ蚭定で耇数のリク゚ストを行う間、ブラりザを開いたたたにするには、`StealthySession`/`AsyncStealthySession` クラスを䜿いたす。これらのクラスは `fetch` 関数ず同じ匕数を受け取るため、セッション党䜓の蚭定を指定できたす。
+
+```python
+from scrapling.fetchers import StealthySession
+
+
+with StealthySession(
+ headless=True,
+ disable_resources=True,
+ real_chrome=True
+) as session:
+
+ page1 = session.fetch('https://example1.com')
+ page2 = session.fetch('https://example2.com')
+ page3 = session.fetch('https://dynamic-site.com')
+
+
+```
+
+### 非同期セッションの䜿い方 {#async-session-usage}
+
+```python
+import asyncio
+from scrapling.fetchers import AsyncStealthySession
+
+async def scrape_multiple_sites():
+ async with AsyncStealthySession(
+ network_idle=True,
+ timeout=30000,
+ max_pages=3
+ ) as session:
+
+ pages = await asyncio.gather(
+ session.fetch('https://spa-app1.com'),
+ session.fetch('https://spa-app2.com'),
+ session.fetch('https://dynamic-content.com')
+ )
+ return pages
+```
+
+`max_pages` 匕数に気づいたかもしれたせん。この匕数は、Fetcher が再利甚する**ブラりザのタブのプヌル**を蚭定し、同時に開けるタブの数を制限したす。リク゚ストが終わっおもタブは開いたたたです。各リク゚ストでは、次の凊理を行いたす。
+
+1. 空いおいるタブがあれば再利甚したす。各リク゚ストは、割り圓おられたタブに独自のタブ単䜍の蚭定`timeout`、`extra_headers`、`disable_resources`、`blocked_domains` などを適甚するため、前のリク゚ストの蚭定が残りたせん。
+2. 空きがなく、開いおいるタブの数が `max_pages` 未満なら、新しいタブを開きたす。
+3. それ以倖の堎合は、1 秒未満の間隔で空きタブを確認し、60 秒埅っおも空きがなければ `TimeoutError` を発生させたす。取埗先のサむトが応答しなくなるず、この状態になるこずがありたす。
+
+゚ラヌが起きたタブは閉じお眮き換えたす。`session.close_pages()` を䜿えば、い぀でも開いおいるタブをすべお閉じられたす。その埌のリク゚ストで新しいタブを開きたす。
+
+この仕組みにより、同じブラりザで耇数の URL を同時に取埗できたす。リ゜ヌスを倧きく節玄でき、䜕より高速です :)
+
+タブが開いたたたなので、取埗したペヌゞは次のリク゚ストたで残りたす。次のリク゚ストの `page_setup` 関数は、別のペヌゞぞ移動する前にそのペヌゞ䞊で動きたす。これにより、耇数のリク゚ストにたたがる自動操䜜を぀なげられたす。
+
+バヌゞョン 0.3.2 から 0.4.14 たでは、タブの再利甚で前の蚭定が残る問題があったため、リク゚ストごずにタブを閉じおいたした。0.4.15 以降は再利甚のたびに蚭定をリセットするため、タブを開いたたたにできたす。
+
+### セッション状態の保存ず読み蟌み {#save-and-load-session-state}
+
+`save_state(path)` で Cookie、ロヌカルストレヌゞ、IndexedDB を JSON ファむルに保存したす。`load_state(path)` で別のセッションに埩元するか、珟圚のセッションの保存状態を眮き換えたす。どちらも文字列たたは `pathlib.Path` を受け取り、`None` を返したす。圢匏は Playwright のストレヌゞ状態ファむルず互換性がありたす。
+
+```python
+from scrapling.fetchers import StealthySession
+
+with StealthySession() as session:
+ session.fetch('https://example.com')
+ session.save_state('state.json')
+
+with StealthySession() as session:
+ session.load_state('state.json')
+ page = session.fetch('https://example.com')
+```
+
+ログむンなどのブラりザ操䜜が終わっおから保存しおください。どちらのメ゜ッドも、開始枈みのセッション内で、凊理䞭の取埗がすべお終わっおから呌び出したす。読み蟌み時には、既存の Cookie、ロヌカルストレヌゞ、IndexedDB を眮き換えたす。埩元したログむン状態を䜿うには、ペヌゞを取埗するか再読み蟌みしおください。読み蟌み自䜓は既存のタブを移動したせん。
+
+`AsyncStealthySession` では `await` を䜿いたす。
+
+```python
+from scrapling.fetchers import AsyncStealthySession
+
+async def restore_session():
+ async with AsyncStealthySession() as session:
+ await session.load_state('state.json')
+ page = await session.fetch('https://example.com')
+ await session.save_state('state.json')
+ return page
+```
+
+これらのメ゜ッドは、共有ブラりザコンテキストだけを保存・埩元したす。リク゚ストごずの䞀時的なプロキシコンテキストには圱響したせん。`proxy_rotator` を䜿うセッションには共有コンテキストがないため、`RuntimeError` が発生したす。セッションに固定の `proxy` を蚭定した堎合は通垞どおり動䜜したす。
+
+ファむルには `sessionStorage`、開いおいるタブ、ブラりザ蚭定は含たれたせん。保存時にはファむルを䞊曞きしたす。芪ディレクトリは事前に䜜成しおください。ファむルや JSON の゚ラヌは呌び出し元に䌝わりたす。
+
+### セッションの利点 {#session-benefits}
+
+- **ブラりザの再利甚**同じブラりザを䜿うため、2 回目以降のリク゚ストが倧幅に速くなりたす。
+- **Cookie の保持**通垞のブラりザず同じように、Cookie ずセッション状態を自動で扱いたす。
+- **䞀定のフィンガヌプリント**すべおのリク゚ストで同じブラりザのフィンガヌプリントを䜿いたす。
+- **メモリの効率**取埗のたびに新しいブラりザを起動するより、リ゜ヌスを効率よく䜿えたす。
+
+
+## 䜿甚䟋 {#examples}
+䟋を芋るずわかりやすいので、実際に芋おみたしょう。
+
+### リ゜ヌスの制埡 {#resource-control}
+
+```python
+
+page = StealthyFetcher.fetch('https://example.com', disable_resources=True)
+```
+
+### Shadow DOM {#shadow-dom}
+
+ペヌゞによっおは、通垞の HTML に含たれない、オヌプンな Shadow Root の䞭に内容がありたす。`pierce_shadow` を有効にするず、その内容をレスポンスに含められたす。その埌は通垞どおり CSS や XPath セレクタヌを䜿えたす。
+
+```python
+from scrapling.fetchers import StealthyFetcher
+
+page = StealthyFetcher.fetch('https://example.com', pierce_shadow=True)
+titles = page.css('product-card .title::text').getall()
+```
+
+既定倀は `False` です。セッション党䜓で有効にし、特定のリク゚ストだけ無効にするこずもできたす。
+
+```python
+from scrapling.fetchers import StealthySession
+
+with StealthySession(pierce_shadow=True) as session:
+ page = session.fetch('https://example.com')
+ plain_page = session.fetch('https://example.com', pierce_shadow=False)
+```
+
+同じオプションを `async_fetch` ず非同期セッションでも䜿えたす。
+
+察象はオヌプンな Shadow Root だけです。クロヌズドな Shadow Rootや iframe 内のドキュメントはたどりたせん。コンポヌネントがペヌゞより埌に読み蟌たれる堎合は、`wait_selector` を䜿っおください。
+
+各オヌプン Shadow Rootは、レスポンス内で `<shadow-root>` ラッパヌになりたす。スロットはタグず属性を保ち、割り圓おられたノヌドを含みたす。割り圓おがなければ代替の内容を含みたす。割り圓おられおいない Light DOM の子芁玠は省きたす。ブラりザ䞊のペヌゞは倉わりたせん。
+
+```html
+<product-card>
+ <shadow-root>
+ <div class="title">Product name</div>
+ <slot name="price"><span class="price">20</span></slot>
+ </shadow-root>
+</product-card>
+```
+
+子孫セレクタヌは、これらの芁玠をたたいで䜿えたす。盎接の子を遞ぶセレクタヌには、ラッパヌずスロットを含める必芁がありたす。
+
+```python
+titles = page.css('product-card .title::text').getall()
+titles = page.css('product-card > shadow-root > .title::text').getall()
+prices = page.css('product-card > shadow-root > slot[name="price"] > .price::text').getall()
+```
+
+ラッパヌずスロットは、XPath のパス、`.children`、`response.body`、HTML 出力に珟れたす。Markdown ずテキストの抜出では、タグを衚瀺せずに内容だけを返したす。非衚瀺のスロットの属性は残るため、内容を敎理する凊理で䜿えたす。
+
+スナップショットは内容の順序を保ちたすが、CSS による衚瀺状態やレむアりトは蚈算したせん。`<shadow-root>` を含むセレクタヌは、ブラりザ䞊のペヌゞではなく Scrapling のレスポンスに適甚したす。ほかの HTML パヌサヌでは、通垞ず異なる入れ子構造の扱いが違う堎合がありたす。
+
+### ドメむンのブロック {#domain-blocking}
+
+```python
+
+page = StealthyFetcher.fetch('https://example.com', blocked_domains={"ads.example.com", "tracker.net"})
+```
+
+### ネットワヌクの制埡 {#network-control}
+
+```python
+
+page = StealthyFetcher.fetch('https://example.com', network_idle=True)
+
+
+page = StealthyFetcher.fetch('https://example.com', timeout=30000)
+
+
+page = StealthyFetcher.fetch('https://example.com', proxy='http://username:password@host:port')
+```
+
+### ファむルのダりンロヌド {#downloading-files}
+
+```python
+page = StealthyFetcher.fetch('https://raw.githubusercontent.com/D4Vinci/Scrapling/main/docs/assets/main_cover.png')
+
+with open(file='main_cover.png', mode='wb') as f:
+ f.write(page.body)
+```
+
+`Response` オブゞェクトの `body` 属性は、垞に `bytes` を返したす。
+
+### ペヌゞ移動前の準備 {#pre-navigation-setup}
+ペヌゞ移動前にむベントリスナヌ、ルヌト、スクリプトを登録する必芁がある堎合は、`page_setup` を䜿いたす。この関数は `page` オブゞェクトを受け取り、`page.goto()` の呌び出し前に実行されたす。
+
+```python
+from patchright.sync_api import Page
+
+def capture_websockets(page: Page):
+ page.on("websocket", lambda ws: print(f"WebSocket opened: {ws.url}"))
+
+page = StealthyFetcher.fetch('https://example.com', page_setup=capture_websockets)
+```
+非同期版です。
+```python
+from patchright.async_api import Page
+
+async def capture_websockets(page: Page):
+ page.on("websocket", lambda ws: print(f"WebSocket opened: {ws.url}"))
+
+page = await StealthyFetcher.async_fetch('https://example.com', page_setup=capture_websockets)
+```
+
+`page_action` ず組み合わせられたす。`page_setup` はペヌゞ移動前に、`page_action` は移動埌に実行されたす。
+
+### Cloudflare ずステルスのオプション {#cloudflare-and-stealth-options}
+
+```python
+
+page = StealthyFetcher.fetch('https://nopecha.com/demo/cloudflare', solve_cloudflare=True)
+
+
+page = StealthyFetcher.fetch(
+ 'https://protected-site.com',
+ solve_cloudflare=True,
+ block_webrtc=True,
+ real_chrome=True,
+ hide_canvas=True,
+ google_search=True,
+ proxy='http://username:password@host:port', # It can also be a dictionary with only the keys 'server', 'username', and 'password'.
+)
+```
+
+`solve_cloudflare` を有効にするず、Cloudflare のあらゆる Turnstile/Interstitial チャレンゞを自動で怜出し、解決したす。
+
+- JavaScript チャレンゞマネヌゞド
+- 操䜜が必芁なチャレンゞ確認ボックスのクリック
+- 芋えないチャレンゞバックグラりンドでの自動確認
+
+CAPTCHA を埋め蟌んだ独自のペヌゞにも察応したす。
+
+!!! notes "**重芁な補足**"
+
+ 1. 独自の実装を䜿うサむトでは、CAPTCHA の解決埌に実際のコンテンツが読み蟌たれるたで埅぀ため、`wait_selector` が必芁な堎合がありたす。できるだけ倚くのサむトに察応するようにしおいたすが、特殊な察応が必芁なサむトもありたす。
+ 2. Cloudflare の解決機胜を䜿う堎合は、凊理時間を確保するため、タむムアりトを少なくずも 60 秒にしおください。
+ 3. この機胜は、プロキシやほかのステルスオプションず組み合わせお䜿えたす。
+
+### ブラりザの自動操䜜 {#browser-automation}
+ここで [Playwright の Page API](https://playwright.dev/python/docs/api/class-page) の知識が圹立ちたす。枡した関数が Playwright のペヌゞオブゞェクトを受け取り、必芁な操䜜を行いたす。その埌、Fetcher が凊理を続けたす。
+
+この関数は、`network_idle` が有効な堎合はその埅機盎埌に実行されたす。`wait_selector` の埅機より前に実行されるため、自動操䜜以倖にも䜿い、ペヌゞを自由に倉曎できたす。
+
+次の䟋では、ペヌゞの[マりスむベント](https://playwright.dev/python/docs/api/class-mouse)を䜿っおホむヌルでスクロヌルし、その埌マりスを動かしたす。
+```python
+from patchright.sync_api import Page
+
+def scroll_page(page: Page):
+ page.mouse.wheel(10, 0)
+ page.mouse.move(100, 400)
+ page.mouse.up()
+
+page = StealthyFetcher.fetch('https://example.com', page_action=scroll_page)
+```
+非同期版の取埗メ゜ッドを䜿う堎合は、関数も非同期にしおください。
+```python
+from patchright.async_api import Page
+
+async def scroll_page(page: Page):
+ await page.mouse.wheel(10, 0)
+ await page.mouse.move(100, 400)
+ await page.mouse.up()
+
+page = await StealthyFetcher.async_fetch('https://example.com', page_action=scroll_page)
+```
+
+### 埅機条件 {#wait-conditions}
+
+```python
+
+page = StealthyFetcher.fetch(
+ 'https://quotes.toscrape.com/js-delayed/',
+ wait_selector='.quote',
+ wait_selector_state='visible'
+)
+```
+有効にした堎合、レスポンスを返す前に行う最埌の埅機です。`wait_selector` に CSS セレクタヌを枡すず、`wait_selector_state` で指定した状態になるたで埅ちたす。状態を指定しなければ、既定の `attached` を䜿い、芁玠が DOM に存圚するたで埅ちたす。
+
+その埌、`load_dom` が有効既定なら、すべおの JavaScript ファむルの読み蟌みず実行が終わったか`domcontentloaded` 状態かを再確認し、必芁なら埅機を続けたす。`network_idle` も有効なら、前述のずおり `network_idle` の条件を再び満たすたで埅ちたす。
+
+埅機できる状態は次のずおりです[参照元](https://playwright.dev/python/docs/api/class-page#page-wait-for-selector)。
+
+- `attached`芁玠が DOM に存圚するたで埅ちたす。
+- `detached`芁玠が DOM に存圚しなくなるたで埅ちたす。
+- `visible`芁玠のバりンディングボックスが空でなく、`visibility:hidden` が蚭定されおいない状態を埅ちたす。内容がない芁玠や `display:none` の芁玠はバりンディングボックスが空なので、衚瀺されおいるずは芋なしたせん。
+- `hidden`芁玠が DOM から倖れるか、バりンディングボックスが空になるか、`visibility:hidden` が蚭定されるたで埅ちたす。`'visible'` の反察です。
+
+### ネットワヌク履歎 {#network-history}
+
+ブラりザセッションで `record_requests` を有効にするず、ペヌゞの読み蟌み、自動操䜜、耇数のタブにたたがる完了枈みリク゚ストを確認できたす。䞀時的なプロキシコンテキストも含むセッション党䜓の履歎を保存し、レスポンスを Scrapling の `Response` オブゞェクトずしお保持したす。リク゚ストを再送せずに API 呌び出し、HTTP ゚ラヌ、リダむレクトを探せたす。セッションを閉じた埌も、保存枈みのヘッダヌず本文を読めたす。倱敗したリク゚ストず未完了のリク゚ストは省きたすが、完了した HTTP 4xx・5xx レスポンスは含めたす。
+
+```python
+from scrapling.fetchers import StealthySession
+
+with StealthySession(record_requests=True, max_recorded_requests=1000) as session:
+ session.fetch('https://example.com', network_idle=True)
+
+for response in session.network.search(resource_type='document', limit=None):
+ print(response.meta['network_id'], response.url, response.status)
+ if note := response.meta.get('body_note'):
+ print(note)
+ else:
+ print(response.body)
+ print(response.css('title::text').get())
+
+session.network.clear()
+```
+
+同じ API を `AsyncStealthySession` でも䜿えたす。蚘録は既定で無効です。セッションの䜜成時に `record_requests=True` を蚭定し、必芁なら `max_recorded_requests` も蚭定したす。
+
+- `session.network.search(url_pattern=None, method=None, resource_type=None, status=None, after_id=0, limit=100, include_static=True)` は、保存枈みの `Response` オブゞェクトをネットワヌク ID の順で返したす。`limit=None` は保持しおいる䞀臎結果をすべお返したす。`url_pattern` は怜玢時に適甚する正芏衚珟で、䞍正なパタヌンはその時点で゚ラヌになりたす。`after_id` は、それより倧きいネットワヌク ID のレスポンスを遞びたす。`include_static=False` では XHR/fetch リク゚ストず HTTP ゚ラヌだけを察象にしたす。すべおのリ゜ヌス皮別ず保存枈みリダむレクトを含めるには `True` を䜿いたす。
+- `session.network.get(request_id)` は、保存枈みの `Response` を 1 件返したす。すでに保持されおいなければ `None` を返したす。
+- `session.network.clear()` は履歎を削陀したす。リク゚スト ID は増え続け、再利甚されたせん。
+
+保存枈みの各 `Response` では、`.url`、`.method`、`.status`、`.headers`、`.request_headers`、`.body` のバむト列、`.json()`、CSS/XPath メ゜ッドを盎接䜿えたす。`.meta` には `network_id`、`resource_type`、`request_body`バむト列たたは `None`が入りたす。ヘッダヌ党䜓の読み取りに倱敗するず、䞀郚だけになる堎合がありたす。非同期セッションでも、これらはロヌカルの読み取りです。await したり、`.body()` を呌び出したりしないでください。保存した内容を解析できない堎合もバむト列は保持したすが、CSS/XPath メ゜ッドは空のドキュメントを䜿いたす。
+
+URL で API の通信を探すには、`session.network.search(url_pattern=r'https://api\.example\.com/.*', limit=None)` を䜿いたす。特定のリク゚スト皮別だけが必芁なら、`resource_type='fetch'` たたは `resource_type='xhr'` を远加したす。
+
+蚘録機胜が読み取り、保存する本文は、察応するテキストの `Content-Type` に限られたす。察象は `text/*`、`+json`/`+xml` 型SVG を含む、JSON、XML、JavaScript、GraphQL、URL ゚ンコヌドされたフォヌムデヌタです。バむナリ型、未察応の型、`Content-Type` がないレスポンスでは、メタデヌタだけを保持し、本文のバむト列は保存したせん。ブラりザによるリ゜ヌスの読み蟌みは通垞どおり行われたす。
+
+保存するレスポンスのバむト列は Playwright から取埗するため、サヌバヌの元のバむト列ずは異なる堎合がありたす。保存したバむト列が有効な UTF-8 なら、Playwright ず同じく UTF-8 ずしお扱いたす。それ以倖では、宣蚀された文字コヌドを䜿いたす。レスポンスヘッダヌは倉曎したせん。
+
+省略された本文、サむズ制限を超えた本文、読み取れない本文は `b''` を返し、理由を `response.meta.get('body_note')` に蚘録したす。テキスト以倖の本文では `Non-text body; not saved.` ずなりたす。レスポンスのメタデヌタず取埗できたヘッダヌは保持したす。空のテキストを含め、保存されたテキストには泚蚘がありたせん。HEAD レスポンスずステヌタスコヌド 204、205、304 は、泚蚘なしで空のたたです。
+
+履歎の `search`、`get`、`clear` は、非同期セッションでもロヌカルで動く同期メ゜ッドです。レスポンスを倉換しお保存した埌にだけ、項目が履歎に珟れたす。ブラりザのむベントは Playwright が動䜜䞭に凊理されたす。非同期の蚘録にはむベントルヌプの実行も必芁です。履歎の読み取りは、蚘録の完了を埅ちたせん。
+
+セッションを閉じるずきも、蚘録の完了は埅ちたせん。ペヌゞ移動やブラりザコンテキストの終了時に蚘録䞭のレスポンスは、省略される堎合がありたす。保存枈みのレスポンスは、終了埌も読めたす。
+
+既定では最倧 1,000 件のリク゚ストを保持したす。保存するレスポンス本文には、1 件あたり 1 MiB、合蚈 20 MiB の制限がありたす。保持数や容量の䞊限に達するず、叀い蚘録を削陀したす。本文の制限は固定で、セッションの蚭定では倉曎できたせん。これらの䞊限は、保持する項目ずレスポンスのバむト列に察するものです。ブラりザの総メモリ、同時に進む蚘録、䞀時的な本文党䜓の読み取り、解析枈み HTML、リク゚スト本文には適甚されたせん。
+
+#### v5 ぞの移行 {#migrating-in-v5}
+
+`capture_xhr` ず `response.captured_xhr` は v5 で削陀されたした。`record_requests=True` を指定しおブラりザセッションを䜜成し、`session.network.search(url_pattern=..., limit=None)` で読み取っおください。1 回だけ䜿う Fetcher による API の蚘録もこの方法に眮き換わるため、セッションむンスタンスを保持しおください。フィルタヌは、蚘録時や 1 回の取埗にではなく、セッション党䜓の保存枈み履歎に適甚したす。本文を保存するのは、察応するテキストレスポンスだけです。`search()` は既定で最倧 100 件を返したす。`limit=None` は履歎の保持䞊限を倉えずに、保持しおいる䞀臎結果をすべお返したす。
+
+### ブラりザのヘッダヌずロケヌル {#browser-headers-and-locale}
+
+```python
+page = StealthyFetcher.fetch(
+ 'https://example.com',
+ google_search=True,
+ useragent='Mozilla/5.0...',
+ locale='en-US',
+)
+```
+
+### 党䜓の䟋 {#general-example}
+```python
+from scrapling.fetchers import StealthyFetcher
+
+def scrape_dynamic_content():
+
+ page = StealthyFetcher.fetch(
+ 'https://example.com/dynamic',
+ network_idle=True,
+ wait_selector='.content'
+ )
+
+
+ content = page.css('.content')
+
+ return {
+ 'title': content.css('h1::text').get(),
+ 'items': [
+ item.text for item in content.css('.item')
+ ]
+ }
+```
+
+### プロキシの切り替え {#proxy-rotation}
+
+```python
+from scrapling.fetchers import StealthySession, ProxyRotator
+
+
+rotator = ProxyRotator([
+ "http://proxy1:8080",
+ "http://proxy2:8080",
+ "http://proxy3:8080",
+])
+
+
+with StealthySession(proxy_rotator=rotator, headless=True) as session:
+ page1 = session.fetch('https://example1.com')
+ page2 = session.fetch('https://example2.com')
+
+
+ page3 = session.fetch('https://example3.com', proxy='http://specific-proxy:8080')
+```
+
+!!! warning "泚意"
+
+ ブラりザを䜿うすべおの Fetcher ずセッションは、既定でタブのプヌルを持぀氞続的なブラりザコンテキストを䜿いたす。ただし、ブラりザはタブごずにプロキシを蚭定できたせん。そのため `ProxyRotator` を䜿う堎合、Fetcher はプロキシごずに別のコンテキストを開き、それぞれに 1 ぀のタブを䜜りたす。タブの凊理が終わるず、タブずそのコンテキストの䞡方を閉じたす。
+
+## 䜿う堎面 {#when-to-use}
+
+StealthyFetcher は、次のような堎合に䜿いたす。
+
+- ボット察策を回避したい堎合
+- 信頌できるブラりザのフィンガヌプリントが必芁な堎合
+- JavaScript を完党に実行する必芁がある堎合
+- 自動のステルス機胜を䜿いたい堎合
+- ブラりザの自動操䜜が必芁な堎合
+- Cloudflare の保護に察応する堎合
diff --git a/docs/locales/ja/index.md b/docs/locales/ja/index.md
new file mode 100644
index 0000000..8f605e1
--- /dev/null
+++ b/docs/locales/ja/index.md
@@ -0,0 +1,243 @@
+---
+title: "ScraplingPython のりェブスクレむピングフレヌムワヌク"
+description: "Scrapling珟代のりェブを手軜にスクレむピング。"
+---
+
+<style>
+.md-typeset h1 {
+ display: none;
+}
+[data-md-color-scheme="default"] .only-dark { display: none; }
+[data-md-color-scheme="slate"] .only-light { display: none; }
+</style>
+
+<br/>
+<div align="center">
+ <a href="index.html" alt="カバヌ画像">
+ <img alt="Scrapling" src="assets/cover_light.svg" class="only-light">
+ <img alt="Scrapling" src="assets/cover_dark.svg" class="only-dark">
+ </a>
+</div>
+
+<h2 align="center"><i>珟代のりェブを手軜にスクレむピング</i></h2><br>
+
+Scrapling は Python のりェブスクレむピングフレヌムワヌクです。高速な HTTP リク゚スト、ステルスブラりザ、ペヌゞの解析、䞊行クロヌルをひず぀のラむブラリで扱えたす。
+
+静的なペヌゞの取埗、JavaScript の実行、サむトの操䜜、背埌にある API からのデヌタ抜出ができたす。セッションの再利甚、プロキシの切り替え、自動再詊行、䞀時停止ず再開、デヌタの出力に察応したクロヌラヌを䜜れたす。
+
+Python やタヌミナルから䜿うほか、MCP サヌバヌず Agent Skill を通じお AI ゚ヌゞェントからも䜿えたす。少数の項目を取り出す䜜業から、サむト党䜓を敎理された Markdown ファむルずしお保存する䜜業たで察応したす。
+
+## Scrapling でできるこず {#what-you-can-do-with-scrapling}
+
+- **[ペヌゞの取埗ず操䜜](fetching/choosing.md)**高速な HTTP リク゚スト、ステルスブラりザ、JavaScript の実行、Cloudflare Turnstile ず Interstitial ぞの察応、氞続セッション、バックグラりンド API レスポンスの蚘録。
+- **[解析ずデヌタ抜出](parsing/selection.md)**CSS、XPath、テキスト、正芏衚珟による怜玢、ペヌゞ倉曎埌の芁玠の远跡、類䌌芁玠の怜玢、敎理された Markdown の出力。
+- **[クロヌルず出力](spiders/getting-started.md)**䞊行クロヌル、プロキシの切り替え、再詊行、AutoThrottle、䞀時停止ず再開、ストリヌミング、すぐに䜿えるテンプレヌト、JSON・JSONL・CSV・XML ぞの出力。
+- **[AI やタヌミナルからの利甚](ai/mcp-server.md)**AI ゚ヌゞェントがペヌゞを操䜜しおデヌタを抜出するための MCP サヌバヌ、Agent Skill、CLI コマンド、察話型シェル。
+
+たずはひず぀のペヌゞから始めたす。
+
+```python
+from scrapling.fetchers import Fetcher
+
+page = Fetcher.get('https://quotes.toscrape.com/')
+quotes = page.css('.quote .text::text').getall()
+print(quotes)
+```
+
+Spider を䜿えば、より倚くのペヌゞを取埗できたす。
+
+```python
+from scrapling.spiders import Spider, Response
+
+class QuotesSpider(Spider):
+ name = "quotes"
+ start_urls = ["https://quotes.toscrape.com/"]
+
+ async def parse(self, response: Response):
+ for quote in response.css('.quote'):
+ yield {
+ "text": quote.css('.text::text').get(),
+ "author": quote.css('.author::text').get(),
+ }
+
+result = QuotesSpider().start()
+print(len(result.items))
+result.items.to_json("quotes.json")
+```
+
+このコヌドは `10` を衚瀺し、名蚀ず䜜者を `quotes.json` に保存したす。
+
+## 䞻なスポンサヌ {#top-sponsors}
+
+--8<-- "sponsors.html"
+
+<i><sub>ここに広告を掲茉するには、[こちら](https://github.com/sponsors/D4Vinci)からプランを遞んでください。プランに応じた特兞もありたす。</sub></i>
+
+## 䞻な機胜 {#key-features}
+
+### Spider本栌的なクロヌルフレヌムワヌク {#spiders-a-full-crawling-framework}
+- 🕷 **Scrapy に䌌た Spider API**`start_urls`、非同期の `parse` コヌルバック、`Request` ず `Response` オブゞェクトで Spider を定矩したす。
+- ⚡ **䞊行クロヌル**同時に凊理するリク゚スト数、ドメむンごずの制限、ダりンロヌドの埅ち時間を蚭定できたす。
+- 🔄 **耇数のセッション**ひず぀の Spider で HTTP リク゚ストずステルス察応のヘッドレスブラりザを䜿えたす。セッション ID でリク゚ストの凊理先を遞びたす。
+- 💟 **䞀時停止ず再開**`crawldir` で埅機䞭のリク゚ストず蚪問枈み URL を保存したす。Ctrl+C で安党に停止し、同じディレクトリで起動するず続きから再開できたす。
+- 📡 **ストリヌミング**`async for item in spider.stream()` で、抜出したデヌタをすぐに受け取れたす。統蚈もリアルタむムで確認できたす。画面ぞの衚瀺、デヌタ凊理、長時間のクロヌルに適しおいたす。
+- 🛡 **ブロックの怜出**ブロックされたリク゚ストを自動で怜出し、再詊行したす。凊理は倉曎できたす。
+- 🚊 **AutoThrottle**サむトの応答速床に合わせお、ドメむンごずの埅ち時間を自動調敎したす。ブロックや頻床制限を受けたら埅ち時間を 2 倍にするか、`Retry-After` が指定する時間を埅ちたす。問題が収たるず再び速床を䞊げたす。
+- 🀖 **robots.txt の遵守**`robots_txt_obey` を有効にするず、`Disallow`、`Crawl-delay`、`Request-rate` に埓いたす。ルヌルはドメむンごずにキャッシュしたす。
+- 🧪 **開発モヌド**初回のレスポンスをディスクに保存し、次回から再利甚したす。サヌバヌに再床アクセスせずに `parse()` を調敎できたす。
+- 🧩 **すぐに䜿える Spider テンプレヌト**`CrawlSpider` はルヌルに沿っおリンクをたどり、`SitemapSpider` は sitemap や robots.txt を起点にクロヌルしたす。`XMLFeedSpider` ず `CSVFeedSpider` は XML・RSS・CSV フィヌドを読み取りたす。`ShopifySpider` は公開 Shopify ストアの商品を取埗し、バリ゚ヌションごずに 1 件のデヌタを出力したす。
+- 🔗 **リンク抜出**`LinkExtractor` はパタヌンによる蚱可ず陀倖、ドメむンや拡匵子の絞り蟌み、CSS ず XPath による範囲指定、URL の正芏化に察応したす。テンプレヌト内でも単䜓でも䜿えたす。
+- 📊 **デヌタの出力**フックず独自の凊理を䜿うか、組み蟌みの JSON・JSONL・CSV・XML 出力を䜿えたす。`result.items.to_json()`、`to_jsonl()`、`to_csv()`、`to_xml()` を呌び出したす。
+
+### セッションを䜿ったペヌゞの取埗 {#advanced-websites-fetching-with-session-support}
+- **HTTP リク゚スト**`Fetcher` で高速か぀怜出されにくい HTTP リク゚ストを送れたす。ブラりザの TLS フィンガヌプリントずヘッダヌの暡倣や、HTTP/3 に察応したす。
+- **動的なペヌゞの読み蟌み**`StealthyFetcher` のブラりザ自動化で動的なサむトを取埗できたす。Playwright の Chromium ず Google Chrome に察応したす。
+- **ボット怜出の回避**`StealthyFetcher` は自動化の痕跡を隠し、フィンガヌプリントを停装したす。Cloudflare Turnstile や Interstitial の各皮怜蚌を自動凊理できたす。
+- **セッション管理**`FetcherSession` ず `StealthySession` は、リク゚スト間で Cookie ず状態を保持したす。
+- **プロキシの切り替え**`ProxyRotator` は、すべおのセッションで順番に、たたは独自のルヌルでプロキシを切り替えたす。リク゚ストごずにプロキシを指定するこずもできたす。
+- **ドメむンず広告のブロック**指定したドメむンずそのサブドメむンぞのリク゚ストを止められたす。ブラりザ Fetcher には広告ブロック機胜もあり、玄 3,500 の広告・远跡甚ドメむンに察応したす。
+- **DNS リヌクの防止**DNS-over-HTTPS を有効にするず、Cloudflare の DoH を通じお DNS を問い合わせたす。プロキシ䜿甚時の DNS リヌクを防ぎたす。
+- **リモヌトブラりザ**CDP ず `cdp_url` を䜿い、すでに動いおいるブラりザに接続できたす。同じパ゜コン、別のサヌバヌ、ブラりザ提䟛サヌビスのいずれでも䜿えたす。`executable_path` で、各ブラりザ Fetcher に独自の Chromium を指定するこずもできたす。
+- **バックグラりンド API レスポンスの蚘録**ブラりザセッションで `record_requests=True` を有効にし、`session.network.search(limit=None)` で保存枈みレスポンスを怜玢したす。リク゚ストを送り盎さずに、耇数のペヌゞ読み蟌みで発生した API デヌタや HTTP ゚ラヌを確認できたす。履歎には䞊限があり、テキストのレスポンス本文を保存したす。
+- **非同期察応**すべおの Fetcher で非同期凊理を䜿えたす。専甚の非同期セッションもありたす。
+
+### 解析ずデヌタ抜出 {#parsing-and-data-extraction}
+- 🔄 **芁玠の再怜玢**サむトが倉わった埌も、類䌌床を䜿っお芁玠を芋぀け盎したす。
+- 🎯 **柔軟な遞択**CSS、XPath、フィルタヌ、テキスト、正芏衚珟などを䜿えたす。
+- 🔍 **類䌌芁玠の怜玢**芋぀けた芁玠に䌌た芁玠を自動で探したす。
+
+### AI 機胜 {#ai-features}
+- 🀖 **MCP サヌバヌ**Claude や Cursor などの AI アシスタントず゚ヌゞェントが Scrapling を䜿っおデヌタを抜出できたす。HTTP リク゚スト、ブラりザ操䜜、スクリヌンショット、保存枈みログむン状態、バックグラりンド API レスポンスに察応したす。ステルスブラりザずツヌルを䜿い、察応する胜力を持぀モデルが CAPTCHA を凊理できるようにしたす。Cloudflare 怜蚌の凊理機胜もありたす。モデルぞ送る内容を枛らし、広告をブロックし、プロンプトむンゞェクションから保護したす。CDP によるリモヌトブラりザ接続や、認蚌付きの HTTP 接続にも察応したす。[デモ動画](https://www.youtube.com/watch?v=qyFk3ZNwOxE)
+- 🧠 **Agent Skill**むンストヌルしお䜿える [Agent Skill](ai/agent-skill.md) が、コヌディング゚ヌゞェントにラむブラリの䜿い方を䌝えたす。珟圚の API に合ったコヌドを曞く助けになりたす。
+- 📚 **RAG 向けの Markdown**1 行のコヌド`page.markdown()`で、ペヌゞを敎理・クリヌニングした LLM 向けの Markdown に倉換したす。`ContentSpider` テンプレヌトを䜿えば、サむト党䜓を Markdown ファむルに保存できたす。この凊理に LLM は䞍芁です。[ドキュメント](ai/building-rag-systems.md)
+
+### 高速で、実際の䜜業にも䜿われおいたす {#high-performance-battle-tested-architecture}
+- 🚀 **高速な凊理**最適化により、倚くの Python スクレむピングラむブラリを䞊回る速床を実珟しおいたす。
+- 🔋 **少ないメモリ䜿甚量**最適化したデヌタ構造ず、必芁なずきだけ読み蟌む仕組みを䜿っおいたす。
+- ⚡ **高速な JSON 出力**暙準ラむブラリの 10 倍の速床です。
+- 🏗 **実際の䜜業で怜蚌枈み**テストカバレッゞは 92% で、すべおのコヌドに型ヒントがありたす。この 1 幎間、数癟人が毎日のデヌタ抜出に䜿っおきたした。
+
+### 開発ずデヌタ抜出のためのツヌル {#developerweb-scraper-friendly-experience}
+- 🎯 **察話型シェル**Scrapling ず連携した IPython シェルを远加できたす。ショヌトカットやツヌルでスクリプトの開発を助けたす。curl リク゚ストを Scrapling のリク゚ストに倉換し、結果をブラりザで確認できたす。
+- 🚀 **タヌミナルからの利甚**コヌドを曞かずに URL の内容を取埗できたす。
+- 🛠 **DOM の移動**芪芁玠、兄匟芁玠、子芁玠をたどれたす。
+- 🧬 **テキスト凊理**正芏衚珟、テキストのクリヌニング、最適化した文字列操䜜を䜿えたす。
+- 📝 **セレクタヌの生成**任意の芁玠に察する CSS ず XPath のセレクタヌを生成したす。
+- 🔌 **䜿い慣れた API**Scrapy や BeautifulSoup に䌌た API で、Scrapy ず Parsel ず同じ疑䌌芁玠を䜿えたす。
+- 🀝 **Scrapy ずの連携**コヌルバックに `scrapling_response` デコレヌタヌを付けるず、取埗枈みのレスポンスを Scrapling のパヌサヌで解析できたす。プログラムを曞き盎す必芁はありたせん。
+- 📘 **すべおのコヌドに型ヒント**゚ディタヌでの確認ずコヌド補完を助けたす。倉曎のたびに、すべおのコヌドを **PyRight** ず **MyPy** で自動チェックしたす。
+- 🔋 **すぐに䜿える Docker むメヌゞ**リリヌスごずに、すべおのブラりザを含む Docker むメヌゞを自動で䜜成・公開したす。
+
+
+## GitHub スタヌの掚移 {#star-history}
+Scrapling の公開埌、GitHub のスタヌは増え続けおいたす。䞋のグラフで確認できたす。
+
+<div id="chartContainer">
+ <a href="https://github.com/D4Vinci/Scrapling">
+ <img id="chartImage" alt="GitHub スタヌ数の掚移" loading="lazy" src="https://api.star-history.com/svg?repos=D4Vinci/Scrapling&type=Date" height="400"/>
+ </a>
+</div>
+
+<script>
+const observer = new MutationObserver((mutations) => {
+ mutations.forEach((mutation) => {
+ if (mutation.attributeName === 'data-md-color-media') {
+ const colorMedia = document.body.getAttribute('data-md-color-media');
+ const isDarkScheme = document.body.getAttribute('data-md-color-scheme') === 'slate';
+ const chartImg = document.querySelector('#chartImage');
+ const baseUrl = 'https://api.star-history.com/svg?repos=D4Vinci/Scrapling&type=Date';
+
+ if (colorMedia === '(prefers-color-scheme)' ? isDarkScheme : colorMedia.includes('dark')) {
+ chartImg.src = `${baseUrl}&theme=dark`;
+ } else {
+ chartImg.src = baseUrl;
+ }
+ }
+ });
+});
+
+observer.observe(document.body, {
+ attributes: true,
+ attributeFilter: ['data-md-color-media', 'data-md-color-scheme']
+});
+</script>
+
+
+## むンストヌル {#installation}
+Scrapling には Python 3.10 以䞊が必芁です。
+
+```bash
+pip install scrapling
+```
+
+!!! warning "泚意"
+
+ このコマンドはパヌサヌずその䟝存パッケヌゞだけをむンストヌルしたす。Fetcher やコマンドラむンツヌルは含たれたせん。この状態で䞊の䟋のように `scrapling.fetchers` や `scrapling.spiders` からむンポヌトするず、`ModuleNotFoundError` が発生したす。Fetcher や Spider を䜿う堎合は、先に以䞋の手順で Fetcher の䟝存パッケヌゞをむンストヌルしおください。
+
+### 远加の䟝存パッケヌゞ {#optional-dependencies}
+
+1. Fetcher、関連するクラス、以䞋の远加機胜を䜿う堎合は、Fetcher ずブラりザに必芁なパッケヌゞをむンストヌルしたす。
+ ```bash
+ pip install "scrapling[fetchers]"
+
+ scrapling install # normal install
+ scrapling install --force # force reinstall
+ ```
+
+ すべおのブラりザ、必芁なシステムパッケヌゞ、フィンガヌプリントを倉曎するツヌルがダりンロヌドされたす。
+
+ コマンドの代わりに、Python のコヌドからむンストヌルするこずもできたす。
+ ```python
+ from scrapling.cli import install
+
+ install([], standalone_mode=False) # normal install
+ install(["--force"], standalone_mode=False) # force reinstall
+ ```
+
+2. 远加機胜
+
+
+ - MCP サヌバヌをむンストヌル
+ ```bash
+ pip install "scrapling[ai]"
+ ```
+ - [RAG システムの構築](ai/building-rag-systems.md)に必芁なパッケヌゞをむンストヌル
+ ```bash
+ pip install "scrapling[rag]"
+ ```
+ - 察話型シェルず `extract` コマンドをむンストヌル
+ ```bash
+ pip install "scrapling[shell]"
+ ```
+ - すべおの機胜をむンストヌル
+ ```bash
+ pip install "scrapling[all]"
+ ```
+ ブラりザ Fetcher を䜿う堎合は `scrapling install` を実行しおください。HTTP リク゚ストにはブラりザのむンストヌルは䞍芁です。
+
+### Docker {#docker}
+すべおの远加機胜ずブラりザを含む Docker むメヌゞを DockerHub から取埗するこずもできたす。
+```bash
+docker pull pyd4vinci/scrapling
+```
+GitHub のレゞストリからも取埗できたす。
+```bash
+docker pull ghcr.io/d4vinci/scrapling:latest
+```
+このむメヌゞはリポゞトリのメむンブランチを䜿い、GitHub Actions で自動䜜成・公開されたす。
+
+## ドキュメントの構成 {#how-the-documentation-is-organized}
+Scrapling のドキュメントは倚いため、[Diátaxis のドキュメント䜓系](https://diataxis.fr/)に沿っお敎理しおいたす。
+
+## プロゞェクトの支揎 {#support}
+
+Scrapling を気に入っおいただけたら、次の方法で開発を支揎できたす。
+
+- ⭐ [GitHub リポゞトリ](https://github.com/D4Vinci/Scrapling)にスタヌを付ける。
+- 🚀 [Twitter](https://x.com/Scrapling_dev) をフォロヌし、[Discord コミュニティ](https://discord.gg/EMgGbDceNQ)に参加する。
+- 💝 [プロゞェクトにスポンサヌずしお参加する、たたはコヌヒヌをおごる](donate.md)。:wink:
+- 🐛 [GitHub Issues](https://github.com/D4Vinci/Scrapling/issues) で䞍具合を報告し、機胜を提案する。
+
+## ラむセンス {#license}
+
+本プロゞェクトは BSD-3 ラむセンスで公開されおいたす。詳しくは [LICENSE](https://github.com/D4Vinci/Scrapling/blob/main/LICENSE) ファむルをご芧ください。
diff --git a/docs/locales/ja/integrations/scrapy.md b/docs/locales/ja/integrations/scrapy.md
new file mode 100644
index 0000000..c4ff1cf
--- /dev/null
+++ b/docs/locales/ja/integrations/scrapy.md
@@ -0,0 +1,64 @@
+---
+title: "Scrapy Spider で Scrapling の解析機胜を䜿う"
+description: "Scrapy のレスポンスを倉換する方法ず、コヌルバックにデコレヌタヌを付ける方法を玹介したす。Scrapy クロヌラヌを維持したたた、Scrapling のセレクタヌず適応型解析を䜿えたす。"
+---
+
+# Scrapling を Scrapy に組み蟌む {#integrating-scrapling-into-scrapy}
+
+既存の Scrapy プロゞェクトがある堎合、Scrapling の解析 API を䜿うために曞き盎す必芁はありたせん。Scrapy 連携機胜は、Spider のコヌルバック内で Scrapy のレスポンスを Scrapling の [Response](../fetching/choosing.md#response-object) オブゞェクトに倉換したす。クロヌルは匕き続き Scrapy が担圓し、解析を Scrapling が担圓したす。
+
+!!! note "むンストヌル"
+
+ この連携機胜は、暙準の Scrapling むンストヌル`pip install scrapling`で䜿えたす。远加の䟝存関係グルヌプは䞍芁です。Scrapy のむンストヌルだけが必芁ですが、Scrapy プロゞェクトにはすでに入っおいたす。
+
+## 䜿い方 {#usage}
+
+Spider のコヌルバックに `scrapling_response` デコレヌタヌを付けるず、受け取る `response` 匕数が Scrapling の `Response` になりたす。
+
+```python
+import scrapy
+from scrapling.integrations.scrapy import scrapling_response
+
+
+class QuotesSpider(scrapy.Spider):
+ name = "quotes"
+ start_urls = ["https://quotes.toscrape.com"]
+
+ @scrapling_response
+ def parse(self, response): # `response` is now a Scrapling Response
+ first_quote = response.find_by_text("The world as we have created it", partial=True)
+ for quote in [first_quote, *first_quote.find_similar()]:
+ card = quote.parent
+ yield {
+ "text": quote.get_all_text(strip=True),
+ "author": card.find("small", class_="author").text,
+ "tags": [tag.text for tag in card.find_all("a", class_="tag")],
+ }
+ next_page = response.css("li.next a::attr(href)").get()
+ if next_page:
+ yield scrapy.Request(response.urljoin(next_page), callback=self.parse)
+```
+
+このデコレヌタヌは、Scrapy が察応するすべおのコヌルバック圢匏で䜿えたす。通垞の関数、ゞェネレヌタヌ、コルヌチン、非同期ゞェネレヌタヌに察応しおいたす。ラッパヌは元の圢匏、名前、docstring を保぀ため、Scrapy のコヌルバック怜査やコントラクトも匕き続き動䜜したす。
+
+デコレヌタヌに [Selector](../parsing/main_classes.md#selector) の蚭定を枡すこずもできたす。その蚭定は、生成される `Response` に枡されたす。
+
+```python
+ @scrapling_response(adaptive=True, keep_comments=True)
+ def parse_product(self, response):
+ ...
+```
+
+ミドルりェアやパむプラむンなど、コヌルバック以倖の堎所に Scrapy のレスポンスがある堎合は、倉換関数を盎接䜿いたす。
+
+```python
+from scrapling.integrations.scrapy import convert_response
+
+scrapling_response = convert_response(scrapy_response, keep_comments=False)
+```
+
+## 泚意点 {#notes}
+
+- 次のペヌゞを取埗するには、䞊の䟋のように `scrapy.Request(response.urljoin(href))` を yield したす。Scrapling の `Response.follow()` は [Scrapling の Spider システム](../spiders/getting-started.md)甚のリク゚ストを䜜るため、Scrapy では扱えたせん。
+- レスポンスの `meta` 蟞曞は浅いコピヌを䜜るため、他のミドルりェアが保存したオブゞェクトにも匕き続きアクセスできたす。䟋えば `scrapy-playwright` のペヌゞは、そのたた `response.meta["playwright_page"]` にありたす。
+- 生の `Set-Cookie` ヘッダヌから Cookie を解析し、レスポンスの `cookies` 蟞曞に栌玍したす。
diff --git a/docs/locales/ja/overview.md b/docs/locales/ja/overview.md
new file mode 100644
index 0000000..3bf0c43
--- /dev/null
+++ b/docs/locales/ja/overview.md
@@ -0,0 +1,341 @@
+---
+title: "Scrapling 入門解析、HTTP リク゚スト、ステルスブラりザ"
+description: "CSS、XPath、テキスト怜玢、HTTP リク゚スト、ステルスブラりザの䟋で Scrapling の䜿い方を孊びたす。"
+---
+
+# Scrapling を䜿っおみる {#get-started-with-scrapling}
+
+## 目的から遞ぶ {#pick-your-path}
+
+䜕から始めるか迷ったら、やりたいこずに合う項目を遞んでください。
+
+| やりたいこず | 最初に読むペヌゞ |
+|:---|:---|
+| 手元にある **HTML を解析する** | [芁玠の遞択](parsing/selection.md)CSS、XPath、テキストによる怜玢 |
+| **ペヌゞをすぐに取埗しお**詊す | [Fetcher を遞んで](fetching/choosing.md)詊すか、[察話型シェル](cli/interactive-shell.md)を起動したす |
+| 倚くのペヌゞを凊理する**クロヌラヌを䜜る** | [Spider](spiders/getting-started.md)䞊行凊理、耇数のセッション、䞀時停止ず再開 |
+| **コヌドを曞かずに取埗する** | [CLI の抜出コマンド](cli/extract-commands.md)を䜿うか、[MCP サヌバヌ](ai/mcp-server.md)を AI ツヌルに接続したす |
+| 他のラむブラリから**移行する** | [BeautifulSoup からの移行](tutorials/migrating_from_beautifulsoup.md)、たたは [Scrapy ずの比范](spiders/architecture.md#comparison-with-scrapy) |
+
+---
+
+たずペヌゞの解析方法を芋おいきたす。その埌、ブラりザでのペヌゞ取埗、リク゚ストの送信、レスポンスの解析を詊したす。
+
+このペヌゞでは、ChatGPT が生成した次の HTML を䜿いたす。
+```python
+html_doc = """<html>
+ <head>
+ <title>Complex Web Page</title>
+ <style>
+ .hidden { display: none; }
+ </style>
+ </head>
+ <body>
+ <header>
+ <nav>
+ <ul>
+ <li> <a href="#home">Home</a> </li>
+ <li> <a href="#about">About</a> </li>
+ <li> <a href="#contact">Contact</a> </li>
+ </ul>
+ </nav>
+ </header>
+ <main>
+ <section id="products" schema='{"jsonable": "data"}'>
+ <h2>Products</h2>
+ <div class="product-list">
+ <article class="product" data-id="1">
+ <h3>Product 1</h3>
+ <p class="description">This is product 1</p>
+ <span class="price">$10.99</span>
+ <div class="hidden stock">In stock: 5</div>
+ </article>
+
+ <article class="product" data-id="2">
+ <h3>Product 2</h3>
+ <p class="description">This is product 2</p>
+ <span class="price">$20.99</span>
+ <div class="hidden stock">In stock: 3</div>
+ </article>
+
+ <article class="product" data-id="3">
+ <h3>Product 3</h3>
+ <p class="description">This is product 3</p>
+ <span class="price">$15.99</span>
+ <div class="hidden stock">Out of stock</div>
+ </article>
+ </div>
+ </section>
+
+ <section id="reviews">
+ <h2>Customer Reviews</h2>
+ <div class="review-list">
+ <div class="review" data-rating="5">
+ <p class="review-text">Great product!</p>
+ <span class="reviewer">John Doe</span>
+ </div>
+ <div class="review" data-rating="4">
+ <p class="review-text">Good value for money.</p>
+ <span class="reviewer">Jane Smith</span>
+ </div>
+ </div>
+ </section>
+ </main>
+ <script id="page-data" type="application/json">
+ {
+ "lastUpdated": "2024-09-22T10:30:00Z",
+ "totalProducts": 3
+ }
+ </script>
+ </body>
+</html>"""
+```
+たず、この HTML を読み蟌みたす。
+```python
+import re
+from scrapling.parser import Selector
+page = Selector(html_doc)
+page # <data='<html><head><title>Complex Web Page</tit...'>
+```
+入れ子の芁玠も含め、ペヌゞ内のすべおのテキストを取埗したす。
+```python
+page.get_all_text(ignore_tags=('script', 'style'))
+# 'Complex Web Page\nHome\nAbout\nContact\nProducts\nProduct 1\nThis is product 1\n$10.99\nIn stock: 5\nProduct 2\nThis is product 2\n$20.99\nIn stock: 3\nProduct 3\nThis is product 3\n$15.99\nOut of stock\nCustomer Reviews\nGreat product!\nJohn Doe\nGood value for money.\nJane Smith'
+```
+
+## 芁玠を探す {#finding-elements}
+いく぀かの方法を組み合わせお、必芁な芁玠を探せたす。
+
+最初の HTML `section` 芁玠を探したす。
+```python
+section_element = page.find('section')
+# <data='<section id="products" schema='{"jsonabl...' parent='<main><section id="products" schema='{"j...'>
+```
+すべおの `section` 芁玠を探したす。
+```python
+section_elements = page.find_all('section')
+# [<data='<section id="products" schema='{"jsonabl...' parent='<main><section id="products" schema='{"j...'>, <data='<section id="reviews"><h2>Customer Revie...' parent='<main><section id="products" schema='{"j...'>]
+```
+`id` 属性が `products` の `section` 芁玠をすべお探したす。
+```python
+section_elements = page.find_all('section', {'id':"products"})
+# Same as
+section_elements = page.find_all('section', id="products")
+# [<data='<section id="products" schema='{"jsonabl...' parent='<main><section id="products" schema='{"j...'>]
+```
+`id` 属性に `product` を含む `section` 芁玠をすべお探したす。
+```python
+section_elements = page.find_all('section', {'id*':"product"})
+```
+テキストが正芏衚珟 `Product \d` に䞀臎する `h3` 芁玠を探したす。
+```python
+page.find_all('h3', re.compile(r'Product \d'))
+# [<data='<h3>Product 1</h3>' parent='<article class="product" data-id="1"><h3...'>, <data='<h3>Product 2</h3>' parent='<article class="product" data-id="2"><h3...'>, <data='<h3>Product 3</h3>' parent='<article class="product" data-id="3"><h3...'>]
+```
+テキストが正芏衚珟 `Product` に䞀臎する `h3` 芁玠ず `h2` 芁玠を探したす。
+```python
+page.find_all(['h3', 'h2'], re.compile(r'Product'))
+# [<data='<h3>Product 1</h3>' parent='<article class="product" data-id="1"><h3...'>, <data='<h3>Product 2</h3>' parent='<article class="product" data-id="2"><h3...'>, <data='<h3>Product 3</h3>' parent='<article class="product" data-id="3"><h3...'>, <data='<h2>Products</h2>' parent='<section id="products" schema='{"jsonabl...'>]
+```
+テキストが `Products` ず完党に䞀臎する芁玠を探したす。空癜は無芖したす。
+```python
+page.find_by_text('Products', first_match=False)
+# [<data='<h2>Products</h2>' parent='<section id="products" schema='{"jsonabl...'>]
+```
+正芏衚珟 `Product \d` に䞀臎するテキストを持぀芁玠も探せたす。
+```python
+page.find_by_regex(r'Product \d', first_match=False)
+# [<data='<h3>Product 1</h3>' parent='<article class="product" data-id="1"><h3...'>, <data='<h3>Product 2</h3>' parent='<article class="product" data-id="2"><h3...'>, <data='<h3>Product 3</h3>' parent='<article class="product" data-id="3"><h3...'>]
+```
+指定した芁玠に䌌た芁玠を探したす。
+```python
+target_element = page.find_by_regex(r'Product \d', first_match=True)
+# <data='<h3>Product 1</h3>' parent='<article class="product" data-id="1"><h3...'>
+target_element.find_similar()
+# [<data='<h3>Product 2</h3>' parent='<article class="product" data-id="2"><h3...'>, <data='<h3>Product 3</h3>' parent='<article class="product" data-id="3"><h3...'>]
+```
+CSS セレクタヌに䞀臎する最初の芁玠を探したす。
+```python
+page.css('.product-list [data-id="1"]')[0]
+# <data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>
+```
+CSS セレクタヌに䞀臎するすべおの芁玠を探したす。
+```python
+page.css('.product-list article')
+# [<data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>, <data='<article class="product" data-id="2"><h3...' parent='<div class="product-list"> <article clas...'>, <data='<article class="product" data-id="3"><h3...' parent='<div class="product-list"> <article clas...'>]
+```
+XPath セレクタヌに䞀臎する最初の芁玠を探したす。
+```python
+page.xpath("//*[@id='products']/div/article")[0]
+# <data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>
+```
+XPath セレクタヌに䞀臎するすべおの芁玠を探したす。
+```python
+page.xpath("//*[@id='products']/div/article")
+# [<data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>, <data='<article class="product" data-id="2"><h3...' parent='<div class="product-list"> <article clas...'>, <data='<article class="product" data-id="3"><h3...' parent='<div class="product-list"> <article clas...'>]
+```
+
+ここでは基本的な䜿い方を玹介したした。各メ゜ッドの詳しいオプションは埌で説明したす。
+## 芁玠のデヌタを読む {#accessing-elements-data}
+次のようにデヌタを取埗できたす。
+```pycon
+>>> section_element.tag
+'section'
+>>> print(section_element.attrib)
+{'id': 'products', 'schema': '{"jsonable": "data"}'}
+>>> section_element.attrib['schema'].json() # If an attribute value can be converted to json, then use `.json()` to convert it
+{'jsonable': 'data'}
+>>> section_element.text # Direct text content
+''
+>>> section_element.get_all_text() # All text content recursively
+'Products\nProduct 1\nThis is product 1\n$10.99\nIn stock: 5\nProduct 2\nThis is product 2\n$20.99\nIn stock: 3\nProduct 3\nThis is product 3\n$15.99\nOut of stock'
+>>> section_element.html_content # The HTML content of the element
+'<section id="products" schema=\'{"jsonable": "data"}\'><h2>Products</h2>\n <div class="product-list">\n <article class="product" data-id="1"><h3>Product 1</h3>\n <p class="description">This is product 1</p>\n <span class="price">$10.99</span>\n <div class="hidden stock">In stock: 5</div>\n </article><article class="product" data-id="2"><h3>Product 2</h3>\n <p class="description">This is product 2</p>\n <span class="price">$20.99</span>\n <div class="hidden stock">In stock: 3</div>\n </article><article class="product" data-id="3"><h3>Product 3</h3>\n <p class="description">This is product 3</p>\n <span class="price">$15.99</span>\n <div class="hidden stock">Out of stock</div>\n </article></div>\n </section>'
+>>> print(section_element.prettify()) # The prettified version
+'''
+<section id="products" schema='{"jsonable": "data"}'><h2>Products</h2>
+ <div class="product-list">
+ <article class="product" data-id="1"><h3>Product 1</h3>
+ <p class="description">This is product 1</p>
+ <span class="price">$10.99</span>
+ <div class="hidden stock">In stock: 5</div>
+ </article><article class="product" data-id="2"><h3>Product 2</h3>
+ <p class="description">This is product 2</p>
+ <span class="price">$20.99</span>
+ <div class="hidden stock">In stock: 3</div>
+ </article><article class="product" data-id="3"><h3>Product 3</h3>
+ <p class="description">This is product 3</p>
+ <span class="price">$15.99</span>
+ <div class="hidden stock">Out of stock</div>
+ </article>
+ </div>
+</section>
+'''
+>>> section_element.path # All the ancestors in the DOM tree of this element
+[<data='<main><section id="products" schema='{"j...' parent='<body> <header><nav><ul><li> <a href="#h...'>,
+ <data='<body> <header><nav><ul><li> <a href="#h...' parent='<html><head><title>Complex Web Page</tit...'>,
+ <data='<html><head><title>Complex Web Page</tit...'>]
+>>> section_element.generate_css_selector
+'#products'
+>>> section_element.generate_full_css_selector
+'body > main > #products'
+>>> section_element.generate_xpath_selector
+"//*[@id='products']"
+>>> section_element.generate_full_xpath_selector
+"//body/main/*[@id='products']"
+```
+
+## 芁玠をたどる {#navigation}
+先ほど芋぀けた芁玠を䜿いたす。
+
+```pycon
+>>> section_element.parent
+<data='<main><section id="products" schema='{"j...' parent='<body> <header><nav><ul><li> <a href="#h...'>
+>>> section_element.parent.tag
+'main'
+>>> section_element.parent.parent.tag
+'body'
+>>> section_element.children
+[<data='<h2>Products</h2>' parent='<section id="products" schema='{"jsonabl...'>,
+ <data='<div class="product-list"> <article clas...' parent='<section id="products" schema='{"jsonabl...'>]
+>>> section_element.siblings
+[<data='<section id="reviews"><h2>Customer Revie...' parent='<main><section id="products" schema='{"j...'>]
+>>> section_element.next # gets the next element, the same logic applies to `quote.previous`.
+<data='<section id="reviews"><h2>Customer Revie...' parent='<main><section id="products" schema='{"j...'>
+>>> section_element.children.css('h2::text').getall()
+['Products']
+>>> page.css('[data-id="1"]')[0].has_class('product')
+True
+```
+芪芁玠だけでなく、祖先芁玠党䜓を順番にたどるこずもできたす。
+```python
+for ancestor in section_element.iterancestors():
+ print(ancestor.tag)
+```
+条件を満たす祖先芁玠も探せたす。`Selector` を受け取り、条件を満たす堎合は `True`、それ以倖は `False` を返す関数を枡したす。
+```pycon
+>>> section_element.find_ancestor(lambda ancestor: ancestor.css('nav'))
+<data='<body> <header><nav><ul><li> <a href="#h...' parent='<html><head><title>Complex Web Page</tit...'>
+```
+
+## りェブペヌゞを取埗する {#fetching-websites}
+HTML を Scrapling に枡すほかに、HTTP リク゚ストやブラりザでサむトのレスポンスを取埗するこずもできたす。
+
+目的に合う Fetcher を遞んでください。
+
+### HTTP リク゚スト {#http-requests}
+`Fetcher` クラスをむンポヌトしお、HTTP リク゚ストを送りたす。
+```python
+from scrapling.fetchers import Fetcher
+page = Fetcher.get('https://scrapling.requestcatcher.com/get', impersonate="chrome")
+```
+各 HTTP メ゜ッドは次のように䜿いたす。
+```python
+from scrapling.fetchers import Fetcher
+page = Fetcher.get('https://scrapling.requestcatcher.com/get', stealthy_headers=True)
+page = Fetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'}, proxy='http://username:password@localhost:8030')
+page = Fetcher.put('https://scrapling.requestcatcher.com/put', data={'key': 'value'})
+page = Fetcher.delete('https://scrapling.requestcatcher.com/delete')
+```
+非同期リク゚ストには、むンポヌトを次のように倉曎したす。
+```python
+from scrapling.fetchers import AsyncFetcher
+page = await AsyncFetcher.get('https://scrapling.requestcatcher.com/get', stealthy_headers=True)
+page = await AsyncFetcher.post('https://scrapling.requestcatcher.com/post', data={'key': 'value'}, proxy='http://username:password@localhost:8030')
+page = await AsyncFetcher.put('https://scrapling.requestcatcher.com/put', data={'key': 'value'})
+page = await AsyncFetcher.delete('https://scrapling.requestcatcher.com/delete')
+```
+
+!!! note "補足"
+
+ 1. `stealthy_headers` は、Google の Referer を含む実際のブラりザのヘッダヌを生成したす。既定で有効です。
+ 2. `impersonate` は、指定したブラりザのバヌゞョンの TLS フィンガヌプリントを暡倣したす。
+ 3. `http3` は HTTP/3 を有効にしお、実際のブラりザに近いリク゚ストを送りたす。
+
+そのほかのオプションは [HTTP リク゚ストのガむド](fetching/static.md)をご芧ください。
+
+### 動的なペヌゞの読み蟌み {#dynamic-loading}
+JavaScript で内容を読み蟌むサむトにも察応できたす。
+
+`StealthyFetcher` は、Chromium ベヌスのブラりザでペヌゞを取埗するための倚くのオプションを備えおいたす。
+```python
+from scrapling.fetchers import StealthyFetcher
+page = StealthyFetcher.fetch('https://quotes.toscrape.com/js/', disable_resources=True, block_ads=True, wait_selector='.quote')
+print(len(page.css(".quote"))) # -> 10
+
+# The async version of fetch
+page = await StealthyFetcher.async_fetch('https://quotes.toscrape.com/js/', disable_resources=True, block_ads=True, wait_selector='.quote')
+print(len(page.css(".quote"))) # -> 10
+```
+自動化の痕跡を隠す倉曎を加えた [Playwright](https://playwright.dev/python/) を䜿っおいたす。同梱の Chromium、`real_chrome=True` で指定するむンストヌル枈みの Google Chrome、`cdp_url` で接続する起動䞭のブラりザを䜿えたす。
+
+### ボット怜出を避ける機胜 {#anti-bot-features}
+
+䞻に次の機胜がありたす。
+
+1. `solve_cloudflare=True` で、Cloudflare Turnstile ず Interstitial の各皮怜蚌を自動凊理したす。
+2. CDP Runtime ず WebRTC のリヌクを防ぎたす。
+3. JavaScript の実行環境を分離し、倚くの Playwright の痕跡を消し、よく知られたボットの動䜜による怜出を避けたす。
+4. Canvas にノむズを加え、フィンガヌプリントによる識別を防ぎたす。
+5. 既知のヘッドレスモヌド怜出方法に察応し、タむムゟヌンの䞍䞀臎による怜出を防ぐオプションも提䟛したす。
+6. そのほかにも怜出を避けるオプションがありたす。
+
+```python
+from scrapling.fetchers import StealthyFetcher
+page = StealthyFetcher.fetch('https://www.browserscan.net/bot-detection') # Running headless by default
+page.status == 200 # -> True
+
+page = StealthyFetcher.fetch('https://nopecha.com/demo/cloudflare', solve_cloudflare=True) # Solve Cloudflare captcha automatically if presented
+page.status == 200 # -> True
+
+page = StealthyFetcher.fetch('https://www.browserscan.net/bot-detection', block_webrtc=True, hide_canvas=True, dns_over_https=True) # and the rest of arguments...
+# The async version of fetch
+page = await StealthyFetcher.async_fetch('https://www.browserscan.net/bot-detection')
+page.status == 200 # -> True
+```
+
+詳しい説明ずすべおの匕数は、[ブラりザのガむド](fetching/stealthy.md)をご芧ください。
+
+---
+
+以䞊が Scrapling の基本です。さらに詳しく知りたい堎合は、次のセクションに進んでください。
diff --git a/docs/locales/ja/parsing/adaptive.md b/docs/locales/ja/parsing/adaptive.md
new file mode 100644
index 0000000..3fc87af
--- /dev/null
+++ b/docs/locales/ja/parsing/adaptive.md
@@ -0,0 +1,232 @@
+---
+title: "適応型解析で HTML 芁玠を远跡し、再び芋぀ける"
+description: "芁玠の特城を保存し、HTML が倉わった埌も䞀臎する芁玠を探したす。適応型解析の有効化ず save、retrieve、relocate の䜿い方を玹介したす。"
+---
+
+# 適応型スクレむピング {#adaptive-scraping}
+
+!!! success "前提条件"
+
+ 1. [芁玠の怜玢](../parsing/selection.md)を読み、[Selector](../parsing/main_classes.md#selector) オブゞェクトから芁玠を探しお抜出する方法を理解しおいるこず。
+ 2. [䞻なクラス](../parsing/main_classes.md)を読み、[Selector](../parsing/main_classes.md#selector) クラスを理解しおいるこず。
+
+適応型スクレむピングは、以前は automatch ず呌ばれおいた、Scrapling の特に匷力な機胜です。芁玠を远跡しお再び芋぀けるこずで、サむトが倉わっおもスクレむパヌを動かし続けられたす。
+
+次のような構造のペヌゞをスクレむピングするずしたす。
+```html
+<div class="container">
+ <section class="products">
+ <article class="product" id="p1">
+ <h3>Product 1</h3>
+ <p class="description">Description 1</p>
+ </article>
+ <article class="product" id="p2">
+ <h3>Product 2</h3>
+ <p class="description">Description 2</p>
+ </article>
+ </section>
+</div>
+```
+ID が `p1` の最初の商品を取埗するなら、次のようなセレクタヌを曞くでしょう。
+```python
+page.css('#p1')
+```
+サむトの運営者が構造を次のように倉えるず、
+```html
+<div class="new-container">
+ <div class="product-wrapper">
+ <section class="products">
+ <article class="product new-class" data-id="p1">
+ <div class="product-info">
+ <h3>Product 1</h3>
+ <p class="new-description">Description 1</p>
+ </div>
+ </article>
+ <article class="product new-class" data-id="p2">
+ <div class="product-info">
+ <h3>Product 2</h3>
+ <p class="new-description">Description 2</p>
+ </div>
+ </article>
+ </section>
+ </div>
+</div>
+```
+そのセレクタヌは機胜しなくなり、コヌドの修正が必芁になりたす。ここで Scrapling の `adaptive` 機胜が圹立ちたす。
+
+最初に芁玠を遞ぶずきに `adaptive` を有効にできたす。次に同じ芁玠を遞がうずしお芋぀からなければ、Scrapling は保存した特城を䜿い、サむト内で最も䌌おいる芁玠を探したす。AI は䜿いたせん :)
+
+```python
+from scrapling import Selector, Fetcher
+# Before the change
+page = Selector(page_source, adaptive=True, url='example.com')
+# or
+Fetcher.adaptive = True
+page = Fetcher.get('https://example.com')
+# then
+element = page.css('#p1', auto_save=True)
+if not element: # One day website changes?
+ element = page.css('#p1', adaptive=True) # Scrapling still finds it!
+# the rest of your code...
+```
+たず䟋で䜿い方を瀺し、その埌で仕組みず詳しい䜿い方を説明したす。この機胜は CSS/XPath だけでなく、すべおの遞択方法で䜿えたす。
+
+## 実際のサむトを䜿う䟋 {#real-world-scenario}
+実際のサむトを䟋に、Fetcher で゜ヌスを取埗しおみたす。本来なら、デザむンや構造が倉わる盎前のサむトを芋぀け、゜ヌスを保存しお倉曎を埅぀必芁がありたす。ただ、運営者を知らない限り、倉曎の予定を知るのはほが無理です。知っおいれば、今床は仕蟌んだテストになっおしたいたすね。
+
+そこで [The Web Archive](https://archive.org/) の [Wayback Machine](https://web.archive.org/) を䜿いたす。これは [2010 幎の StackOverFlow](https://web.archive.org/web/20100102003420/http://stackoverflow.com/) のコピヌです。かなり叀いですね。</br>同じセレクタヌで、2010 幎のデザむンず珟圚のデザむンから同じボタンを芋぀けられるか詊したす :)
+
+叀いデザむンの Questions ボタンは、`#hmenus > div:nth-child(1) > ul > li:nth-child(1) > a` で遞べたす。Google Chrome が生成したため、構造を现かく指定したセレクタヌです。
+
+
+䞡方のペヌゞで同じセレクタヌを詊したす。
+```python
+from scrapling import Fetcher
+selector = '#hmenus > div:nth-child(1) > ul > li:nth-child(1) > a'
+old_url = "https://web.archive.org/web/20100102003420/http://stackoverflow.com/"
+new_url = "https://stackoverflow.com/"
+Fetcher.configure(adaptive = True, adaptive_domain='stackoverflow.com')
+page = Fetcher.get(old_url, timeout=30)
+element1 = page.css(selector, auto_save=True)[0]
+# Same selector but used in the updated website
+page = Fetcher.get(new_url)
+element2 = page.css(selector, adaptive=True)[0]
+
+if element1.text == element2.text:
+ print('Scrapling found the same element in the old and new designs!') # Spoiler alert: it does!
+```
+ここでは `adaptive_domain` ずいう匕数を远加したした。Scrapling にずっお `archive.org` ず `stackoverflow.com` は別のドメむンなので、`adaptive` のデヌタも別々に保存されたす。同じサむトずしお扱うため、䞡方の `adaptive` デヌタを保存するずきに共通のドメむンを指定したす。
+
+実際のサむトでは、䞡方のリク゚ストに同じ URL を䜿うので、`adaptive_domain` は䞍芁です。それ以倖のコヌドは同じです。できるだけ実際の状況に近い䟋にしたので、参考になればうれしいです :)
+
+䞊の 2 ぀の䟋では `Selector` ず `Fetcher` を䜿い、適応型機胜の仕組みが同じであるこずを瀺したした。
+
+!!! info
+
+ `adaptive_domain` は䞻に、サむトがデザむンや構造ず䞀緒に URL も倉える堎合に䜿いたす。新しい URL でも、保存枈みの適応型デヌタを匕き続き利甚できたす。指定しないず、Scrapling は新しいサむトず刀断し、叀いデヌタを䜿いたせん。
+
+## 適応型スクレむピングの仕組み {#how-the-adaptive-scraping-feature-works}
+凊理は 2 ぀の段階に分かれたす。
+
+1. **保存**芁玠の特城を保存したす。
+2. **照合**埌で䌌た特城の芁玠を探したす。
+
+任意の方法で芁玠を遞び、サむトの構造やデザむンが倉わっおも、次回の取埗時に同じ芁玠を芋぀けたいずしたす。
+
+现かな技術の話を省くず、次の流れになりたす。
+
+ 1. 埌で説明する方法のいずれかで、芁玠の特城を保存するよう Scrapling に指瀺したす。
+ 2. Scrapling は蚭定されたデヌタベヌスに、各芁玠の特城を保存したす。暙準では SQLite を䜿いたす。
+ 3. 運営者は芁玠のどの情報も倉曎や削陀ができるため、芁玠自䜓の属性をデヌタベヌスの固定識別子にはできたせん。そこで、保存システムは次の 2 ぀を䜿いたす。
+ 1. 珟圚のサむトのドメむン。`Selector` を䜿う堎合は初期化時に枡したす。Fetcher では URL から自動で取埗したす。
+ 2. デヌタベヌスから芁玠の特城を読み出すための `identifier`。必ずしも手動で蚭定する必芁はありたせん。詳しくは埌で説明したす。
+
+ この 2 ぀を組み合わせお、保存した芁玠の特城を読み出したす。
+
+ 4. サむトの構造が倉わったら、`adaptive` を有効にしお芁玠を探したす。Scrapling は保存した特城を読み出し、ペヌゞ䞊のすべおの芁玠ず比范したす。目的の芁玠ずの類䌌床に応じおスコアを蚈算したす。この比范では、埌で説明するすべおの特城を考慮したす。
+ 5. 目的の芁玠ず最も䌌おいる芁玠を返したす。
+
+### 保存する特城 {#the-unique-properties}
+芁玠の情報がすべお倉曎や削陀の察象になるなら、どの特城を䜿うのでしょうか。
+
+Scrapling は次の情報を䜿いたす。
+
+- 芁玠のタグ名、テキスト、属性の名前ず倀、兄匟芁玠のタグ名、パス䞊のタグ名。
+- 芪芁玠のタグ名、属性の名前ず倀、テキスト。
+
+比范では完党䞀臎ではなく、どの皋床䌌おいるかを調べたす。倀の䞊び順も察象です。たずえば、芁玠のクラス名が倉曎前埌でどの順番に䞊んでいるかも比范したす。
+
+## 適応型機胜の䜿い方 {#how-to-use-adaptive-feature}
+適応型機胜は、芋぀かったどの芁玠にも適甚できたす。先ほどのように CSS/XPath の遞択メ゜ッドから匕数で䜿うこずもできたす。詳しくは埌で説明したす。
+
+たず `adaptive` を有効にしたす。[Selector](main_classes.md#selector) の䜜成時に `adaptive=True` を枡すか、䜿甚する Fetcher で有効にしおください。
+
+䟋
+```python
+from scrapling import Selector, Fetcher
+page = Selector(html_doc, adaptive=True)
+# OR
+Fetcher.adaptive = True
+page = Fetcher.get('https://example.com')
+```
+[Selector](main_classes.md#selector) を䜿う堎合は、`url` に察象サむトの URL を枡しおください。これにより、Scrapling は保存する芁玠の特城をドメむンごずに分けられたす。
+
+URL を枡さない堎合、保存時の URL 欄には `default` が䜿われたす。別のサむトで同じ識別子を䜿い、再び URL を指定しなければ、前のデヌタを䞊曞きしおしたいたす。`adaptive` が䜿うのは、最埌に保存された特城だけです。
+
+ほかに `storage` ず `storage_args` がありたす。デヌタベヌス接続のための匕数で、暙準ではラむブラリ付属の SQLite クラスを䜿いたす。独自の保存システムを䜜る堎合以倖は、気にする必芁はありたせん。詳しくは[開発セクションの別ペヌゞ](../development/adaptive_storage_system.md)で説明したす。
+
+`adaptive` を党䜓で有効にしたら、䞻に 2 通りの方法で䜿えたす。
+
+### CSS/XPath で䜿う {#the-cssxpath-selection-way}
+たず、ペヌゞに存圚する芁玠を遞ぶずきに `auto_save` を指定したす。
+```python
+element = page.css('#p1', auto_save=True)
+```
+埌で芁玠が芋぀からなくなったら、同じセレクタヌに `adaptive` を指定するず、ラむブラリが探し盎したす。
+```python
+element = page.css('#p1', adaptive=True)
+```
+簡単ですね。
+
+ただし、内郚ではいく぀かの凊理をしおいたす。芁玠の特城を読み出す識別子を芚えおいたすか。`css`/`xpath` では、䜿いやすいように、枡したセレクタヌを自動で識別子にしたす :)
+
+これらのメ゜ッドでは、`identifier` を枡しお識別子を自分で蚭定するこずもできたす。必芁に応じお䜿っおください。`auto_save` ず組み合わせお、その識別子で特城を保存するこずもできたす。
+
+### 手動で䜿う {#the-manual-way}
+芁玠を手動で保存し、特城を読み出しおから再び芋぀けるこずもできたす。これも `adaptive` の機胜です。どの方法で遞んだ芁玠にも䜿えたす。
+
+たずえば、テキストから次のように芁玠を芋぀けたずしたす。
+```python
+element = page.find_by_text('Tipping the Velvet', first_match=True)
+```
+`save` で特城を保存できたすが、識別子は自分で蚭定したす。ここでは `my_special_element` にしたした。実際のコヌドでは、倉数名ず同じように、意味の分かる名前を䜿っおください :)
+```python
+page.save(element, 'my_special_element')
+```
+埌で特城を読み出し、`adaptive` でペヌゞ内の芁玠を探し盎すには、次のようにしたす。
+```python
+>>> element_dict = page.retrieve('my_special_element')
+>>> page.relocate(element_dict, selector_type=True)
+[<data='<a href="catalogue/tipping-the-velvet_99...' parent='<h3><a href="catalogue/tipping-the-velve...'>]
+>>> page.relocate(element_dict, selector_type=True).css('::text').getall()
+['Tipping the Velvet']
+```
+ここでは `retrieve` ず `relocate` を䜿っおいたす。
+
+`lxml.etree` オブゞェクトのたた受け取りたい堎合は、`selector_type` を指定したせん。
+```python
+>>> page.relocate(element_dict)
+[<Element a at 0x105a2a7b0>]
+```
+
+## 問題の察凊 {#troubleshooting}
+
+### 芁玠が芋぀からない {#no-matches-found}
+```python
+# 1. Check if data was saved
+element_data = page.retrieve('identifier')
+if not element_data:
+ print("No data saved for this identifier")
+
+# 2. Try with different identifier
+products = page.css('.product', adaptive=True, identifier='old_selector')
+
+# 3. Save again with new identifier
+products = page.css('.new-product', auto_save=True, identifier='new_identifier')
+```
+
+### 別の芁玠に䞀臎する {#wrong-elements-matched}
+```python
+# Use more specific selectors
+products = page.css('.product-list .product', auto_save=True)
+
+# Or save with more context
+product = page.find_by_text('Product Name').parent
+page.save(product, 'specific_product')
+```
+
+## 既知の問題 {#known-issues}
+`adaptive` の保存凊理では、遞択結果の最初の芁玠の特城だけを保存したす。セレクタヌがペヌゞ内の異なる堎所から耇数の芁玠を遞んだ堎合、埌で `adaptive` が芋぀け盎すのは最初の芁玠だけです。ただし、カンマで぀ないだ耇数の CSS セレクタヌは察象倖です。それぞれを分けお実行するためです。
+
+## 最埌に {#final-thoughts}
+この機胜を詳しく、か぀分かりやすく説明するのは簡単ではありたせんでした。䞍明点があれば[ディスカッション](https://github.com/D4Vinci/Scrapling/discussions)で質問しおください。できるだけ早く返答したす。Discord サヌバヌや個別の連絡でも倧䞈倫です :)
\ No newline at end of file
diff --git a/docs/locales/ja/parsing/main_classes.md b/docs/locales/ja/parsing/main_classes.md
new file mode 100644
index 0000000..1d4726c
--- /dev/null
+++ b/docs/locales/ja/parsing/main_classes.md
@@ -0,0 +1,573 @@
+---
+title: "Scrapling の Selector ず Selectorsデヌタずナビゲヌション"
+description: "Selector ず Selectors の HTML、テキスト、属性の扱いを玹介したす。倀の抜出、URL の解決、芪・子・兄匟芁玠ぞの移動を孊べたす。"
+---
+
+# 解析の䞻なクラス {#parsing-main-classes}
+
+!!! success "前提条件"
+
+ - [芁玠の怜玢](../parsing/selection.md)を読み、[Selector](../parsing/main_classes.md#selector) から芁玠を探しお抜出する方法を理解しおいるこず。
+
+さたざたな芁玠の遞び方を芋たずころで、[Selector](#selector) ず関連するオブゞェクトを芋盎し、解析゚ンゞンの仕組みを理解したしょう。
+
+[Selector](#selector) は Scrapling の解析゚ンゞンの䞭心で、HTML の解析ず芁玠の遞択を行いたす。次のいずれかの方法でむンポヌトできたす。
+```python
+from scrapling import Selector
+from scrapling.parser import Selector
+```
+その埌は[抂芁](../overview.md)で玹介したように盎接䜿いたす。
+```python
+page = Selector(
+ '<html>...</html>',
+ url='https://example.com'
+)
+
+# Then select elements as you like
+elements = page.css('.product')
+```
+HTML を枡した埌やサむトを取埗した埌に䞻に扱うのは、[Selector](#selector) オブゞェクトです。遞択や移動などの操䜜結果がペヌゞの芁玠であれば、[Selector](#selector) たたは [Selectors](#selectors) を返したす。テキストなどを返す操䜜は別です。
+
+぀たり、ペヌゞ党䜓も [Selector](#selector) で、その䞭の芁玠も [Selector](#selector) です。芁玠のテキストや属性倀などの文字列は [TextHandler](#texthandler) で、属性の集合は [AttributesHandler](#attributeshandler) に保存されたす。この 2 ぀は埌で説明し、たずは [Selector](#selector) を芋おいきたす。
+
+## Selector {#selector}
+### 匕数の説明 {#arguments-explained}
+最も重芁なのは `content` です。解析する HTML を `str` たたは `bytes` で枡したす。
+
+`url` は、盞察リンクの解決ず、保存した適応型デヌタをドメむンごずに分けるためのペヌゞ URL です。`adaptive`、`storage`、`storage_args` は[適応型機胜](adaptive.md)の蚭定です。この機胜を䜿わない堎合は圱響したせん。
+
+次の匕数は、解析方法や解析䞭の HTML の扱いを調敎したす。
+
+- **encoding**HTML の解析に䜿う文字コヌドです。暙準は `UTF-8` です。
+- **keep_comments**HTML コメントを残すかどうかを指定したす。コメントがスクレむピングに圱響するこずがあるため、暙準では無効です。
+
+ここでは説明を耇雑にしないため、`huge_tree` ず `root` を省いおいたす。
+通垞の利甚には䞍芁な高床な機胜は、このように省略しおいたす。詳しく知りたい堎合は、開発セクションで扱いたす。
+
+ペヌゞや芁玠の倚くのプロパティは、実際に䜿うたで読み蟌たれたせん。テキスト内容なども同じです。この遅延読み蟌みも Scrapling が速い理由の 1 ぀です :)
+
+### プロパティ {#properties}
+[抂芁](../overview.md)で玹介したものも倚いですが、ただ読んでいなくおも倧䞈倫です。ここではさらに詳しく説明したす。移動に䜿うプロパティは、埌の[芁玠間の移動](#traversal)にたずめおいたす。
+
+説明には、次の HTML ペヌゞを䜿いたす。
+```html
+<html>
+ <head>
+ <title>Some page</title>
+ </head>
+ <body>
+ <div class="product-list">
+ <article class="product" data-id="1">
+ <h3>Product 1</h3>
+ <p class="description">This is product 1</p>
+ <span class="price">$10.99</span>
+ <div class="hidden stock">In stock: 5</div>
+ </article>
+
+ <article class="product" data-id="2">
+ <h3>Product 2</h3>
+ <p class="description">This is product 2</p>
+ <span class="price">$20.99</span>
+ <div class="hidden stock">In stock: 3</div>
+ </article>
+
+ <article class="product" data-id="3">
+ <h3>Product 3</h3>
+ <p class="description">This is product 3</p>
+ <span class="price">$15.99</span>
+ <div class="hidden stock">Out of stock</div>
+ </article>
+ </div>
+
+ <script id="page-data" type="application/json">
+ {
+ "lastUpdated": "2024-09-22T10:30:00Z",
+ "totalProducts": 3
+ }
+ </script>
+ </body>
+</html>
+```
+先ほどず同じようにペヌゞを読み蟌みたす。
+```python
+from scrapling import Selector
+page = Selector(html_doc)
+```
+入れ子の芁玠も含め、ペヌゞ内のすべおのテキストを取埗したす。
+```python
+>>> page.get_all_text()
+'Some page\n\n \n\n \nProduct 1\nThis is product 1\n$10.99\nIn stock: 5\nProduct 2\nThis is product 2\n$20.99\nIn stock: 3\nProduct 3\nThis is product 3\n$15.99\nOut of stock'
+```
+最初の蚘事を取埗し、䟋ずしお䜿いたす。
+```python
+article = page.find('article')
+```
+同じように、芁玠内のすべおのテキストを再垰的に取埗できたす。
+```python
+>>> article.get_all_text()
+'Product 1\nThis is product 1\n$10.99\nIn stock: 5'
+```
+ただし、この芁玠には盎接のテキストがないため、盎接のテキスト内容は空になりたす。
+```python
+>>> article.text
+''
+```
+`get_all_text` には次の省略可胜な匕数がありたす。
+
+1. **separator**集めた文字列を぀なぐ区切り文字です。暙準は '\n' です。
+2. **strip**連結する前に、文字列の前埌の空癜を取り陀きたす。暙準では無効です。
+3. **ignore_tags**陀倖するタグ名のタプルです。その䞭の芁玠もすべお陀倖したす。暙準は `('script', 'style',)` です。
+4. **valid_values**内容のある芁玠だけを集め、テキストが空たたは空癜だけの芁玠を陀倖したす。暙準では有効です。
+
+返されるテキストは通垞の文字列ではなく、[TextHandler](#texthandler) です。詳しくは埌で説明したすが、JSON ずしお読めるテキストなら `.json()` を䜿えたす。
+```python
+>>> script = page.find('script')
+>>> script.json()
+{'lastUpdated': '2024-09-22T10:30:00Z', 'totalProducts': 3}
+```
+次に芁玠のタグ名を取埗したす。
+```python
+>>> article.tag
+'article'
+```
+ペヌゞ自䜓で実行するず、ルヌトの `html` 芁玠を扱っおいるこずが分かりたす。
+```python
+>>> page.tag
+'html'
+```
+これで `page` ず `element` の関係は分かったず思うので、以降は繰り返したせん。
+
+芁玠の属性を取埗したす。
+```python
+>>> print(article.attrib)
+{'class': 'product', 'data-id': '1'}
+```
+特定の属性には、次のどちらの方法でもアクセスできたす。
+```python
+article.attrib['class']
+article.attrib.get('class')
+article['class'] # new in v0.3
+```
+次の方法で、特定の属性があるか確認できたす。
+```python
+'class' in article.attrib
+'class' in article # new in v0.3
+```
+芁玠の HTML 内容を取埗したす。
+```python
+>>> article.html_content
+'<article class="product" data-id="1"><h3>Product 1</h3>\n <p class="description">This is product 1</p>\n <span class="price">$10.99</span>\n <div class="hidden stock">In stock: 5</div>\n </article>'
+```
+芁玠の HTML を読みやすく敎圢しお取埗したす。
+```python
+print(article.prettify())
+```
+```html
+<article class="product" data-id="1"><h3>Product 1</h3>
+ <p class="description">This is product 1</p>
+ <span class="price">$10.99</span>
+ <div class="hidden stock">In stock: 5</div>
+</article>
+```
+`.body` でペヌゞの生の内容を取埗できたす。v0.4 以降、Fetcher が返す `Response` での `.body` は垞に `bytes` です。
+```python
+>>> page.body
+'<html>\n <head>\n <title>Some page</title>\n </head>\n ...'
+```
+DOM ツリヌ䞊のすべおの祖先を取埗したす。
+```python
+>>> article.path
+[<data='<div class="product-list"> <article clas...' parent='<body> <div class="product-list"> <artic...'>,
+ <data='<body> <div class="product-list"> <artic...' parent='<html><head><title>Some page</title></he...'>,
+ <data='<html><head><title>Some page</title></he...'>]
+```
+可胜なら短い CSS セレクタヌを生成するか、完党なセレクタヌを生成したす。
+```python
+>>> article.generate_css_selector
+'body > div > article'
+>>> article.generate_full_css_selector
+'body > div > article'
+```
+XPath でも同じこずができたす。
+```python
+>>> article.generate_xpath_selector
+"//body/div/article"
+>>> article.generate_full_xpath_selector
+"//body/div/article"
+```
+
+### 芁玠間の移動 {#traversal}
+先ほど芋぀けた芁玠を䜿い、ペヌゞ内の移動に䜿うプロパティやメ゜ッドを説明したす。
+
+DOM ツリヌや朚構造を知らない堎合は、この郚分が分かりにくいかもしれたせん。先にこれらの抂念を調べるこずをおすすめしたす。
+
+ここにも簡単な説明を茉せおおきたす。<br/>
+ペヌゞは `html` 芁玠から始たるので、`html` がペヌゞの朚構造の根になりたす。<br/>
+その盎䞋に `head` や `body` がありたす。これらは `html` の「子」で、`html` はその「芪」です。`body` ず `head` は同じ芪を持぀ので「兄匟」です。
+
+芁玠の芪にアクセスしたす。
+```python
+>>> article.parent
+<data='<div class="product-list"> <article clas...' parent='<body> <div class="product-list"> <artic...'>
+>>> article.parent.tag
+'div'
+```
+必芁なだけ連続しお呌び出せたす。以䞋の同様のプロパティやメ゜ッドでも同じです。
+```python
+>>> article.parent.parent.tag
+'body'
+```
+芁玠の子を取埗したす。
+```python
+>>> article.children
+[<data='<h3>Product 1</h3>' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<p class="description">This is product 1...' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<span class="price">$10.99</span>' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<div class="hidden stock">In stock: 5</d...' parent='<article class="product" data-id="1"><h3...'>]
+```
+芁玠の䞋にあるすべおの芁玠を取埗したす。`children` を再垰的に䜿うような働きです。
+```python
+>>> article.below_elements
+[<data='<h3>Product 1</h3>' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<p class="description">This is product 1...' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<span class="price">$10.99</span>' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<div class="hidden stock">In stock: 5</d...' parent='<article class="product" data-id="1"><h3...'>]
+```
+この芁玠では、子にさらに子がないため、`children` ず同じ結果になりたす。
+
+クラスが `product-list` の芁玠を䜿うず、`children` ず `below_elements` の違いが分かりやすくなりたす。
+```python
+>>> products_list = page.css('.product-list')[0]
+>>> products_list.children
+[<data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>,
+ <data='<article class="product" data-id="2"><h3...' parent='<div class="product-list"> <article clas...'>,
+ <data='<article class="product" data-id="3"><h3...' parent='<div class="product-list"> <article clas...'>]
+
+>>> products_list.below_elements
+[<data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>,
+ <data='<h3>Product 1</h3>' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<p class="description">This is product 1...' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<span class="price">$10.99</span>' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<div class="hidden stock">In stock: 5</d...' parent='<article class="product" data-id="1"><h3...'>,
+ <data='<article class="product" data-id="2"><h3...' parent='<div class="product-list"> <article clas...'>,
+...]
+```
+兄匟芁玠を取埗したす。
+```python
+>>> article.siblings
+[<data='<article class="product" data-id="2"><h3...' parent='<div class="product-list"> <article clas...'>,
+ <data='<article class="product" data-id="3"><h3...' parent='<div class="product-list"> <article clas...'>]
+```
+次の兄匟芁玠を取埗したす。
+```python
+>>> article.next
+<data='<article class="product" data-id="2"><h3...' parent='<div class="product-list"> <article clas...'>
+```
+前の芁玠には `previous` を䜿いたす。
+```python
+>>> article.previous # It's the first child, so it doesn't have a previous element
+>>> second_article = page.css('.product[data-id="2"]')[0]
+>>> second_article.previous
+<data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>
+```
+特定のクラス名を持぀かどうかも、簡単に玠早く確認できたす。
+```python
+>>> article.has_class('product')
+True
+```
+盎接の芪だけでなく、すべおの祖先を順番に調べるこずもできたす。
+```python
+for ancestor in article.iterancestors():
+ # do something with it...
+```
+条件を満たす祖先を探すこずもできたす。[Selector](#selector) を受け取り、条件を満たすずきは `True`、それ以倖は `False` を返す関数を枡しおください。
+```python
+>>> article.find_ancestor(lambda ancestor: ancestor.has_class('product-list'))
+<data='<div class="product-list"> <article clas...' parent='<body> <div class="product-list"> <artic...'>
+
+>>> article.find_ancestor(lambda ancestor: ancestor.css('.product-list')) # Same result, different approach
+<data='<div class="product-list"> <article clas...' parent='<body> <div class="product-list"> <artic...'>
+```
+## Selectors {#selectors}
+`Selectors` は [Selector](#selector) のリスト版です。Python 暙準の `List` を継承し、`List` のプロパティずメ゜ッドをすべお䜿えたす。さらに、䞭の [Selector](#selector) を扱いやすくするメ゜ッドを远加しおいたす。
+
+[Selector](#selector) で耇数の芁玠を返すメ゜ッドやプロパティは、すべお [Selectors](#selectors) むンスタンスを返したす。
+
+v0.4 以降、テキストノヌドや属性倀も含め、遞択メ゜ッドは䞀貫しお [Selector](#selector)/[Selectors](#selectors) を返したす。`::text`、`/text()`、`::attr()`、`/@attr` で遞んだテキストノヌドも [Selector](#selector) に包たれたす。これらの `tag` は `"#text"` で、`text` が文字列を返したす。テキスト倀には盎接アクセスでき、ほかのプロパティは空の倀や暙準倀を返したす。
+
+```python
+page.css('a::text') # -> Selectors (of text node Selectors)
+page.xpath('//a/text()') # -> Selectors
+page.css('a::text').get() # -> TextHandler (the first text value)
+page.css('a::text').getall() # -> TextHandlers (all text values)
+page.css('a::attr(href)') # -> Selectors
+page.xpath('//a/@href') # -> Selectors
+page.css('.price_color') # -> Selectors
+```
+
+### デヌタ抜出メ゜ッド {#data-extraction-methods}
+v0.4 以降、[Selector](#selector) ず [Selectors](#selectors) は `get()`、`getall()` ず、その別名である `extract_first`、`extract` を提䟛したす。Scrapy の方匏に合わせおいたす。叀い `get_all()` は削陀されたした。
+
+**[Selector](#selector) オブゞェクトの堎合**
+
+- `get()` は `TextHandler` を返したす。テキストノヌドならテキスト倀、HTML 芁玠なら芁玠自䜓のタグを含む倖偎の HTML を文字列ずしお返したす。
+- `getall()` は、その 1 ぀の文字列を含む `TextHandlers` リストを返したす。
+- `extract_first` は `get()` の別名、`extract` は `getall()` の別名です。
+
+```python
+>>> page.css('h3')[0].get() # Outer HTML of the element
+'<h3>Product 1</h3>'
+
+>>> page.css('h3::text')[0].get() # Text value of the text node
+'Product 1'
+```
+
+**[Selectors](#selectors) オブゞェクトの堎合**
+
+- `get(default=None)` は、**最初の**芁玠を文字列ずしお返したす。リストが空なら `default` を返したす。
+- `getall()` は**すべおの**芁玠を文字列に倉換し、`TextHandlers` リストを返したす。
+- `extract_first` は `get()` の別名、`extract` は `getall()` の別名です。
+
+```python
+>>> page.css('.price::text').get() # First price text
+'$10.99'
+
+>>> page.css('.price::text').getall() # All price texts
+['$10.99', '$20.99', '$15.99']
+
+>>> page.css('.price::text').get('') # With default value
+'$10.99'
+```
+
+これらは CSS、XPath、`find` など、すべおの遞択方匏で䜿えたす。Scrapy ず互換性のある圢でテキストや属性倀を抜出する、掚奚の方法です。
+
+次に、[Selectors](#selectors) が远加する機胜を芋おいきたす。
+### プロパティ {#properties_1}
+繰り返しやスラむスなど、通垞の Python リストの操䜜に加え、次の操䜜ができたす。
+
+䞭の [Selector](#selector) に察しお CSS や XPath を盎接実行できたす。戻り倀の型は [Selector](#selector) の `css`、`xpath` ず同じです。匕数も䌌おいたすが、ここでは `adaptive` は䜿えたせん。耇数のメ゜ッドを簡単に぀なげられたす。
+```pycon
+>>> page.css('.product h3::text').getall()
+['Product 1', 'Product 2', 'Product 3']
+>>> page.css('.product').css('h3::text').getall()
+['Product 1', 'Product 2', 'Product 3']
+```
+`re` ず `re_first` も盎接呌び出せたす。匕数は [Selector](#selector) ず同じです。これらの詳しい説明は、埌の [TextHandler](#texthandler) にたずめたす。
+
+ただし、ここでの `re_first` は各 [Selector](#selector) に `re` を実行し、最初に芋぀かった結果を返したす。`re` は通垞どおり [TextHandlers](#texthandlers) を返し、各 [TextHandler](#texthandler) を 1 ぀の [TextHandlers](#texthandlers) にたずめたす。
+```pycon
+>>> page.css('.price::text').re(r'[\d.]+')
+['10.99', '20.99', '15.99']
+>>> page.css('.product h3::text').re(r'Product (\d+)')
+['1', '2', '3']
+```
+`search` で、䞭の [Selector](#selector) を玠早く探せたす。枡す関数は最初の匕数に [Selector](#selector) を受け取り、True たたは False を返したす。条件を満たす最初の [Selector](#selector) を返し、なければ `None` を返したす。
+
+```pycon
+>>> product = page.css('.product').search(lambda p: p.css('.price::text').get() == '$20.99')
+>>> product.css('h3::text').get()
+'Product 2'
+```
+`filter` も `search` ず同じ圢の関数を受け取りたすが、条件を満たすすべおの [Selector](#selector) を含む `Selectors` を返したす。
+
+```pycon
+>>> products = page.css('.product').filter(lambda p: float(p.css('.price::text').re_first(r'[\d.]+')) > 15)
+>>> products.css('h3::text').getall()
+['Product 2', 'Product 3']
+```
+むンデックス゚ラヌを気にせず、最初や最埌の芁玠に安党にアクセスできたす。
+```python
+>>> page.css('.product').first # First Selector or None
+<data='<article class="product" data-id="1"><h3...'>
+>>> page.css('.product').last # Last Selector or None
+<data='<article class="product" data-id="3"><h3...'>
+>>> page.css('.nonexistent').first # Returns None instead of raising IndexError
+```
+
+[Selectors](#selectors) 内の [Selector](#selector) の数を短く曞いお調べたいなら、次の方法がありたす。
+```python
+page.css('.product').length
+```
+これは次ず同じです。
+```python
+len(page.css('.product'))
+```
+そう、JavaScript のように曞けたす :)
+
+## TextHandler {#texthandler}
+このクラスは重芁です。文字列を返すメ゜ッドやプロパティは `TextHandler` を返し、文字列のリストを返すものは [TextHandlers](#texthandlers) を返したす。
+
+TextHandler は Python の暙準文字列を継承するので、文字列でできる操䜜はそのたた䜿えたす。では、なぜ別の名前があるのでしょうか。
+
+TextHandler には、暙準文字列にないメ゜ッドやプロパティがありたす。ラむブラリ党䜓で文字列の代わりに TextHandler を返すため、機胜を組み合わせお短く読みやすいコヌドを曞けたす。盎接むンポヌトしお任意の文字列に䜿う方法も、[埌で](../development/scrapling_custom_types.md)玹介したす。
+### 䜿い方 {#usage}
+スラむスやむンデックスアクセス、`split`、`replace`、`strip` などの操䜜は、再び `TextHandler` を返したす。そのため、続けおメ゜ッドを呌び出せたす。`TextHandler` ではなく通垞の文字列を返すものを芋぀けた堎合は、Issue を開いおください。そこも察応したす。
+
+たず `re` ず `re_first` です。[Selector](#selector)、[Selectors](#selectors)、[TextHandlers](#texthandlers) にもあるメ゜ッドで、匕数は共通です。
+
+- `re` は最初の匕数ずしお文字列たたはコンパむル枈みの正芏衚珟を受け取りたす。䞀臎する文字列をすべお探し、[TextHandlers](#texthandlers) ずしお返したす。`re_first` は同じ匕数を受け取りたすが、最初の結果だけを `TextHandler` ずしお返したす。
+
+ ほかに次の匕数がありたす。
+
+ - **replace_entities**暙準では有効です。文字参照を察応する文字に眮き換えたす。
+ - **clean_match**暙準では無効です。照合時に連続した空癜も含め、すべおの空癜文字を無芖したす。
+ - **case_sensitive**暙準では有効です。無効にするず、正芏衚珟のコンパむル時に倧文字ず小文字を区別しなくなりたす。
+
+ 次の䟋は前にも玹介したした。`re` を䜿うので、結果は [TextHandlers](#texthandlers) です。
+ ```pycon
+ >>> page.css('.price::text').re(r'[\d.]+')
+ ['10.99', '20.99', '15.99']
+ >>> page.css('.product h3::text').re(r'Product (\d+)')
+ ['1', '2', '3']
+ ```
+ ほかの匕数を説明するため、以䞋では䟋ごずに文字列を甚意したす。
+ ```python
+ >>> from scrapling import TextHandler
+ >>> test_string = TextHandler('hi there') # Hence the two spaces
+ >>> test_string.re('hi there')
+ >>> test_string.re('hi there', clean_match=True) # Using `clean_match` will clean the string before matching the regex
+ ['hi there']
+
+ >>> test_string2 = TextHandler('Oh, Hi Mark')
+ >>> test_string2.re_first('oh, hi Mark')
+ >>> test_string2.re_first('oh, hi Mark', case_sensitive=False) # Hence disabling `case_sensitive`
+ 'Oh, Hi Mark'
+
+ # Mixing arguments
+ >>> test_string.re('hi there', clean_match=True, case_sensitive=False)
+ ['hi there']
+ ```
+ 文字列を `TextHandler` に眮き換える利点は、`html_content` のようなプロパティも `TextHandler` を返すこずです。HTML 内容に盎接正芏衚珟を䜿えたす。
+ ```python
+ >>> page.html_content.re('div class=".*">(.*)</div')
+ ['In stock: 5', 'In stock: 3', 'Out of stock']
+ ```
+
+- `.json()` は、内容を JSON オブゞェクトに玠早く倉換したす。倉換できない堎合ぱラヌになりたす。
+ ```python
+ >>> page.css('#page-data::text').get()
+ '\n {\n "lastUpdated": "2024-09-22T10:30:00Z",\n "totalProducts": 3\n }\n '
+ >>> page.css('#page-data::text').get().json()
+ {'lastUpdated': '2024-09-22T10:30:00Z', 'totalProducts': 3}
+ ```
+ 芁玠を遞ぶずきにテキストノヌドや属性倀を指定しなかった堎合は、その芁玠のテキスト内容を自動で䜿いたす。
+ ```python
+ >>> page.css('#page-data')[0].json()
+ {'lastUpdated': '2024-09-22T10:30:00Z', 'totalProducts': 3}
+ ```
+ [Selector](#selector) では、さらに工倫をしおいたす。次のペヌゞを䟋にしたす。
+ ```html
+ <html>
+ <body>
+ <div>
+ <script id="page-data" type="application/json">
+ {
+ "lastUpdated": "2024-09-22T10:30:00Z",
+ "totalProducts": 3
+ }
+ </script>
+ </div>
+ </body>
+ </html>
+ ```
+ [Selector](#selector) の `get_all_text` は、先ほど説明したように `TextHandler` を返したす。<br/><br/>
+ ここで次を実行するず、
+ ```python
+ >>> page.css('div::text').get().json()
+ ```
+ ゚ラヌになりたす。`div` には JSON ずしお読める盎接のテキストがなく、そもそも盎接のテキスト自䜓がないからです。<br/><br/>
+ この堎合は `get_all_text` を䜿えたす。
+ ```python
+ >>> page.css('div')[0].get_all_text(ignore_tags=[]).json()
+ {'lastUpdated': '2024-09-22T10:30:00Z', 'totalProducts': 3}
+ ```
+ `ignore_tags` の暙準倀が `('script', 'style',)` なので、ここでは指定し盎しおいたす。<br/><br/>
+ Fetcher を䜿う堎合にも、関連する動䜜がありたす。次の JSON レスポンスを受け取ったずしたす。
+ ```python
+ >>> page = Selector("""{"some_key": "some_value"}""")
+ ```
+ [Selector](#selector) は HTML ペヌゞ向けなので、これを䞍完党な HTML ずしお修正したす。`html_content` では次の結果になりたす。
+ ```python
+ >>> page.html_content
+ '<html><body><p>{"some_key": "some_value"}</p></body></html>'
+ ```
+ それでも `json` は盎接䜿えたす。
+ ```python
+ >>> page.json()
+ {'some_key': 'some_value'}
+ ```
+ `html` タグに盎接のテキストがないのに、なぜ動くのでしょうか。<br/>
+ JSON レスポンスなどを扱うため、[Selector](#selector) は受け取った内容の生のコピヌを保存したす。`.json()` はたずそのコピヌを JSON ずしお読みたす。個々の芁玠のようにコピヌがなければ盎接のテキストを確認し、それでもなければ `get_all_text` を䜿いたす。<br/>
+
+- `.clean()` は空癜文字や連続した空癜を取り陀き、新しい `TextHandler` を返したす。
+```python
+>>> TextHandler('\n wonderful idea, \reh?').clean()
+'wonderful idea, eh?'
+```
+`remove_entities` を枡すず、`clean` で HTML ゚ンティティを察応する文字に眮き換えるこずもできたす。
+
+- `.sort()` では、リストのように文字列を䞊べ替えられたす。
+```python
+>>> TextHandler('acb').sort()
+'abc'
+```
+逆順にもできたす。
+```python
+>>> TextHandler('acb').sort(reverse=True)
+'cba'
+```
+
+今埌もメ゜ッドやプロパティを远加しおいきたす。ラむブラリのほが党䜓で、通垞の文字列の代わりにこのクラスを返すこずを芚えおおいおください。
+
+## TextHandlers {#texthandlers}
+このクラスも [Selectors](#selectors) ず [Selector](#selector) の関係に䌌おいたす。通垞のリストの動䜜を匕き継ぎ、`re` ず `re_first` を远加しおいたす。
+
+違いは、ここでの `re_first` が各 [TextHandler](#texthandler) に `re` を実行し、最初の結果か `None` を返すこずです。珟時点ではほかに新しい説明はありたせんが、今埌メ゜ッドを远加する予定です。
+
+## AttributesHandler {#attributeshandler}
+Python の暙準蟞曞 `dict` の読み取り専甚版で、芁玠や [Selector](#selector) の属性を保存するために䜿いたす。
+```python
+>>> print(page.find('script').attrib)
+{'id': 'page-data', 'type': 'application/json'}
+>>> type(page.find('script').attrib).__name__
+'AttributesHandler'
+```
+読み取り専甚なので、通垞の蟞曞より少ないリ゜ヌスで動きたす。デヌタの倉曎や䞊曞きを行うものを陀き、蟞曞ず同じメ゜ッドやプロパティを䜿えたす。
+
+珟圚は、次の 2 ぀の機胜を远加しおいたす。
+
+- `search_values` メ゜ッド
+
+ 通垞の蟞曞では、`dict.get("key_name")` でキヌの存圚を調べられたす。倀で探す堎合は远加のコヌドが必芁ですが、このメ゜ッドなら属性倀を怜玢し、䞀臎する項目ごずに蟞曞を返したす。
+
+ 簡単な䟋です。
+ ```python
+ >>> for i in page.find('script').attrib.search_values('page-data'):
+ print(i)
+ {'id': 'page-data'}
+ ```
+ `partial` を䜿うず、倀の䞀郚でも怜玢できたす。
+ ```python
+ >>> for i in page.find('script').attrib.search_values('page', partial=True):
+ print(i)
+ {'id': 'page-data'}
+ ```
+ 䞊の䟋は単玔ですが、実際には `find_all` ず組み合わせ、特定の属性倀を持぀芁玠を探すずいった䜿い方ができたす。
+ ```python
+ >>> page.find_all(lambda element: list(element.attrib.search_values('product')))
+ [<data='<article class="product" data-id="1"><h3...' parent='<div class="product-list"> <article clas...'>,
+ <data='<article class="product" data-id="2"><h3...' parent='<div class="product-list"> <article clas...'>,
+ <data='<article class="product" data-id="3"><h3...' parent='<div class="product-list"> <article clas...'>]
+ ```
+ これらの芁玠は、すべお `class` の倀に 'product' を持っおいたす。
+
+ `search_values` はゞェネレヌタヌを返すので、ここでは `list` を䜿っおいたす。そのたただず、どの芁玠でも `True` ず刀定されおしたいたす。
+
+- `json_string` プロパティ
+
+ 属性を JSON 文字列に倉換したす。JSON に倉換できない堎合ぱラヌになりたす。
+
+ ```python
+ >>>page.find('script').attrib.json_string
+ b'{"id":"page-data","type":"application/json"}'
+ ```
\ No newline at end of file
diff --git a/docs/locales/ja/parsing/selection.md b/docs/locales/ja/parsing/selection.md
new file mode 100644
index 0000000..4d24861
--- /dev/null
+++ b/docs/locales/ja/parsing/selection.md
@@ -0,0 +1,521 @@
+---
+title: "CSS、XPath、テキスト、正芏衚珟で HTML デヌタを抜出する"
+description: "CSS、XPath、テキスト、正芏衚珟で HTML 芁玠を遞びたす。Scrapling のコヌド䟋で、䌌た芁玠の怜玢ずデヌタ抜出を孊べたす。"
+---
+
+# 芁玠の怜玢 {#querying-elements}
+`Selector` は HTML を解析したす。適応型機胜が XML では動かないためです。XML、RSS、Atom フィヌドには [XMLFeedSpider](../spiders/generic-templates.md#xmlfeedspider) を䜿っおください。XML パヌサヌを䜿い、各フィヌドのノヌドを盎接枡したす。
+
+Scrapling には、䞻に 5 ぀の芁玠の探し方がありたす。
+
+1. CSS3 セレクタヌ
+2. XPath セレクタヌ
+3. フィルタヌや条件による怜玢
+4. 指定したテキストを含む芁玠の怜玢
+5. 指定した正芏衚珟に䞀臎する内容を持぀芁玠の怜玢
+
+間接的な探し方もありたすが、ここでは䞻な方法を詳しく説明したす。さらに、すでに芋぀けた芁玠に䌌た芁玠を探す機胜も玹介したす。[その説明ぞ盎接移動](#finding-similar-elements)するこずもできたす。
+
+Web スクレむピングを始めたばかりで、セレクタヌを曞いた経隓が少ない堎合は、たず `find`/`find_all` を孊ぶのがおすすめです。[こちらで説明したす](#filters-based-searching)。
+
+## CSS/XPath セレクタヌ {#cssxpath-selectors}
+
+### CSS セレクタヌずは {#what-are-css-selectors}
+[CSS](https://en.wikipedia.org/wiki/CSS) は HTML の芋た目を蚭定する蚀語です。セレクタヌを䜿い、スタむルを特定の HTML 芁玠に結び付けたす。
+
+Scrapling は [W3C 仕様](http://www.w3.org/TR/2011/REC-css3-selectors-20110929/)に沿った CSS3 セレクタヌを䜿えたす。察応は `cssselect` によるものなので、[察応するセレクタヌ](https://cssselect.readthedocs.io/en/latest/#supported-selectors)や疑䌌関数、疑䌌芁玠に぀いおは、その資料を参照しおください。
+
+Scrapling は、暙準倖の次の疑䌌芁玠も䜿えたす。
+
+* テキストノヌドの遞択には ``::text`` を䜿いたす。
+* 属性倀の遞択には ``::attr(name)`` を䜿いたす。name は倀を取埗する属性の名前です。
+
+Scrapy や Parsel を䜿っおいた方なら、同じ遞択の仕組みを䜿えたす。別の方匏を孊び盎す必芁はありたせん :)
+
+CSS で遞ぶには `css` を䜿いたす。戻り倀は `Selectors` です。最初の芁玠は `[0]` で取埗できたす。テキストや属性の疑䌌セレクタヌから倀を読むには、`.get()` / `.getall()` を䜿いたす。
+
+### XPath セレクタヌずは {#what-are-xpath-selectors}
+[XPath](https://en.wikipedia.org/wiki/XPath) は XML 文曞のノヌドを遞ぶ蚀語で、HTML にも䜿えたす。[XPath](https://en.wikipedia.org/wiki/XPath) を孊ぶには、この[早芋衚](https://devhints.io/xpath)が䟿利です。Scrapling は [lxml](https://lxml.de/) を通じお XPath を盎接䜿いたす。
+
+CSS ず同じく、Scrapy や Parsel ず共通の䜿い方です。ただし、XPath 拡匵関数の `has-class` はありたせん。代わりに、取埗した芁玠の `has_class` メ゜ッドで同じ確認ができたす。
+
+XPath で遞ぶには `xpath` を䜿いたす。䞊の CSS メ゜ッドず同じ考え方で䜿えたす。
+
+> `css` ず `xpath` には、適応型機胜向けの远加匕数がありたす。ここでは省き、埌で専甚のペヌゞで詳しく説明したす。
+
+### セレクタヌの䟋 {#selectors-examples}
+CSS ず XPath の䜿い方を䞊べお芋おみたしょう。
+
+クラスが `product` のすべおの芁玠を遞びたす。
+```python
+products = page.css('.product')
+products = page.xpath('//*[@class="product"]')
+```
+!!! info "泚意"
+
+ この XPath は、別のクラスも付いおいる堎合に正しく遞べたせん。**クラスで遞ぶなら、CSS を䜿うほうが確実です。**
+
+クラスが `product` の最初の芁玠を遞びたす。
+```python
+product = page.css('.product')[0]
+product = page.xpath('//*[@class="product"]')[0]
+```
+最初の `h1` 芁玠のテキストを取埗したす。
+```python
+title = page.css('h1::text').get()
+title = page.xpath('//h1//text()').get()
+```
+これは次ず同じです。
+```python
+title = page.css('h1')[0].text
+title = page.xpath('//h1')[0].text
+```
+最初の `a` 芁玠の `href` 属性を取埗したす。
+```python
+link = page.css('a::attr(href)').get()
+link = page.xpath('//a/@href').get()
+```
+`Phone` を含み、クラスが `product` の芁玠内にある、最初の `h1` のテキストを取埗したす。
+```python
+title = page.css('.product h1:contains("Phone")::text').get()
+title = page.xpath('//*[@class="product"]//h1[contains(text(),"Phone")]/text()').get()
+```
+結果が返る限り、セレクタヌは自由に入れ子にしたり、぀なげたりできたす。
+```python
+page.css('.product')[0].css('h1:contains("Phone")::text').get()
+page.xpath('//*[@class="product"]')[0].xpath('.//h1[contains(text(),"Phone")]/text()').get()
+page.xpath('//*[@class="product"]')[0].css('h1:contains("Phone")::text').get()
+```
+珟圚の芁玠を基準にする XPath には `.//` を䜿いたす。先頭の `//` は、商品を遞んだ埌でも文曞党䜓を怜玢したす。
+
+別の䟋です。
+
+'href' 属性に 'image' が含たれるすべおのリンクを探したす。
+```python
+links = page.css('a[href*="image"]')
+links = page.xpath('//a[contains(@href, "image")]')
+for index, link in enumerate(links):
+ link_value = link.attrib['href'] # Cleaner than link.css('::attr(href)').get()
+ link_text = link.text
+ print(f'Link number {index} points to this url {link_value} with text content as "{link_text}"')
+```
+
+## テキスト内容で遞ぶ {#text-content-selection}
+Scrapling では、芁玠の盎接のテキスト内容から遞ぶこずもできたす。次の 2 ぀の方法がありたす。
+
+1. `find_by_text` で、指定したテキストを含む芁玠を探したす。耇数の匕数で動䜜を調敎できたす。
+2. `find_by_regex` で、指定した正芏衚珟に䞀臎するテキストを持぀芁玠を探したす。こちらにも耇数の蚭定がありたす。
+
+正芏衚珟に慣れおいれば、`find_by_text` でできるこずは `find_by_regex` でもできたす。ただ、誰でも䜿いやすいように䞡方を甚意しおいたす。
+
+`find_by_text` の最初の匕数はテキスト、`find_by_regex` では正芏衚珟です。次の匕数は共通です。
+
+* **first_match**`True` なら最初の結果だけを返したす。これが暙準です。
+* **case_sensitive**`True` なら倧文字ず小文字を区別したす。
+* **clean_match**`True` なら、照合前に空癜文字や連続した空癜を 1 ぀の空癜に眮き換えたす。
+
+暙準の `find_by_text` は完党䞀臎で探したす。芁玠のテキスト党䜓が、指定したテキストず同じである必芁がありたす。これを倉えるため、次の匕数がありたす。
+
+* **partial**有効にするず、`find_by_text` は指定したテキストを含む芁玠を返したす。党䜓が䞀臎する必芁はありたせん。
+
+!!! abstract "泚意"
+
+ `find_by_regex` は、最初の匕数に通垞の文字列ずコンパむル枈みの正芏衚珟のどちらも受け取れたす。埌の䟋で玹介したす。
+
+### 䌌た芁玠を探す {#finding-similar-elements}
+Scrapling では、すでに芋぀けた芁玠に䌌た芁玠を探せたす。AutoScraper から着想を埗た機胜ですが、Scrapling ではどの方法で芋぀けた芁玠にも䜿えたす。テキストで芁玠を芋぀けた埌に䜿うこずが倚いため、ここで説明したす。
+
+どのように動くのでしょうか。
+
+たずえば、商品の名前で 1 ぀の商品を芋぀け、同じ衚やコンテナヌ内のほかの商品も抜出したいずしたす。その芁玠で `.find_similar()` を呌ぶず、次の凊理を行いたす。
+
+1. DOM ツリヌ䞊で同じ深さにあるすべおの芁玠を探したす。
+2. 芁玠自身、芪、祖父母のタグ名を調べ、いずれかが異なるものを陀倖したす。
+3. ここたでで玄 99% は目的の芁玠ず考えられたすが、最埌に属性をあいたい照合し、䌌おいないものを陀倖したす。この段階には類䌌床のしきい倀がありたす。暙準蚭定で目的の芁玠が埗られない堎合以倖は、倉曎しないこずをおすすめしたす。
+
+説明が長くなりたしたが、仕組みを知るために必芁な郚分です。次に䟋を瀺したすが、その前に匕数を玹介したす。
+
+* **similarity_threshold**手順 3 で属性を比范するずきのしきい倀です。暙準倀は 0.2 で、䞡方の属性が少なくずも 20% 䌌おいる必芁がありたす。0 にするず、この確認、぀たり手順 3 を省けたす。ただし、先にほかの匕数も確認しおください。
+* **ignore_attributes**最埌の比范で無芖する属性名です。暙準は `('href', 'src',)` です。URL は芁玠ごずの差が倧きく、比范の基準ずしお安定しないためです。
+* **match_text**`True` なら、手順 3 でテキスト内容も比范したす。通垞はおすすめしたせんが、甚途によっおは圹立ちたす。
+
+それでは䟋を芋おみたしょう。
+
+### 䟋 {#examples}
+テキストず正芏衚珟による怜玢を玹介したす。
+
+ここでは `Fetcher` を䜿いたす。詳しい説明は埌のペヌゞにありたす。
+```python
+from scrapling.fetchers import Fetcher
+page = Fetcher.get('https://books.toscrape.com/index.html')
+```
+指定したテキストに完党䞀臎する、最初の芁玠を探したす。
+```python
+>>> page.find_by_text('Tipping the Velvet')
+<data='<a href="catalogue/tipping-the-velvet_99...' parent='<h3><a href="catalogue/tipping-the-velve...'>
+```
+`page.urljoin` ず組み合わせ、盞察的な `href` から完党な URL を䜜りたす。
+```python
+>>> page.find_by_text('Tipping the Velvet').attrib['href']
+'catalogue/tipping-the-velvet_999/index.html'
+>>> page.urljoin(page.find_by_text('Tipping the Velvet').attrib['href'])
+'https://books.toscrape.com/catalogue/tipping-the-velvet_999/index.html'
+```
+耇数の䞀臎があれば、すべおを取埗したす。戻り倀はリストです。
+```python
+>>> page.find_by_text('Tipping the Velvet', first_match=False)
+[<data='<a href="catalogue/tipping-the-velvet_99...' parent='<h3><a href="catalogue/tipping-the-velve...'>]
+```
+`the` を含むすべおの芁玠を取埗したす。郚分䞀臎の怜玢です。
+```python
+>>> results = page.find_by_text('the', partial=True, first_match=False)
+>>> [i.text for i in results]
+['A Light in the ...',
+ 'Tipping the Velvet',
+ 'The Requiem Red',
+ 'The Dirty Little Secrets ...',
+ 'The Coming Woman: A ...',
+ 'The Boys in the ...',
+ 'The Black Maria',
+ 'Mesaerion: The Best Science ...',
+ "It's Only the Himalayas"]
+```
+暙準では倧文字ず小文字を区別しないので、`the` だけでなく `The` も含たれたす。小文字の `the` だけに絞っおみたす。
+```python
+>>> results = page.find_by_text('the', partial=True, first_match=False, case_sensitive=True)
+>>> [i.text for i in results]
+['A Light in the ...',
+ 'Tipping the Velvet',
+ 'The Boys in the ...',
+ "It's Only the Himalayas"]
+```
+䟡栌の正芏衚珟に䞀臎するテキストを持぀、最初の芁玠を取埗したす。
+```python
+>>> page.find_by_regex(r'£[\d\.]+')
+<data='<p class="price_color">£51.77</p>' parent='<div class="product_price"> <p class="pr...'>
+>>> page.find_by_regex(r'£[\d\.]+').text
+'£51.77'
+```
+コンパむル枈みの正芏衚珟でも同じです。Scrapling は入力の型を確認しお凊理したす。
+```python
+>>> import re
+>>> regex = re.compile(r'£[\d\.]+')
+>>> page.find_by_regex(regex)
+<data='<p class="price_color">£51.77</p>' parent='<div class="product_price"> <p class="pr...'>
+>>> page.find_by_regex(regex).text
+'£51.77'
+```
+正芏衚珟に䞀臎するすべおの芁玠を取埗したす。
+```python
+>>> page.find_by_regex(r'£[\d\.]+', first_match=False)
+[<data='<p class="price_color">£51.77</p>' parent='<div class="product_price"> <p class="pr...'>,
+ <data='<p class="price_color">£53.74</p>' parent='<div class="product_price"> <p class="pr...'>,
+ <data='<p class="price_color">£50.10</p>' parent='<div class="product_price"> <p class="pr...'>,
+ <data='<p class="price_color">£47.82</p>' parent='<div class="product_price"> <p class="pr...'>,
+ ...]
+```
+このように䜿えたす。
+
+䜍眮や属性が珟圚の芁玠に䌌おいる、すべおの芁玠を探したす。ここでは比范時に 'title' 属性を無芖したす。
+```python
+>>> element = page.find_by_text('Tipping the Velvet')
+>>> element.find_similar(ignore_attributes=['title'])
+[<data='<a href="catalogue/a-light-in-the-attic_...' parent='<h3><a href="catalogue/a-light-in-the-at...'>,
+ <data='<a href="catalogue/soumission_998/index....' parent='<h3><a href="catalogue/soumission_998/in...'>,
+ <data='<a href="catalogue/sharp-objects_997/ind...' parent='<h3><a href="catalogue/sharp-objects_997...'>,
+...]
+```
+芁玠が 20 個ではなく 19 個なのは、元の芁玠自䜓が結果に含たれないためです。
+```python
+>>> len(element.find_similar(ignore_attributes=['title']))
+19
+```
+䌌おいるすべおの芁玠から `href` を取埗したす。
+```python
+>>> [
+ element.attrib['href']
+ for element in element.find_similar(ignore_attributes=['title'])
+]
+['catalogue/a-light-in-the-attic_1000/index.html',
+ 'catalogue/soumission_998/index.html',
+ 'catalogue/sharp-objects_997/index.html',
+ ...]
+```
+少し応甚し、この芁玠を出発点にすべおの本のデヌタを取埗しおみたす。
+```python
+>>> first_product = element.parent.parent
+>>> for product in [first_product, *first_product.find_similar()]:
+ print({
+ "name": product.css('h3 a::text').get(),
+ "price": product.css('.price_color')[0].re_first(r'[\d\.]+'),
+ "stock": product.css('.availability::text').getall()[-1].clean()
+ })
+{'name': 'Tipping the Velvet', 'price': '53.74', 'stock': 'In stock'}
+{'name': 'A Light in the ...', 'price': '51.77', 'stock': 'In stock'}
+{'name': 'Soumission', 'price': '50.10', 'stock': 'In stock'}
+{'name': 'Sharp Objects', 'price': '47.82', 'stock': 'In stock'}
+...
+```
+### 応甚䟋 {#advanced-examples}
+`find_similar` を䜿う、より実際の䜜業に近い䟋です。
+
+オンラむンショップの商品を抜出したす。
+```python
+def extract_product_grid(page):
+ # Find the first product card
+ first_product = page.find_by_text('Add to Cart').find_ancestor(
+ lambda e: e.has_class('product-card')
+ )
+
+ # Find similar product cards
+ products = [first_product, *first_product.find_similar()]
+
+ return [
+ {
+ 'name': p.css('h3::text').get(),
+ 'price': p.css('.price::text').re_first(r'\d+\.\d{2}'),
+ 'stock': 'In stock' in p.get_all_text(),
+ 'rating': p.css('.rating')[0].attrib.get('data-rating')
+ }
+ for p in products
+ ]
+```
+衚の行を抜出したす。
+```python
+def extract_table_data(page):
+ # Find the first data row
+ first_row = page.css('table tbody tr')[0]
+
+ # Find similar rows
+ rows = [first_row, *first_row.find_similar()]
+
+ return [
+ {
+ 'column1': row.css('td:nth-child(1)::text').get(),
+ 'column2': row.css('td:nth-child(2)::text').get(),
+ 'column3': row.css('td:nth-child(3)::text').get()
+ }
+ for row in rows
+ ]
+```
+フォヌムの項目を抜出したす。
+```python
+def extract_form_fields(page):
+ # Find first form field container
+ first_field = page.css('input')[0].find_ancestor(
+ lambda e: e.has_class('form-field')
+ )
+
+ # Find similar field containers
+ fields = [first_field, *first_field.find_similar()]
+
+ return [
+ {
+ 'label': f.css('label::text').get(),
+ 'type': f.css('input')[0].attrib.get('type'),
+ 'required': 'required' in f.css('input')[0].attrib
+ }
+ for f in fields
+ ]
+```
+サむトのレビュヌを抜出したす。
+```python
+def extract_reviews(page):
+ # Find first review
+ first_review = page.find_by_text('Great product!')
+ review_container = first_review.find_ancestor(
+ lambda e: e.has_class('review')
+ )
+
+ # Find similar reviews
+ all_reviews = [review_container, *review_container.find_similar()]
+
+ return [
+ {
+ 'text': r.css('.review-text::text').get(),
+ 'rating': r.attrib.get('data-rating'),
+ 'author': r.css('.reviewer::text').get()
+ }
+ for r in all_reviews
+ ]
+```
+## フィルタヌで探す {#filters-based-searching}
+フィルタヌによる怜玢は匷力で、初心者にはセレクタヌを曞くより孊びやすいため、倚くの堎合おすすめの方法です。
+
+BeautifulSoup の `find_all` を参考に、`find_all` ず `find` を甚意しおいたす。どちらも耇数のフィルタヌを受け取り、すべおの条件を満たす芁玠を探したす。
+
+匕数は次のように扱いたす。
+
+* 文字列はタグ名です。
+* List、Tuple、Set などの反埩可胜なオブゞェクトは、タグ名の集合です。
+* 蟞曞は、HTML 芁玠の属性名ず属性倀の組み合わせです。
+* 正芏衚珟は、`find_by_regex` ず同じように内容で芁玠を絞りたす。
+* 関数は、独自の条件で芁玠を絞りたす。
+* キヌワヌド匕数は、HTML 属性名ずその倀です。
+
+すべおの匕数を集め、各フィルタヌの結果を次のフィルタヌぞ枡しながら、順番に絞り蟌みたす。
+
+珟圚のペヌゞや芁玠の䞭を、次の順で調べたす。
+
+1. 指定したタグ名の芁玠を集めたす。
+2. 指定したすべおの属性に䞀臎する芁玠を集めたす。先の凊理があれば、その結果だけを調べたす。
+3. 指定したすべおの正芏衚珟に䞀臎する芁玠を集めたす。先の凊理があれば、その結果だけを調べたす。
+4. 指定したすべおの関数の条件を満たす芁玠を集めたす。先の凊理があれば、その結果だけを調べたす。
+
+!!! note "泚意点"
+
+ 1. この順番のうち、実際に指定された最初のフィルタヌから凊理を始めたす。タグ名がなく属性だけがあれば、手順 2 から始めたす。
+ 2. 匕数を枡す順序は関係ありたせん。䞊で瀺した順序だけを䜿いたす。
+
+䟋を芋るず分かりやすくなりたす :)
+
+### 䟋 {#examples_1}
+```python
+from scrapling.fetchers import Fetcher
+page = Fetcher.get('https://quotes.toscrape.com/')
+```
+すべおの `div` 芁玠を探したす。
+```python
+>>> page.find_all('div')
+[<data='<div class="container"> <div class="row...' parent='<body> <div class="container"> <div clas...'>,
+ <data='<div class="row header-box"> <div class=...' parent='<div class="container"> <div class="row...'>,
+...]
+```
+クラスが `quote` ず等しいすべおの div 芁玠を探したす。
+```python
+>>> page.find_all('div', class_='quote')
+[<data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+ <data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+...]
+```
+同じ結果になる別の曞き方です。
+```python
+>>> page.find_all('div', {'class': 'quote'})
+[<data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+ <data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+...]
+```
+クラスが `quote` ず等しいすべおの芁玠を探したす。
+```python
+>>> page.find_all({'class': 'quote'})
+[<data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+ <data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+...]
+```
+クラスが `quote` で、その䞭に 'world' を含む `.text` 芁玠がある div を探したす。
+```python
+>>> page.find_all('div', {'class': 'quote'}, lambda e: "world" in e.css('.text::text').get())
+[<data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>]
+```
+子を持぀すべおの芁玠を探したす。
+```python
+>>> page.find_all(lambda element: len(element.children) > 0)
+[<data='<html lang="en"><head><meta charset="UTF...'>,
+ <data='<head><meta charset="UTF-8"><title>Quote...' parent='<html lang="en"><head><meta charset="UTF...'>,
+ <data='<body> <div class="container"> <div clas...' parent='<html lang="en"><head><meta charset="UTF...'>,
+...]
+```
+内容に 'world' を含むすべおの芁玠を探したす。
+```python
+>>> page.find_all(lambda element: "world" in element.text)
+[<data='<span class="text" itemprop="text">“The...' parent='<div class="quote" itemscope itemtype="h...'>,
+ <data='<a class="tag" href="/tag/world/page/1/"...' parent='<div class="tags"> Tags: <meta class="ke...'>]
+```
+指定した正芏衚珟に䞀臎するすべおの span 芁玠を探したす。
+```python
+>>> page.find_all('span', re.compile(r'world'))
+[<data='<span class="text" itemprop="text">“The...' parent='<div class="quote" itemscope itemtype="h...'>]
+```
+クラスが 'quote' の div ず span を探したす。ここでは該圓する span がないため、div だけが返りたす。
+```python
+>>> page.find_all(['div', 'span'], {'class': 'quote'})
+[<data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+ <data='<div class="quote" itemscope itemtype="h...' parent='<div class="col-md-8"> <div class="quote...'>,
+...]
+```
+耇数の条件を組み合わせたす。
+```python
+>>> page.find_all({'itemtype':"http://schema.org/CreativeWork"}, 'div').css('.author::text').getall()
+['Albert Einstein',
+ 'J.K. Rowling',
+...]
+```
+䟿利な䜿い方ずしお、`href` の倀が 'Einstein' で終わる芁玠も探せたす。
+```python
+>>> page.find_all({'href$': 'Einstein'})
+[<data='<a href="/author/Albert-Einstein">(about...' parent='<span>by <small class="author" itemprop=...'>,
+ <data='<a href="/author/Albert-Einstein">(about...' parent='<span>by <small class="author" itemprop=...'>,
+ <data='<a href="/author/Albert-Einstein">(about...' parent='<span>by <small class="author" itemprop=...'>]
+```
+`href` の倀に '/author/' を含む芁玠を探すこずもできたす。
+```python
+>>> page.find_all({'href*': '/author/'})
+[<data='<a href="/author/Albert-Einstein">(about...' parent='<span>by <small class="author" itemprop=...'>,
+ <data='<a href="/author/J-K-Rowling">(about)</a...' parent='<span>by <small class="author" itemprop=...'>,
+ <data='<a href="/author/Albert-Einstein">(about...' parent='<span>by <small class="author" itemprop=...'>,
+...]
+```
+このように条件を組み合わせられたす。
+
+## セレクタヌを生成する {#generating-selectors}
+任意の芁玠から CSS/XPath セレクタヌを生成し、ここでも別の堎所でも再利甚できたす。元の芁玠をどの方法で芋぀けたかは関係ありたせん。
+
+`url_element` に察しお、可胜なら短い CSS セレクタヌを生成したす。短くできなければ完党なセレクタヌを返したす。
+```python
+>>> url_element = page.find({'href*': '/author/'})
+>>> url_element.generate_css_selector
+'body > div > div:nth-of-type(2) > div > div > span:nth-of-type(2) > a'
+```
+`url_element` に察しお、ペヌゞの先頭からの完党な CSS セレクタヌを生成したす。
+```python
+>>> url_element.generate_full_css_selector
+'body > div > div:nth-of-type(2) > div > div > span:nth-of-type(2) > a'
+```
+`url_element` に察しお、可胜なら短い XPath セレクタヌを生成したす。短くできなければ完党なセレクタヌを返したす。
+```python
+>>> url_element.generate_xpath_selector
+'//body/div/div[2]/div/div/span[2]/a'
+```
+`url_element` に察しお、ペヌゞの先頭からの完党な XPath セレクタヌを生成したす。
+```python
+>>> url_element.generate_full_xpath_selector
+'//body/div/div[2]/div/div/span[2]/a'
+```
+!!! abstract "泚意"
+
+ 短いセレクタヌを生成するずきは、`id` 属性を持぀芁玠など、䞀意に分かる芁玠を出発点ずしお探したす。今回の䟋にはないため、短いセレクタヌず完党なセレクタヌが同じになりたす。
+
+## セレクタヌず正芏衚珟を組み合わせる {#using-selectors-with-regular-expressions}
+`parsel`/`scrapy` ず同じように、`re` ず `re_first` で正芏衚珟による抜出ができたす。ただし、Scrapling では `Selector`/`Selectors`/`TextHandler` ず `TextHandlers` など、ほがすべおのクラスで䜿えたす。テキストノヌドを遞ばなくおも、芁玠に盎接䜿えたす。
+
+[TextHandler](main_classes.md#texthandler) の説明で詳しく扱いたすが、基本的には次のように䜿いたす。
+```python
+>>> page.css('.price_color')[0].re_first(r'[\d\.]+')
+'51.77'
+
+>>> page.css('.price_color').re_first(r'[\d\.]+')
+'51.77'
+
+>>> page.css('.price_color').re(r'[\d\.]+')
+['51.77',
+ '53.74',
+ '50.10',
+ '47.82',
+ '54.23',
+...]
+
+>>> page.css('.product_pod h3 a::attr(href)').re(r'catalogue/(.*)/index.html')
+['a-light-in-the-attic_1000',
+ 'tipping-the-velvet_999',
+ 'soumission_998',
+ 'sharp-objects_997',
+...]
+
+>>> filtering_function = lambda e: e.parent.tag == 'h3' and e.parent.parent.has_class('product_pod') # As above selector
+>>> page.find('a', filtering_function).attrib['href'].re(r'catalogue/(.*)/index.html')
+['a-light-in-the-attic_1000']
+
+>>> page.find_by_text('Tipping the Velvet').attrib['href'].re(r'catalogue/(.*)/index.html')
+['tipping-the-velvet_999']
+```
+次のペヌゞで、[TextHandler](main_classes.md#texthandler) ず䞀緒にさらに詳しく説明したす。
\ No newline at end of file
diff --git a/docs/locales/ja/spiders/advanced.md b/docs/locales/ja/spiders/advanced.md
new file mode 100644
index 0000000..3c89013
--- /dev/null
+++ b/docs/locales/ja/spiders/advanced.md
@@ -0,0 +1,430 @@
+---
+title: "クロヌルの制埡AutoThrottle、チェックポむント、キャッシュ、ストリヌミング"
+description: "クロヌルの速床ず䞊行凊理を制埡したす。レスポンスのキャッシュ、䞀時停止ず再開、デヌタのストリヌミング、チェックポむントに保存する状態を孊びたす。"
+---
+
+# 高床な䜿い方 {#advanced-usages}
+
+## 抂芁 {#introduction}
+
+!!! success "前提知識"
+
+ 1. [はじめに](getting-started.md)を読み、簡単な Spider の䜜成ず実行ができるこず。
+
+このペヌゞでは、䞊行凊理の制埡、䞀時停止ず再開、ストリヌミング、ラむフサむクルフック、統蚈、ログを説明したす。
+
+## 䞊行凊理を制埡する {#concurrency-control}
+
+Spider は、次のクラス属性でクロヌルの負荷を調敎したす。
+
+| 属性 | デフォルト | 説明 |
+|------|------------|------|
+| `concurrent_requests` | `4` | 同時に凊理するリク゚ストの最倧数 |
+| `concurrent_requests_per_domain` | `0` | ドメむンごずの最倧䞊行リク゚スト数。0 はドメむン単䜍の制限なし |
+| `download_delay` | `0.0` | 各リク゚ストの前に埅぀秒数 |
+| `robots_txt_obey` | `False` | robots.txt の Disallow、Crawl-delay、Request-rate に埓う |
+
+```python
+class PoliteSpider(Spider):
+ name = "polite"
+ start_urls = ["https://example.com"]
+
+ # Be gentle with the server
+ concurrent_requests = 4
+ concurrent_requests_per_domain = 2
+ download_delay = 1.0 # Wait 1 second between requests
+
+ async def parse(self, response: Response):
+ yield {"title": response.css("title::text").get("")}
+```
+
+`concurrent_requests_per_domain` を蚭定するず、党䜓の䞊限に加え、各ドメむンにも䞊行数の䞊限を蚭けたす。耇数のドメむンを同時にクロヌルするずき、党䜓では倚くのリク゚ストを凊理し぀぀、個々のドメむンの負荷を抑えられたす。
+
+!!! tip
+
+ `download_delay` はドメむンに関係なく、すべおのリク゚ストの前に䞀定時間埅ちたす。簡単なレヌト制限ずしお䜿えたす。
+
+## AutoThrottle {#autothrottle}
+
+固定の `download_delay` は掚枬で決める倀です。短すぎるずブロックされ、長すぎるずクロヌルが䞀晩かかるかもしれたせん。AutoThrottle はサむトの実際の応答速床を枬り、ドメむンごずに埅機時間を調敎したす。速いサヌバヌでは速く、遅いサヌバヌやリク゚ストを拒吊するサヌバヌでは遅く動きたす。
+
+| 属性 | デフォルト | 説明 |
+|------|------------|------|
+| `autothrottle_enabled` | `False` | 埅機時間の自動調敎を有効化 |
+| `autothrottle_start_delay` | `5.0` | ドメむンぞの最初のリク゚ストに䜿う埅機時間 |
+| `autothrottle_max_delay` | `60.0` | 埅機時間の䞊限 |
+| `autothrottle_target_concurrency` | `None` | ドメむンごずの目暙䞊行リク゚スト数。䞋蚘を参照 |
+| `autothrottle_block_backoff` | `True` | ブロックされるたびに、そのドメむンの埅機時間を 2 倍にする |
+
+```python
+class AdaptiveSpider(Spider):
+ name = "adaptive"
+ start_urls = ["https://example.com"]
+
+ concurrent_requests = 8
+ concurrent_requests_per_domain = 1
+
+ autothrottle_enabled = True
+ autothrottle_start_delay = 2.0
+ autothrottle_max_delay = 30.0
+
+ async def parse(self, response: Response):
+ yield {"title": response.css("title::text").get("")}
+```
+
+各レスポンスのあず、埅機時間をサヌバヌの応答時間に近づけたす。たずえば 0.5 秒で応答するサむトなら、埅機時間も玄 0.5 秒に萜ち着きたす。これはおおむね、同時に 1 件のリク゚ストが進行しおいる状態です。ドメむンごずの目暙数は、蚭定枈みの `autothrottle_target_concurrency`、次に `concurrent_requests_per_domain`、どちらもなければ 1 の順で決たりたす。通垞は、すでに蚭定したドメむンごずの䞊限が目暙になり、埅機時間がその数で割られるため、別の目暙倀は䞍芁です。応答時間が急に長くなった堎合は、平均に混ぜずにすぐ反映したす。サヌバヌの負荷が増えたらすぐに枛速し、加速するずきは少しず぀行いたす。
+
+### ブロックされたずきに枛速する {#backing-off-when-blocked}
+
+応答時間だけではレヌト制限を怜出できたせん。`429`、`403`、CAPTCHA のペヌゞは、本来の内容より*速く*返るこずがあり、時間だけを芋れば加速すべきず刀断しおしたいたす。そのため、正垞でないレスポンスでは、そのドメむンの埅機時間を**2 倍**にしたす。2xx 以倖のステヌタスや、`is_blocked()` がブロックず刀定したレスポンスが察象です。
+
+```
+0.5s -> 1s -> 2s -> 4s -> 8s ... (up to autothrottle_max_delay)
+```
+
+サむトが拒吊を続ける限り、Spider は速床を萜ずしたす。正垞なレスポンスが戻るず、通垞の平均蚈算で埅機時間を埐々に䞋げ、サヌバヌの実際の速床に戻りたす。再起動は䞍芁です。
+
+サむトが `429` たたは `503` のレスポンスで `Retry-After` ヘッダヌを返す堎合は、2 倍にする代わりに、その埅機時間を䜿いたす。数倀圢匏`Retry-After: 120`ず HTTP 日付圢匏の䞡方に察応したす。
+
+`autothrottle_block_backoff = False` にするず、この動䜜を無効にしお応答時間だけで調敎したす。この堎合、ブロックは加速を止めるだけです。
+
+ドメむンごずの最終的な埅機時間は、統蚈で確認できたす。
+
+```python
+result = AdaptiveSpider().start()
+print(result.stats.autothrottle_delays) # {'example.com': 0.62}
+```
+
+!!! note "泚意点"
+
+ * `download_delay` ず robots.txt の埅機時間は䞋限ですが、その䞋限も `autothrottle_max_delay` によっお制限されたす。䞊限は、蚭定枈みの埅機時間や robots.txt の芁求を満たす倀にしおください。<br/>
+ * `concurrent_requests_per_domain` には 2 ぀の圹割がありたす。ドメむンごずの同時リク゚スト数を制限し、AutoThrottle の目暙倀にもなりたす。そのため、通垞は別の目暙蚭定が䞍芁です。この䞊限を蚭定するこずを掚奚したす。埅機䞭のリク゚ストも党䜓の䞊行数の枠を䜿うため、ドメむン単䜍で制限しないず、ほかのドメむンず共有する枠が埋たるこずがありたす。<br/>
+ * 枬る時間は取埗党䜓の時間です。内郚の再詊行や、ブラりザのセッションでペヌゞを描画する時間も含みたす。<br/>
+ * `autothrottle_max_delay` は `Retry-After` を含むすべおの埅機時間を制限したす。サむトが䞊限より長い埅機を芁求したら、`autothrottle_max_delay` を増やしお守っおください。<br/>
+ * 孊習した埅機時間はチェックポむントに保存したせん。䞀時停止埌に再開するず、各ドメむンは `autothrottle_start_delay` から始たりたす。
+
+## uvloop を䜿う {#using-uvloop}
+
+`start()` の `use_uvloop` パラメヌタヌを䜿うず、利甚可胜な堎合に、より高速な [uvloop](https://github.com/MagicStack/uvloop)/[winloop](https://github.com/nicktimko/winloop) のむベントルヌプを䜿えたす。
+
+```python
+result = MySpider().start(use_uvloop=True)
+```
+
+I/O が倚いクロヌルで凊理量を増やせる堎合がありたす。Linux/macOS では `uvloop`、Windows では `winloop` を別途むンストヌルしおください。
+
+## 䞀時停止ず再開 {#pause-resume}
+
+Spider はチェックポむントを䜿っお、安党に䞀時停止しお再開できたす。コンストラクタヌに `crawldir` ディレクトリを枡すず有効になりたす。
+
+```python
+spider = MySpider(crawldir="crawl_data/my_spider")
+result = spider.start()
+
+if result.paused:
+ print("Crawl was paused. Run again to resume.")
+else:
+ print("Crawl completed!")
+```
+
+### 仕組み {#how-it-works}
+
+1. **䞀時停止**クロヌル䞭に `Ctrl+C` を抌したす。実行䞭のリク゚ストが終わるたで埅ち、未凊理のリク゚ストず蚪問枈みリク゚ストのフィンガヌプリントをチェックポむントに保存しお終了したす。
+2. **匷制停止**もう䞀床 `Ctrl+C` を抌すず、実行䞭のタスクを埅たずに停止したす。
+3. **再開**同じ `crawldir` で再床実行したす。チェックポむントを怜出し、キュヌず蚪問枈みの集合を埩元しお、䞭断した䜍眮から続けたす。`start_requests()` は省略したす。
+4. **埌片付け**クロヌルが䞀時停止ではなく正垞に完了するず、チェックポむントのファむルを自動で削陀したす。
+
+**クロヌル䞭もチェックポむントを定期保存したす。デフォルトは 5 分ごずです。**
+
+保存間隔は次のように倉曎できたす。
+
+```python
+# Save checkpoint every 2 minutes
+spider = MySpider(crawldir="crawl_data/my_spider", interval=120.0)
+```
+
+ディスクぞの曞き蟌みはアトミックに行い、䞍完党なファむルが残るこずを防ぎたす。
+
+!!! tip
+
+ `start()` では、チェックポむントを有効にしおいなくおも、`Ctrl+C` を抌すず実行䞭の凊理を埅っお終了したす。埅たずにもう䞀床抌すず、すぐに匷制終了したす。
+
+### 再開䞭かどうかを知る {#knowing-if-youre-resuming}
+
+`on_start()` フックは `resuming` フラグを受け取りたす。
+
+```python
+async def on_start(self, resuming: bool = False):
+ if resuming:
+ self.logger.info("Resuming from checkpoint!")
+ else:
+ self.logger.info("Starting fresh crawl")
+```
+
+## 開発モヌド {#development-mode}
+
+Spider の `parse()` を調敎するずき、実行のたびに察象サヌバヌにアクセスするず遅くなり、䞍芁なリク゚ストも増えたす。開発モヌドは、初回のレスポンスをディスクに保存し、次回以降はそこから読みたす。ペヌゞを再取埗せずに、セレクタヌを倉えお䜕床でも実行できたす。
+
+Spider に `development_mode = True` を蚭定したす。
+
+```python
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+ development_mode = True
+
+ async def parse(self, response: Response):
+ yield {"title": response.css("title::text").get("")}
+```
+
+初回は通垞どおりペヌゞを取埗し、各レスポンスをディスクに保存したす。次回以降、同じリク゚ストにはキャッシュを䜿い、ペヌゞ取埗を省略したす。`robots_txt_obey=True` の堎合は、キャッシュの確認前に robots.txt をチェックしたす。
+
+### キャッシュの堎所 {#cache-location}
+
+デフォルトでは、珟圚の䜜業ディレクトリから芋た `.scrapling_cache/{spider.name}/` に保存したす。これは Spider を実行した堎所であり、スクリプトの眮き堎所**ではありたせん**。`development_cache_dir` で倉曎できたす。
+
+```python
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+ development_mode = True
+ development_cache_dir = "/tmp/my_spider_cache"
+```
+
+### 仕組み {#how-it-works_1}
+
+1. **キャッシュのキヌ**リク゚ストのフィンガヌプリントを䜿いたす。これに圱響する属性`fp_include_kwargs`、`fp_include_headers`、`fp_keep_fragments`を倉えるず、新しく取埗したす。
+2. **保存圢匏**レスポンスごずに `{fingerprint_hex}.json` ずいう JSON ファむルを䜜りたす。ボディは Base64 で゚ンコヌドしおバむナリ内容を正確に保ちたす。䞀時ファむルを䜜っお名前を倉曎する、アトミックな曞き蟌みです。
+3. **再利甚**キャッシュがあれば、ペヌゞ取埗に加えお `download_delay`、レヌト制限、`is_blocked()` の再詊行凊理を省略したす。保存枈みのレスポンスを盎接コヌルバックに枡したす。
+4. **統蚈**キャッシュを䜿うリク゚ストも、`requests_count`、`response_bytes`、ステヌタスごずの件数に含みたす。そのため、通垞のクロヌルず同じ圢で統蚈を確認できたす。远加の `cache_hits` ず `cache_misses` で、キャッシュの利甚状況もわかりたす。
+
+### キャッシュを消す {#clearing-the-cache}
+
+自動的な有効期限はありたせん。新しくクロヌルするには、キャッシュのディレクトリを削陀するか、マネヌゞャヌの `clear()` を盎接呌び出したす。
+
+!!! warning
+
+ 開発モヌドは開発甚であり、本番甚ではありたせん。キャッシュは期限切れにならず、再利甚時はレヌト制限ずブロックの再詊行を省略したす。`development_mode = True` のたた本番で䜿わないでください。
+
+## ストリヌミング {#streaming}
+
+長く動く Spider や、抜出したデヌタをすぐに䜿うアプリでは、`start()` の代わりに `stream()` を䜿いたす。
+
+```python
+import anyio
+
+async def main():
+ spider = MySpider()
+ async for item in spider.stream():
+ print(f"Got item: {item}")
+ # Access real-time stats
+ print(f"Items so far: {spider.stats.items_scraped}")
+ print(f"Requests made: {spider.stats.requests_count}")
+
+anyio.run(main)
+```
+
+`start()` ずの䞻な違いは次のずおりです。
+
+- `stream()` は非同期コンテキストから呌び出す必芁がありたす。
+- デヌタ項目をリストに集めず、抜出するたびに 1 件ず぀返したす。
+- 反埩凊理䞭に `spider.stats` で最新の統蚈を確認できたす。
+
+!!! abstract
+
+ `spider.stats` で確認できるすべおの統蚈は、[埌の節](#results-statistics)で説明したす。
+
+チェックポむントず組み合わせるこずもできたす。最新のデヌタを衚瀺し、䞀時停止ず再開ができる UI を Spider の䞊に䜜れたす。
+
+```python
+import anyio
+
+async def main():
+ spider = MySpider(crawldir="crawl_data/my_spider")
+ async for item in spider.stream():
+ print(f"Got item: {item}")
+ # Access real-time stats
+ print(f"Items so far: {spider.stats.items_scraped}")
+ print(f"Requests made: {spider.stats.requests_count}")
+
+anyio.run(main)
+```
+䞊のコヌドでは、`spider.pause()` で Spider を停止するこずもできたす。チェックポむントが無効なら、クロヌルを終了するだけです。
+
+## ラむフサむクルフック {#lifecycle-hooks}
+
+クロヌルの各段階に独自の凊理を加えるため、次のフックをオヌバヌラむドできたす。
+
+### on_start {#on_start}
+
+クロヌル開始前に呌び出したす。デヌタの読み蟌みやリ゜ヌスの初期化などに䜿いたす。
+
+```python
+async def on_start(self, resuming: bool = False):
+ self.logger.info("Spider starting up")
+ # Load seed URLs from a database, initialize counters, etc.
+```
+
+### on_close {#on_close}
+
+クロヌルが完了たたは䞀時停止したあずに呌び出したす。埌片付けに䜿いたす。
+
+```python
+async def on_close(self):
+ self.logger.info("Spider shutting down")
+ # Close database connections, flush buffers, etc.
+```
+
+### on_error {#on_error}
+
+リク゚ストが䟋倖で倱敗したずきに呌び出したす。゚ラヌの蚘録や独自の埩旧凊理に䜿いたす。
+
+```python
+async def on_error(self, request: Request, error: Exception):
+ self.logger.error(f"Failed: {request.url} - {error}")
+ # Log to error tracker, save failed URL for later, etc.
+```
+
+### on_scraped_item {#on_scraped_item}
+
+抜出した各項目を結果に远加する前に呌び出したす。項目をそのたた、たたは倉曎しお返すず保持したす。`None` を返すず砎棄したす。
+
+```python
+async def on_scraped_item(self, item: dict) -> dict | None:
+ # Drop items without a title
+ if not item.get("title"):
+ return None
+
+ # Modify items (e.g., add timestamps)
+ item["scraped_at"] = "2026-01-01"
+ return item
+```
+
+!!! tip
+
+ このフックで項目を独自のパむプラむンに枡し、Spider の結果から陀くこずもできたす。
+
+### start_requests {#start_requests}
+
+`start_requests()` をオヌバヌラむドするず、`start_urls` を䜿わずに最初のリク゚ストを自分で䜜れたす。
+
+```python
+async def start_requests(self):
+ # POST request to log in first
+ yield Request(
+ "https://example.com/login",
+ method="POST",
+ data={"user": "admin", "pass": "secret"},
+ callback=self.after_login,
+ )
+
+async def after_login(self, response: Response):
+ # Now crawl the authenticated pages
+ yield response.follow("/dashboard", callback=self.parse)
+```
+
+## 結果ず統蚈 {#results-statistics}
+
+`start()` が返す `CrawlResult` には、抜出したデヌタ項目ず詳しい統蚈が含たれたす。
+
+```python
+result = MySpider().start()
+
+# Items
+print(f"Total items: {len(result.items)}")
+result.items.to_json("output.json", indent=True)
+
+# Did the crawl complete?
+print(f"Completed: {result.completed}")
+print(f"Paused: {result.paused}")
+
+# Statistics
+stats = result.stats
+print(f"Requests: {stats.requests_count}")
+print(f"Failed: {stats.failed_requests_count}")
+print(f"Blocked: {stats.blocked_requests_count}")
+print(f"Offsite filtered: {stats.offsite_requests_count}")
+print(f"Robots.txt disallowed: {stats.robots_disallowed_count}")
+print(f"Cache hits: {stats.cache_hits}")
+print(f"Cache misses: {stats.cache_misses}")
+print(f"Items scraped: {stats.items_scraped}")
+print(f"Items dropped: {stats.items_dropped}")
+print(f"Response bytes: {stats.response_bytes}")
+print(f"Duration: {stats.elapsed_seconds:.1f}s")
+print(f"Speed: {stats.requests_per_second:.1f} req/s")
+```
+
+### 詳现な統蚈 {#detailed-stats}
+
+`CrawlStats` は、次のような詳しい情報を蚘録したす。
+
+```python
+stats = result.stats
+
+# Status code distribution
+print(stats.response_status_count)
+# {'status_200': 150, 'status_404': 3, 'status_403': 1}
+
+# Bytes downloaded per domain
+print(stats.domains_response_bytes)
+# {'example.com': 1234567, 'api.example.com': 45678}
+
+# Requests per session
+print(stats.sessions_requests_count)
+# {'http': 120, 'stealth': 34}
+
+# Proxies used during the crawl
+print(stats.proxies)
+# ['http://proxy1:8080', 'http://proxy2:8080']
+
+# Log level counts
+print(stats.log_levels_counter)
+# {'debug': 200, 'info': 50, 'warning': 3, 'error': 1, 'critical': 0}
+
+# Timing information
+print(stats.start_time) # Unix timestamp when crawl started
+print(stats.end_time) # Unix timestamp when crawl finished
+print(stats.download_delay) # The download delay used (seconds)
+
+# Concurrency settings used
+print(stats.concurrent_requests) # Global concurrency limit
+print(stats.concurrent_requests_per_domain) # Per-domain concurrency limit
+
+# AutoThrottle
+print(stats.autothrottle_enabled) # Whether the adaptive delay was on
+print(stats.autothrottle_delays) # Final delay per domain, {'example.com': 0.62}
+
+# Custom stats (set by your spider code)
+print(stats.custom_stats)
+# {'login_attempts': 3, 'pages_with_errors': 5}
+
+# Export everything as a dict
+print(stats.to_dict())
+```
+
+## ログ {#logging}
+
+Spider には、`self.logger` で䜿えるロガヌが組み蟌たれおいたす。Spider の名前が蚭定枈みで、次のオプションを倉曎できたす。
+
+| 属性 | デフォルト | 説明 |
+|------|------------|------|
+| `logging_level` | `logging.DEBUG` | 蚘録する最䜎ログレベル |
+| `logging_format` | `"[%(asctime)s]:({spider_name}) %(levelname)s: %(message)s"` | ログメッセヌゞの圢匏 |
+| `logging_date_format` | `"%Y-%m-%d %H:%M:%S"` | ログの日付圢匏 |
+| `log_file` | `None` | コン゜ヌルに加えお曞き蟌むログファむルのパス |
+
+```python
+import logging
+
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+ logging_level = logging.INFO
+ log_file = "logs/my_spider.log"
+
+ async def parse(self, response: Response):
+ self.logger.info(f"Processing {response.url}")
+ yield {"title": response.css("title::text").get("")}
+```
+
+ログファむルのディレクトリがなければ自動で䜜成したす。コン゜ヌルずファむルは同じ圢匏で出力したす。
diff --git a/docs/locales/ja/spiders/architecture.md b/docs/locales/ja/spiders/architecture.md
new file mode 100644
index 0000000..e8104d6
--- /dev/null
+++ b/docs/locales/ja/spiders/architecture.md
@@ -0,0 +1,107 @@
+---
+title: "Scrapling の Web クロヌラヌの仕組み"
+description: "Spider、リク゚スト、セッション、スケゞュヌラヌ、クロヌル゚ンゞンの連携を孊びたす。Scrapy の流れず比范し、䜿い始める方法を確認したす。"
+---
+
+# Spider のアヌキテクチャ {#spiders-architecture}
+
+!!! success "前提知識"
+
+ 1. [Fetcher の基本](../fetching/choosing.md)を読み、Fetcher の皮類ず䜿い分けを理解しおいるこず。
+ 2. [䞻芁なクラス](../parsing/main_classes.md)を読み、[Selector](../parsing/main_classes.md#selector) ず [Response](../fetching/choosing.md#response-object) を理解しおいるこず。
+
+Scrapling の Spider は、Scrapy を参考にした非同期クロヌルの仕組みです。䞊行リク゚スト、耇数のセッション、䞀時停止ず再開をサポヌトしたす。Scrapling の解析゚ンゞンず Fetcher を共通のクロヌル API にたずめ、スケゞュヌリング、䞊行凊理の制埡、チェックポむントを远加しおいたす。
+
+Scrapy を知っおいれば、すぐに䜿い方がわかりたす。初めおでも䜿いやすい構成です。
+
+## デヌタの流れ {#data-flow}
+
+次の図は、クロヌル䞭にデヌタがどのように流れるかを瀺しおいたす。
+
+<img src="../assets/spider_architecture.png" title="@TrueSkills による Spider の構成図" alt="@TrueSkills による Spider の構成図" style="width: 70%;"/>
+
+Spider を実行するず、倧たかには次の凊理が行われたす。
+
+1. **Spider** が最初の `Request` オブゞェクトを䜜りたす。デフォルトでは `start_urls` の各 URL に 1 ぀ず぀䜜りたす。独自の凊理が必芁なら、`start_requests()` をオヌバヌラむドできたす。
+2. **スケゞュヌラヌ**がリク゚ストを受け取り、優先床付きキュヌに入れお、フィンガヌプリントを䜜りたす。優先床が高いリク゚ストから取り出されたす。
+3. **クロヌル゚ンゞン**が**スケゞュヌラヌ**に次のリク゚ストを芁求したす。その際、党䜓ずドメむンごずの䞊行数の䞊限、およびダりンロヌドの埅機時間を守りたす。`robots_txt_obey` が有効な堎合は、先にドメむンの robots.txt を確認し、犁止されたリク゚ストを通知せずに砎棄したす。**クロヌル゚ンゞン**は受け取ったリク゚ストを**セッションマネヌゞャヌ**に枡したす。セッションマネヌゞャヌは `sid`セッション IDで適切なセッションを遞びたす。
+4. **セッション**がペヌゞを取埗し、[Response](../fetching/choosing.md#response-object) オブゞェクトを**クロヌル゚ンゞン**に返したす。゚ンゞンは統蚈を蚘録し、レスポンスがブロックされおいないか確認したす。ブロックされおいたら、最倧 `max_blocked_retries` 回リク゚ストを再詊行したす。ブロックの怜出方法ず再詊行の凊理は倉曎できたす。
+5. **クロヌル゚ンゞン**が [Response](../fetching/choosing.md#response-object) をリク゚ストのコヌルバックに枡したす。コヌルバックは、抜出したデヌタ項目ずしお扱われる蟞曞か、スケゞュヌラヌのキュヌに远加される次のリク゚ストを出力したす。
+6. キュヌが空になり、実行䞭のタスクもなくなるか、Spider が䞀時停止されるたで、手順 2 から繰り返したす。
+7. Spider の開始時に `crawldir` を指定するず、**クロヌル゚ンゞン**がチェックポむントを定期的にディスクぞ保存したす。内容は、未凊理のリク゚ストず蚪問枈み URL の集合です。Ctrl+C による通垞の終了時にも、最埌のチェックポむントを保存したす。次回同じ `crawldir` で実行するず、`start_requests()` を省略しおスケゞュヌラヌの状態を埩元し、䞭断した䜍眮から再開したす。
+
+
+## 構成芁玠 {#components}
+
+### Spider {#spider}
+
+䞻に操䜜するクラスです。`Spider` のサブクラスを䜜り、`start_urls` ず `parse()` を定矩したす。必芁に応じおセッションを蚭定し、ラむフサむクルフックをオヌバヌラむドしたす。
+
+```python
+from scrapling.spiders import Spider, Response, Request
+
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+
+ async def parse(self, response: Response):
+ for link in response.css("a::attr(href)").getall():
+ yield response.follow(link, callback=self.parse_page)
+
+ async def parse_page(self, response: Response):
+ yield {"title": response.css("h1::text").get("")}
+```
+
+### クロヌル゚ンゞン {#crawler-engine}
+
+゚ンゞンはクロヌル党䜓を管理したす。メむンルヌプを動かし、䞊行数を制限し、セッションマネヌゞャヌを通しおリク゚ストを送信し、コヌルバックの結果を凊理したす。盎接操䜜する必芁はありたせん。`Spider.start()` ず `Spider.stream()` が管理したす。
+
+### スケゞュヌラヌ {#scheduler}
+
+URL の重耇排陀を組み蟌んだ優先床付きキュヌです。リク゚ストのフィンガヌプリントは、URL、HTTP メ゜ッド、ボディ、セッション ID から䜜りたす。チェックポむント甚に `snapshot()` ず `restore()` を提䟛し、クロヌルの状態を保存しお再開できたす。
+
+### セッションマネヌゞャヌ {#session-manager}
+
+名前付きのセッションを 1 ぀以䞊管理したす。各セッションには次のいずれかを䜿いたす。
+
+- [FetcherSession](../fetching/static.md)
+- [AsyncStealthySession](../fetching/stealthy.md)
+
+リク゚ストを受け取るず、`sid` フィヌルドに応じお適切なセッションに枡したす。セッションはデフォルトで Spider ず同時に開始したすが、初めお䜿う時たで開始を遅らせるこずもできたす。
+
+### チェックポむント {#checkpoint-system}
+
+有効にするず、クロヌラヌの状態を pickle ファむルずしおディスクに保存するオプション機胜です。状態には、未凊理のリク゚ストず蚪問枈み URL のフィンガヌプリントが含たれたす。䞀時ファむルを曞いおから名前を倉曎するアトミックな曞き蟌みを䜿い、ファむルの砎損を防ぎたす。保存は蚭定した間隔ず通垞の終了時に行いたす。クロヌルが䞀時停止ではなく正垞に完了するず、チェックポむントのファむルは自動で削陀したす。
+
+### レスポンスキャッシュ {#response-cache}
+
+開発モヌドで䜿えるオプションのキャッシュです。取埗したすべおのレスポンスをディスクに保存し、次回以降の実行で再利甚したす。リク゚ストのフィンガヌプリントをキヌにしお JSON で保存し、ボディは Base64 で゚ンコヌドしおバむナリデヌタも保ちたす。察象サヌバヌぞ再アクセスせずに `parse()` を調敎するための機胜で、本番甚ではありたせん。
+
+### 出力 {#output}
+
+抜出したデヌタ項目は `ItemList` に集めたす。これは list のサブクラスで、`to_json()`、`to_jsonl()`、`to_csv()`、`to_xml()` の゚クスポヌトメ゜ッドがありたす。クロヌルの統蚈は、倚くの情報を持぀デヌタクラス `CrawlStats` に蚘録したす。
+
+
+## Scrapy ずの比范 {#comparison-with-scrapy}
+
+Scrapy から移行する堎合は、次の察応衚が参考になりたす。
+
+| 抂念 | Scrapy | Scrapling |
+|------|--------|-----------|
+| Spider の定矩 | `scrapy.Spider` のサブクラス | `scrapling.spiders.Spider` のサブクラス |
+| 最初のリク゚スト | `start_requests()` | `async start_requests()` |
+| コヌルバック | `def parse(self, response)` | `async def parse(self, response)` |
+| リンクをたどる | `response.follow(url)` | `response.follow(url)` |
+| デヌタ項目の出力 | `yield dict` たたは `yield Item` | `yield dict` |
+| リク゚ストの予定管理 | スケゞュヌラヌ + Dupefilter | 重耇排陀を組み蟌んだスケゞュヌラヌ |
+| ダりンロヌド | Downloader + Middleware | 耇数のセッションを扱うセッションマネヌゞャヌ |
+| デヌタ項目の凊理 | Item Pipelines | `on_scraped_item()` フック |
+| ブロックの怜出 | 独自の Middleware | 組み蟌みの `is_blocked()` + `retry_blocked_request()` フック |
+| 䞊行凊理 | `CONCURRENT_REQUESTS` 蚭定 | `concurrent_requests` クラス属性 |
+| ドメむンの制限 | `allowed_domains` | `allowed_domains` |
+| robots.txt | `ROBOTSTXT_OBEY` 蚭定 | `robots_txt_obey` クラス属性 |
+| 䞀時停止ず再開 | `JOBDIR` 蚭定 | コンストラクタヌ匕数 `crawldir` |
+| ゚クスポヌト | Feed exports | `result.items.to_json()` / `to_jsonl()` / `to_csv()` / `to_xml()`、たたはフックで独自に実装 |
+| 実行 | `scrapy crawl spider_name` | `MySpider().start()` |
+| ストリヌミング | 非察応 | `async for item in spider.stream()` |
+| 耇数のセッション | 非察応 | 1 ぀の Spider で異なる皮類のセッションを䜿甚 |
diff --git a/docs/locales/ja/spiders/generic-templates.md b/docs/locales/ja/spiders/generic-templates.md
new file mode 100644
index 0000000..48d353c
--- /dev/null
+++ b/docs/locales/ja/spiders/generic-templates.md
@@ -0,0 +1,278 @@
+---
+title: "リンク、サむトマップ、フィヌド、Markdown 甚の Spider テンプレヌト"
+description: "CrawlSpider、SitemapSpider、XMLFeedSpider、CSVFeedSpider、ContentSpider から遞びたす。ルヌルを蚭定しおペヌゞ、フィヌドの行、Markdown 文曞を集めたす。"
+---
+
+# 汎甚 Spider テンプレヌト {#generic-spider-templates}
+
+倚くのクロヌルは、「指定パタヌンに合うリンクをたどる」か「サむトマップに茉っおいる URL をすべお取埗する」のどちらかです。Scrapling には䞡方のテンプレヌトがあり、同じ `parse()` の基本コヌドを毎回曞く必芁はありたせん。
+
+`CrawlSpider` ず `SitemapSpider` は `LinkExtractor` を䜿いたす。これは `Response` から URL を取り出したり、`matches()` で 1 ぀の URL を刀定したりしたす。`SitemapSpider` はさらに、sitemap.xml や sitemap_index.xml の内容を内郚で解析したす。gzip 圧瞮にも察応しおいたす。
+
+通垞の `Spider.parse()` 内で `LinkExtractor` を盎接䜿うこずもできたす。テンプレヌトは、これらの郚品を組み合わせる手間を省きたす。
+
+## CrawlSpider {#crawlspider}
+
+`CrawlSpider` は、定矩したルヌルに埓っおリンクを自動でたどりたす。
+
+```python
+from scrapling.spiders import CrawlSpider, CrawlRule, LinkExtractor
+
+class QuotesSpider(CrawlSpider):
+ name = "blog"
+ start_urls = ["https://quotes.toscrape.com/"]
+
+ def rules(self):
+ return [
+ CrawlRule(LinkExtractor(allow=r"/author/"), callback=self.parse_author),
+ CrawlRule(LinkExtractor(allow=r"/page/\d+/")), # follow pagination, no callback
+ ]
+
+ async def parse_author(self, response):
+ yield {
+ '.author-title': response.css('.author-title::text').get(),
+ "birthday": response.css('.author-born-date::text').get(),
+ "url": response.url,
+ }
+
+result = QuotesSpider().start()
+```
+
+`CrawlRule` は `LinkExtractor` ず、必芁に応じお指定する `callback` を組み合わせたす。コヌルバックは Spider のバむンド枈みメ゜ッドです。生成する `Request` の `priority` や、各 `Request` を返す前に倉曎するバむンド枈みメ゜ッド `process_request` も指定できたす。デフォルトの `parse()` は、各レスポンスにすべおのルヌルを適甚し、䞀臎した URL ごずに `Request` を返したす。
+
+コヌルバックを指定しないルヌルでは、䞀臎した URL を Spider のデフォルトの `parse()` に枡したす。これはペヌゞ送りに䟿利です。次のペヌゞのリンクを取り出すだけでクロヌルを続けられ、専甚の凊理メ゜ッドは䞍芁です。
+
+### クロヌルの順序 {#crawl-order}
+
+`CrawlSpider` たたは `ContentSpider` などのサブクラスで `crawl_strategy` を蚭定するず、次に凊理するリク゚ストの遞び方を指定できたす。
+
+| `crawl_strategy` | `Request.priority` が同じ堎合の順序 |
+|------------------|------------------------------------|
+| `"bfs"`デフォルト | 最も早くキュヌに入ったリク゚ストから凊理 |
+| `"dfs"` | 最も遅くキュヌに入ったリク゚ストから凊理 |
+
+スケゞュヌラヌは、垞に `Request.priority` が高いリク゚ストから取り出したす。戊略が決めるのは、優先床が同じリク゚スト同士の順序だけです。
+
+`concurrent_requests = 1` にするず、遞んだキュヌの順序で 1 件ず぀凊理したす。重耇 URL は匕き続き陀倖され、同じ URL を再床芋぀けおもキュヌ内の䜍眮は倉わりたせん。䞊行凊理ではペヌゞの完了順が倉わるこずがあり、異なる階局や枝の凊理が重なるこずもありたす。
+
+チェックポむントから再開するずきは、同じ `crawl_strategy` を䜿っおください。
+
+### ルヌルず独自の凊理を組み合わせる {#combining-rules-with-custom-logic}
+
+`parse()` をオヌバヌラむドしお `super().parse(response)` を呌び出すず、ルヌルの凊理ず独自の出力を䞡方䜿えたす。
+
+```python
+class MySpider(CrawlSpider):
+ def rules(self):
+ return [CrawlRule(LinkExtractor(allow=r"/posts/"), callback=self.parse_post)]
+
+ async def parse(self, response):
+ yield {"page_url": response.url}
+ async for req in super().parse(response):
+ yield req
+```
+
+### `process_request` でリク゚ストを倉曎する {#mutating-requests-with-process_request}
+
+```python
+def add_priority(self, request, response):
+ request.priority = 10
+ return request
+
+def rules(self):
+ return [CrawlRule(
+ LinkExtractor(allow=r"/posts/"),
+ callback=self.parse_post,
+ process_request=self.add_priority,
+ )]
+```
+
+## SitemapSpider {#sitemapspider}
+
+`SitemapSpider` は sitemap.xml の URL からクロヌルを開始したす。`CrawlSpider` ず同じ `rules()` API を䜿うため、考え方も共通です。
+
+```python
+from scrapling.spiders import SitemapSpider, CrawlRule, LinkExtractor
+
+class MySitemap(SitemapSpider):
+ name = "sm"
+ sitemap_urls = ["https://example.com/sitemap.xml"]
+
+ def rules(self):
+ return [
+ CrawlRule(LinkExtractor(allow=r"/posts/"), callback=self.parse_post),
+ CrawlRule(LinkExtractor(allow=r"/products/"), callback=self.parse_product),
+ ]
+
+ async def parse_post(self, response):
+ yield {"title": response.css("h1::text").get()}
+
+ async def parse_product(self, response):
+ yield {"sku": response.css(".sku::text").get()}
+
+result = MySitemap().start()
+```
+
+### URL の振り分け {#how-urls-are-dispatched}
+
+`SitemapSpider` はサむトマップ内の各 URL に぀いお、ルヌルごずの `LinkExtractor.matches(url)` を順に確認したす。最初に䞀臎したルヌルを䜿い、そのコヌルバックを持぀ `Request` を返したす。どのルヌルにも䞀臎せず、`rules()` が空でなければ URL を砎棄したす。`rules()` が空のリストを返した堎合は、すべおの URL を Spider の `parse()` に枡したす。このメ゜ッドをオヌバヌラむドしおいなければ、デフォルトで `NotImplementedError` が発生したす。
+
+### サむトマップのむンデックス {#sitemap-indexes}
+
+`SitemapSpider` は `<sitemapindex>`、぀たり耇数のサむトマップをたずめた玢匕を芋぀けるず、子のサむトマップを自動でたどりたす。察象を絞るには、`sitemap_follow` に `LinkExtractor` を蚭定したす。
+
+```python
+class MySitemap(SitemapSpider):
+ name = "sm"
+ sitemap_urls = ["https://example.com/sitemap.xml"]
+ sitemap_follow = LinkExtractor(allow=r"/posts-sitemap-\d+\.xml") # only post sitemaps
+```
+
+### robots.txt ぞの察応 {#robotstxt-support}
+
+`robots.txt` の URL を `sitemap_urls` に盎接入れるず、`SitemapSpider` が認識し、そこに曞かれたすべおのサむトマップを取り出しおたどりたす。
+
+```python
+class MySitemap(SitemapSpider):
+ name = "sm"
+ sitemap_urls = ["https://example.com/robots.txt"]
+```
+
+### 別蚀語の URL {#alternate-language-urls}
+
+`sitemap_alternate_links = True` にするず、`<xhtml:link rel="alternate" hreflang="...">` の URL もルヌルに埓っお凊理したす。
+
+## XMLFeedSpider {#xmlfeedspider}
+
+`XMLFeedSpider` は XML フィヌドのノヌドを順に凊理したす。RSS、Atom、商品フィヌドなどが察象です。`itertag` に必芁なノヌド名を指定し、`parse_node()` をオヌバヌラむドしたす。ノヌド名のデフォルトは `"item"` です。䞀臎するノヌドごずにこのメ゜ッドを呌び出したす。
+
+```python
+from scrapling.spiders import XMLFeedSpider
+
+class RSSSpider(XMLFeedSpider):
+ name = "rss"
+ start_urls = ["https://example.com/feed.xml"]
+ itertag = "item"
+
+ async def parse_node(self, response, node):
+ yield {
+ "title": node.findtext("title"),
+ "link": node.findtext("link"),
+ "date": node.findtext("pubDate"),
+ }
+
+result = RSSSpider().start()
+```
+
+ほかのコヌルバックず同じく、`parse_node()` は `Request` オブゞェクトも返せたす。たずえば、`response.follow(node.findtext("link"), callback=self.parse_post)` でフィヌドがリンクするペヌゞをクロヌルできたす。
+
+### ノヌドの遞択ず解析 {#how-nodes-are-matched-and-parsed}
+
+`parse_node()` に枡すノヌドは、すべおの名前空間を取り陀いた `lxml` 芁玠です。そのため、`node.findtext("title")`、`node.find("thumbnail").get("url")`、倧文字ず小文字を区別する `node.xpath(...)` を、名前空間の察応衚なしで䜿えたす。`"entry"` のような単玔な `itertag` は、名前空間に関係なくノヌド名で䞀臎したす。Atom や、名前空間を持぀倚くのフィヌドに適した動䜜です。特定の名前空間のノヌドに絞るには、接頭蟞付きの `itertag` を䜿い、`namespaces` で接頭蟞を定矩したす。
+
+```python
+class ThumbnailSpider(XMLFeedSpider):
+ name = "thumbs"
+ start_urls = ["https://example.com/feed.xml"]
+ itertag = "media:thumbnail"
+ namespaces = (("media", "http://search.yahoo.com/mrss/"),)
+
+ async def parse_node(self, response, node):
+ yield {"thumbnail": node.get("url")}
+```
+
+gzip 圧瞮されたフィヌドは自動で展開したす。`.xml.gz` や gzip のコンテンツタむプで配信されたフィヌドが察象で、サむトマップ甚の Spider ず同じ保護機胜を䜿いたす。䞍正な XML があっおもクロヌルは䞭断せず、譊告を蚘録したす。
+
+## CSVFeedSpider {#csvfeedspider}
+
+`CSVFeedSpider` は CSV フィヌドの各行を凊理したす。`parse_row()` をオヌバヌラむドしおください。列名をキヌにした蟞曞ずしお各行を受け取りたす。
+
+```python
+from scrapling.spiders import CSVFeedSpider
+
+class PriceSpider(CSVFeedSpider):
+ name = "prices"
+ start_urls = ["https://example.com/products.csv"]
+
+ async def parse_row(self, response, row):
+ yield {"product": row["title"], "price": float(row["price"])}
+
+result = PriceSpider().start()
+```
+
+デフォルトでは最初の行をヘッダヌに䜿いたす。ヘッダヌ行がなければ、`headers` に列名を指定したす。通垞のカンマ区切りでないフィヌドでは、`delimiter`/`quotechar` を蚭定できたす。
+
+```python
+class PriceSpider(CSVFeedSpider):
+ name = "prices"
+ start_urls = ["https://example.com/products.csv"]
+ headers = ["title", "price", "url"]
+ delimiter = ";"
+```
+
+こちらも **XMLFeedSpider** ず同じく、gzip 圧瞮されたフィヌドを自動で展開したす。
+
+<a id="sitetomarkdownspider"></a>
+
+## ContentSpider {#contentspider}
+
+`ContentSpider` は **CrawlSpider** を基にしお、Web サむトの各ペヌゞを LLM 向けの読みやすい Markdown に倉換したす。ペヌゞごずに 1 項目を返し、必芁ならペヌゞごずに Markdown ファむルも保存したす。
+
+```python
+from scrapling.spiders import ContentSpider
+
+class DocsSpider(ContentSpider):
+ name = "docs"
+ start_urls = ["https://example.com/docs/"]
+ allowed_domains = {"example.com"}
+ output_dir = "docs_markdown"
+
+result = DocsSpider().start()
+```
+
+察象サむト内にクロヌルを制限するため、`allowed_domains` が必須です。すべおのオプションや、RAG パむプラむンに出力を枡す方法は、[RAG システムの構築](../ai/building-rag-systems.md)を参照しおください。
+
+## `LinkExtractor` を盎接䜿う {#using-linkextractor-directly}
+
+テンプレヌトを䜿わず、通垞の `Spider` で `LinkExtractor` を䜿うこずもできたす。
+
+```python
+from scrapling.spiders import Spider, LinkExtractor
+
+class CustomSpider(Spider):
+ name = "custom"
+ start_urls = ["https://example.com"]
+
+ def __init__(self):
+ super().__init__()
+ self._links = LinkExtractor(allow=r"/posts/", deny_domains="ads.example.com")
+
+ async def parse(self, response):
+ for url in self._links.extract(response):
+ yield response.follow(url, callback=self.parse_post)
+
+ async def parse_post(self, response):
+ yield {"title": response.css("h1::text").get()}
+```
+
+## LinkExtractor のリファレンス {#linkextractor-reference}
+
+| 匕数 | デフォルト | 説明 |
+|------|------------|------|
+| `allow` | `()` | 残す URL のパタヌン。空ならすべおに䞀臎したす。文字列、コンパむル枈みの `Pattern`、たたはそれらを含む反埩可胜なオブゞェクト |
+| `deny` | `()` | 陀倖する URL のパタヌン。垞に `allow` より優先 |
+| `allow_domains` | `()` | 蚱可するホスト名。サブドメむンも䞀臎したす`example.com` は `api.example.com` にも䞀臎 |
+| `deny_domains` | `()` | 陀倖するホスト名 |
+| `restrict_css` | `()` | DOM からの抜出範囲を絞る CSS セレクタヌ |
+| `restrict_xpath` | `()` | DOM からの抜出範囲を絞る XPath セレクタヌ |
+| `tags` | `("a", "area")` | リンクを探す芁玠のタグ |
+| `attrs` | `("href",)` | URL を読み取る属性 |
+| `canonicalize` | `True` | ク゚リパラメヌタヌを䞊べ替え、パスを正芏化 |
+| `strip` | `True` | 抜出した URL の前埌の空癜を陀去 |
+| `keep_fragment` | `False` | 正芏化するずきに `#fragment` を保持 |
+| `deny_extensions` | `IGNORED_EXTENSIONS` | 陀倖するファむル拡匵子。PDF、ZIP、画像、動画など |
+| `process` | `None` | フィルタヌ凊理の前に、各 URL に適甚する任意の関数。停ず刀定される倀を返すず URL を陀倖 |
+
+`LinkExtractor.extract(response)` は、フィルタヌず重耇排陀を適甚した絶察 URL の `list[str]` を返したす。
+
+`LinkExtractor.matches(url)` は `bool` を返したす。URL だけを䜿い、蚱可・陀倖パタヌン、ドメむン、拡匵子で刀定したす。`SitemapSpider` は、`Response` がない URL の振り分けに䜿いたす。
diff --git a/docs/locales/ja/spiders/getting-started.md b/docs/locales/ja/spiders/getting-started.md
new file mode 100644
index 0000000..f275a28
--- /dev/null
+++ b/docs/locales/ja/spiders/getting-started.md
@@ -0,0 +1,199 @@
+---
+title: "Scrapling で初めおの Python Web クロヌラヌを䜜る"
+description: "デヌタを抜出し、ペヌゞ送りのリンクをたどり、結果を出力する Spider を䜜りたす。開始 URL、コヌルバック、ドメむン制限、robots.txt の蚭定を孊びたす。"
+---
+
+# はじめに {#getting-started}
+
+## 抂芁 {#introduction}
+
+!!! success "前提知識"
+
+ 1. [Fetcher の基本](../fetching/choosing.md)を読み、Fetcher の皮類ず䜿い分けを理解しおいるこず。
+ 2. [䞻芁なクラス](../parsing/main_classes.md)を読み、[Selector](../parsing/main_classes.md#selector) ず [Response](../fetching/choosing.md#response-object) を理解しおいるこず。
+ 3. [アヌキテクチャ](architecture.md)を読み、Spider の仕組みを倧たかに理解しおいるこず。
+
+Spider の仕組みを䜿うず、耇数のペヌゞを䞊行しお取埗するクロヌラヌを数行のコヌドで䜜れたす。Scrapy を䜿ったこずがあれば、なじみのある曞き方です。初めおの堎合も、このガむドで必芁なこずを順に説明したす。
+
+## 初めおの Spider {#your-first-spider}
+
+Spider は、Web サむトをクロヌルしおデヌタを抜出する方法を定矩するクラスです。最も簡単な䟋を芋おみたしょう。
+
+```python
+from scrapling.spiders import Spider, Response
+
+class QuotesSpider(Spider):
+ name = "quotes"
+ start_urls = ["https://quotes.toscrape.com"]
+
+ async def parse(self, response: Response):
+ for quote in response.css("div.quote"):
+ yield {
+ "text": quote.css("span.text::text").get(""),
+ "author": quote.css("small.author::text").get(""),
+ }
+```
+
+すべおの Spider に、次の 3 ぀が必芁です。
+
+1. **`name`**Spider を識別する䞀意の名前です。
+2. **`start_urls`**クロヌルを開始する URL のリストです。
+3. **`parse()`**各レスポンスを凊理しお結果を返す、非同期ゞェネレヌタヌメ゜ッドです。
+
+凊理の䞭心ずなるのは `parse()` メ゜ッドです。Scrapling の [Selector](../parsing/main_classes.md#selector)/[Response](../fetching/choosing.md#response-object) ず同じ遞択メ゜ッドを䜿い、抜出したデヌタを蟞曞ずしお `yield` で出力したす。
+
+## Spider を実行する {#running-the-spider}
+
+むンスタンスを䜜成し、`start()` を呌び出したす。
+
+```python
+result = QuotesSpider().start()
+```
+
+`start()` が非同期凊理を内郚で管理するので、むベントルヌプを自分で扱う必芁はありたせん。実行䞭の凊理はタヌミナルに蚘録され、クロヌルの終了時には詳しい統蚈が衚瀺されたす。
+
+統蚈は、戻り倀の `CrawlResult` オブゞェクトにも含たれおいたす。
+
+```python
+result = QuotesSpider().start()
+
+# Access scraped items
+for item in result.items:
+ print(item["text"], "-", item["author"])
+
+# Check statistics
+print(f"Scraped {result.stats.items_scraped} items")
+print(f"Made {result.stats.requests_count} requests")
+print(f"Took {result.stats.elapsed_seconds:.1f} seconds")
+
+# Did the crawl finish or was it paused?
+print(f"Completed: {result.completed}")
+```
+
+## リンクをたどる {#following-links}
+
+倚くのクロヌルでは、リンクをたどっお耇数のペヌゞを取埗したす。`response.follow()` で次のリク゚ストを䜜成できたす。
+
+```python
+from scrapling.spiders import Spider, Response
+
+class QuotesSpider(Spider):
+ name = "quotes"
+ start_urls = ["https://quotes.toscrape.com"]
+
+ async def parse(self, response: Response):
+ # Extract items from the current page
+ for quote in response.css("div.quote"):
+ yield {
+ "text": quote.css("span.text::text").get(""),
+ "author": quote.css("small.author::text").get(""),
+ }
+
+ # Follow the "next page" link
+ next_page = response.css("li.next a::attr(href)").get()
+ if next_page:
+ yield response.follow(next_page, callback=self.parse)
+```
+
+`response.follow()` は盞察 URL を珟圚のペヌゞの URL ず自動で結合したす。たた、デフォルトでは珟圚のペヌゞの URL を `Referer` ヘッダヌに蚭定したす。
+
+ペヌゞの皮類に応じお、次のリク゚ストに異なるコヌルバックメ゜ッドを指定できたす。
+
+```python
+async def parse(self, response: Response):
+ for link in response.css("a.product-link::attr(href)").getall():
+ yield response.follow(link, callback=self.parse_product)
+
+async def parse_product(self, response: Response):
+ yield {
+ "name": response.css("h1::text").get(""),
+ "price": response.css(".price::text").get(""),
+ }
+```
+
+!!! note
+
+ すべおのコヌルバックメ゜ッドは、`async def` ず `yield` を䜿う非同期ゞェネレヌタヌである必芁がありたす。
+
+## デヌタを゚クスポヌトする {#exporting-data}
+
+`result.items` が返す `ItemList` には、゚クスポヌト甚のメ゜ッドがありたす。
+
+```python
+result = QuotesSpider().start()
+
+# Export as JSON
+result.items.to_json("quotes.json")
+
+# Export as JSON with pretty-printing
+result.items.to_json("quotes.json", indent=True)
+
+# Export as JSON Lines (one JSON object per line)
+result.items.to_jsonl("quotes.jsonl")
+
+# Export as CSV or XML
+result.items.to_csv("quotes.csv")
+result.items.to_xml("quotes.xml")
+```
+
+いずれのメ゜ッドも、芪ディレクトリがなければ自動で䜜成したす。
+
+`to_csv()` は、すべおのデヌタ項目に珟れるキヌごずに列を䜜りたす。項目ごずにキヌが異なっおいおも出力でき、倀がないセルは空欄になりたす。`fields=[...]` を枡すず列ず順序を指定でき、`delimiter="\t"` を枡すず TSV ファむルにできたす。`to_xml()` は各項目を `<item>` 芁玠に入れ、`<items>` をルヌト芁玠にしたす。これらの名前は `root_tag` ず `item_tag` で倉曎できたす。
+
+どちらの圢匏でも、入れ子の蟞曞やリストなど、単玔なスカラヌ倀でない倀は JSON ずしお曞き蟌みたす。デヌタが知らないうちに倱われるこずを防ぎたす。
+
+## ドメむンを制限する {#filtering-domains}
+
+`allowed_domains` で、Spider がアクセスするドメむンを制限できたす。倖郚サむトぞのリンクを誀っおたどるこずを防ぎたす。
+
+```python
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+ allowed_domains = {"example.com"}
+
+ async def parse(self, response: Response):
+ for link in response.css("a::attr(href)").getall():
+ # Links to other domains are silently dropped
+ yield response.follow(link, callback=self.parse)
+```
+
+サブドメむンは自動で䞀臎したす。たずえば `allowed_domains = {"example.com"}` ずするず、`sub.example.com` や `blog.example.com` なども蚱可されたす。
+
+陀倖されたリク゚ストは `stats.offsite_requests_count` に蚘録されるので、その件数を確認できたす。
+
+## robots.txt に埓う {#robotstxt-compliance}
+
+`robots_txt_obey = True` にするず、Spider は各ドメむンをクロヌルする前に robots.txt のルヌルを確認したす。
+
+```python
+class PoliteSpider(Spider):
+ name = "polite"
+ start_urls = ["https://example.com"]
+ robots_txt_obey = True
+
+ async def parse(self, response: Response):
+ for link in response.css("a::attr(href)").getall():
+ yield response.follow(link, callback=self.parse)
+```
+
+有効にするず、次の凊理を行いたす。
+
+1. **robots.txt を先に取埗したす。** クロヌル開始前に、`start_urls` のすべおのドメむンから䞊行しお取埗したす。
+2. **すべおのリク゚ストを確認したす。** ドメむンの robots.txt にある `Disallow` ルヌルに照らしお確認したす。犁止されたリク゚ストは通知せずに砎棄し、`stats.robots_disallowed_count` に蚘録したす。
+3. **`Crawl-delay` ず `Request-rate` に埓いたす。** 指瀺された埅機時間ず蚭定枈みの `download_delay` のうち、倧きい倀を䜿いたす。robots.txt によっお埅機時間が短くなるこずはなく、必芁な堎合だけ長くなりたす。AutoThrottle が有効な堎合は、その最倧埅機時間も䞊限になりたす。必芁な埅機時間を守れるよう、`autothrottle_max_delay` を十分に倧きくしおください。
+
+robots.txt は Spider のデフォルトセッションで取埗し、クロヌル党䜓を通しおドメむンごずにキャッシュしたす。クロヌル䞭に芋぀かった、`start_urls` にないドメむンでは、そのドメむンぞの最初のリク゚スト時に取埗したす。
+
+**泚意**予期しない動䜜を避けるため、`robots_txt_obey` はデフォルトで無効です。有効にしおも䞊行凊理の蚭定`concurrent_requests`、`concurrent_requests_per_domain`は倉わりたせん。調敎されるのは、リク゚スト間の埅機時間だけです。
+
+`download_delay` を手動で決めたくない堎合は、`autothrottle_enabled = True` にしおください。Spider が各ドメむンの応答速床に応じお埅機時間を調敎し、ブロックされた堎合は速床を萜ずしたす。[AutoThrottle](advanced.md#autothrottle) を参照しおください。
+
+## 次のステップ {#whats-next}
+
+基本がわかったら、次のペヌゞに進めたす。
+
+- [リク゚ストずレスポンス](requests-responses.md)優先順䜍、重耇排陀、メタデヌタなどを説明したす。
+- [セッション](sessions.md)1 ぀の Spider で HTTP、ブラりザ、ステルスブラりザなどの Fetcher を䜿いたす。
+- [プロキシ管理ずブロックぞの察応](proxy-blocking.md)リク゚ストごずにプロキシを切り替え、ブロックに察応したす。
+- [高床な機胜](advanced.md)䞊行凊理の制埡、AutoThrottle、䞀時停止ず再開、ストリヌミング、ラむフサむクルフック、ログを説明したす。
diff --git a/docs/locales/ja/spiders/platform-templates.md b/docs/locales/ja/spiders/platform-templates.md
new file mode 100644
index 0000000..7481ca8
--- /dev/null
+++ b/docs/locales/ja/spiders/platform-templates.md
@@ -0,0 +1,59 @@
+---
+title: "Python で Shopify の商品デヌタを取埗する"
+description: "ShopifySpider で Shopify ストアの商品䞀芧を取埗したす。ストアの URL を蚭定し、商品バリ゚ヌションを集め、各デヌタ項目のフィヌルドを確認したす。"
+---
+
+# プラットフォヌム甚の Spider テンプレヌト {#platform-spider-templates}
+
+汎甚テンプレヌトは、リンクをたどる、サむトマップを巡回するずいったクロヌルの*パタヌン*を扱いたす。プラットフォヌム甚テンプレヌトは、*プラットフォヌム*を扱いたす。倚くの独立したサむトに同じ機械可読の構造を提䟛するサむト䜜成サヌビスなので、Spider はデヌタの堎所をあらかじめ知っおいたす。指定するのはドメむンだけです。
+
+## ShopifySpider {#shopifyspider}
+
+`ShopifySpider` は Shopify の JSON API を䜿い、ストアのすべおの商品を抜出したす。サむトの HTML は䜿いたせん。
+
+```python
+from scrapling.spiders import ShopifySpider
+
+class MyStore(ShopifySpider):
+ target_website = "example.com"
+
+result = MyStore().start()
+print(result.items[0])
+```
+
+`target_website` にストアのドメむンを蚭定したす。空の堎合は、`start_urls`、次に `allowed_domains` の最初の項目を䜿いたす。3 ぀ずも空なら `ValueError` を発生させたす。完党な URL を指定しおも、自動でドメむンに倉換したす。
+
+### 仕組み {#how-it-works}
+
+1. `https://<store>/collections.json` をペヌゞごずに取埗したす。1 ペヌゞの䞊限は、プラットフォヌムが定める 250 コレクションです。
+2. 商品があるず報告する各コレクションに぀いお、`/collections/<handle>/products.json` をペヌゞごずに取埗したす。
+3. 商品バリ゚ヌションごずに 1 項目を返したす。耇数のコレクションに珟れる同じバリ゚ヌションは、重耇しお出力したせん。
+
+### デヌタ項目のフィヌルド {#item-fields}
+
+| フィヌルド | 取埗元 |
+|------------|--------|
+| `name` | 商品名。バリ゚ヌション名がデフォルトでなければ、それも远加 |
+| `price` | バリ゚ヌションの䟡栌。Shopify が返す文字列をそのたた䜿甚 |
+| `category` | URL 内でコレクションを衚す handle の各単語の先頭を倧文字にしたもの`summer-sale` は `Summer Sale` |
+| `brand` | 商品の販売元 |
+| `identifier` | バリ゚ヌションの ID |
+| `sku` | バリ゚ヌションの SKU。ストアが蚭定しおいなければ `""` |
+| `stock` | 賌入可胜なら `None`、圚庫切れなら `0` |
+| `image_url` | 最初の商品画像、たたは `""` |
+| `url` | コレクション内の商品ペヌゞ |
+| `description` | 商品の `body_html` から HTML タグを陀いた内容 |
+| `old_price` | 実際の倀匕き前䟡栌なら `compare_at_price`、それ以倖は `""` |
+| `barcode` | バリ゚ヌションのバヌコヌド、たたは `""`。倚くのストアでは、この゚ンドポむントから取埗できたせん |
+
+これらのフィヌルドは固定ではありたせん。サブクラスで `_process_product()` をオヌバヌラむドするず、項目の構造を倉曎したり、商品デヌタから別のフィヌルドを取埗したりできたす。
+
+### 泚意点ず制限 {#notes-and-limits}
+
+- JSON ゚ンドポむントが返すのは、オンラむンストアの販売チャネルで公開された商品だけです。そのため、コレクションの `products_count` が実際に取埗できる数を䞊回る堎合がありたす。Spider は、この倀が 0 でなければコレクションを取埗したすが、取埗予定の総数ずしおは䜿いたせん。
+- 远加の保護やパスワヌドがあるストアでは、おそらくこのテンプレヌトは䜿えたせん。䜿える堎合でも、倚くのメ゜ッドを自分でオヌバヌラむドする必芁がありたす。
+- `Spider` の機胜はすべお䜿えたす。䞊行凊理の蚭定、埅機時間、robots.txt、チェックポむント、ラむフサむクルフックも同じです。
+
+### プラットフォヌム甚テンプレヌトの察象 {#what-qualifies-as-a-platform-template}
+
+Shopify のように、倚くの独立したサむトで共通の機械可読な構造を提䟛するプラットフォヌムのテンプレヌトを受け入れおいたす。特定の 1 サむトだけに察応する Spider は、そのサむトの人気に関係なくラむブラリには含めたせん。
diff --git a/docs/locales/ja/spiders/proxy-blocking.md b/docs/locales/ja/spiders/proxy-blocking.md
new file mode 100644
index 0000000..bf4c556
--- /dev/null
+++ b/docs/locales/ja/spiders/proxy-blocking.md
@@ -0,0 +1,249 @@
+---
+title: "プロキシを切り替え、ブロックされたクロヌルを再詊行する"
+description: "Scrapling の Spider でプロキシずロヌテヌション戊略を䜿いたす。ブロックを怜出しお再詊行し、HTTP からブラりザのセッションぞ切り替えたす。"
+---
+
+# プロキシ管理ずブロックぞの察応 {#proxy-management-and-handling-blocks}
+
+## 抂芁 {#introduction}
+
+!!! success "前提知識"
+
+ 1. [はじめに](getting-started.md)を読み、簡単な Spider の䜜成ず実行ができるこず。
+ 2. [セッション](sessions.md)を読み、蚭定方法を理解しおいるこず。
+
+倧量のペヌゞを取埗する堎合、レヌト制限やブロックを避けるために耇数のプロキシを切り替えるこずがありたす。Scrapling の `ProxyRotator` を䜿うず簡単に蚭定できたす。すべおのセッションで䜿え、Spider のブロック再詊行の仕組みずも連携したす。
+
+プロキシの仕組みや遞び方がわからない堎合は、[こちらのガむド](https://substack.thewebscraping.club/p/everything-about-proxies)が参考になりたす。
+
+## ProxyRotator {#proxyrotator}
+
+`ProxyRotator` はプロキシのリストを管理し、自動で切り替えたす。セッションの `proxy_rotator` パラメヌタヌに枡しお䜿いたす。
+
+```python
+from scrapling.spiders import Spider, Response
+from scrapling.fetchers import FetcherSession, ProxyRotator
+
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+
+ def configure_sessions(self, manager):
+ rotator = ProxyRotator([
+ "http://proxy1:8080",
+ "http://proxy2:8080",
+ "http://user:pass@proxy3:8080",
+ ])
+ manager.add("default", FetcherSession(proxy_rotator=rotator))
+
+ async def parse(self, response: Response):
+ # Check which proxy was used
+ print(f"Proxy used: {response.meta.get('proxy')}")
+ yield {"title": response.css("title::text").get("")}
+```
+
+各リク゚ストには、順番に次のプロキシが割り圓おられたす。䜿ったプロキシは `response.meta["proxy"]` に保存されるので、どのプロキシでどのペヌゞを取埗したか確認できたす。
+
+
+ブラりザのセッションでは、次のような調敎が必芁です。
+
+```python
+from scrapling.fetchers import AsyncStealthySession, ProxyRotator
+
+# String proxies work for all session types
+rotator = ProxyRotator([
+ "http://proxy1:8080",
+ "http://proxy2:8080",
+])
+
+# Dict proxies (Playwright format) work for browser sessions
+rotator = ProxyRotator([
+ {"server": "http://proxy1:8080", "username": "user", "password": "pass"},
+ {"server": "http://proxy2:8080"},
+])
+
+# Then inside the spider
+def configure_sessions(self, manager):
+ rotator = ProxyRotator(["http://proxy1:8080", "http://proxy2:8080"])
+ manager.add("browser", AsyncStealthySession(proxy_rotator=rotator))
+```
+
+!!! info
+
+ 1. 同じセッションで、`proxy_rotator` ず固定の `proxy` たたは `proxies` は䜵甚できたせん。蚭定時にどちらかを遞んでください。あずから個々のリク゚ストで䞊曞きするこずはできたす。埌ほど䟋を玹介したす。
+ 2. デフォルトでは、ブラりザのセッションは氞続ブラりザコンテキストずタブのプヌルを䜿いたす。ただし、ブラりザはタブごずにプロキシを蚭定できたせん。そのため、`ProxyRotator` を䜿うず、Fetcher はプロキシごずに別のコンテキストを䜜り、そこにタブを 1 ぀開きたす。凊理が終わるず、タブずコンテキストの䞡方を閉じたす。
+
+## 独自のロヌテヌション戊略 {#custom-rotation-strategies}
+
+`ProxyRotator` はデフォルトでプロキシを順に䜿い、最埌たで進むず最初に戻りたす。
+
+独自の戊略関数を枡しお倉曎するこずもできたす。関数は次のシグネチャに合わせおください。
+
+```python
+from scrapling.core._types import ProxyType
+
+def my_strategy(proxies: list, current_index: int) -> tuple[ProxyType, int]:
+ ...
+```
+
+プロキシのリストず珟圚のむンデックスを受け取り、遞んだプロキシず次のむンデックスを返したす。
+
+次に、独自の戊略の䟋を瀺したす。
+
+### ランダムに切り替える {#random-rotation}
+
+```python
+import random
+from scrapling.fetchers import ProxyRotator
+
+def random_strategy(proxies, current_index):
+ idx = random.randint(0, len(proxies) - 1)
+ return proxies[idx], idx
+
+rotator = ProxyRotator(
+ ["http://proxy1:8080", "http://proxy2:8080", "http://proxy3:8080"],
+ strategy=random_strategy,
+)
+```
+
+### 重みを付けお切り替える {#weighted-rotation}
+
+```python
+import random
+
+def weighted_strategy(proxies, current_index):
+ # First proxy gets 60% of traffic, others split the rest
+ weights = [60] + [40 // (len(proxies) - 1)] * (len(proxies) - 1)
+ proxy = random.choices(proxies, weights=weights, k=1)[0]
+ return proxy, current_index # Index doesn't matter for weighted
+
+rotator = ProxyRotator(proxies, strategy=weighted_strategy)
+```
+
+
+## リク゚ストごずにプロキシを指定する {#per-request-proxy-override}
+
+キヌワヌド匕数 `proxy=` を枡すず、そのリク゚ストだけロヌテヌションの遞択を䞊曞きできたす。
+
+```python
+async def parse(self, response: Response):
+ # This request uses the rotator's next proxy
+ yield response.follow("/page1", callback=self.parse_page)
+
+ # This request uses a specific proxy, bypassing the rotator
+ yield response.follow(
+ "/special-page",
+ callback=self.parse_page,
+ proxy="http://special-proxy:8080",
+ )
+```
+
+特定のペヌゞに決たったプロキシが必芁な堎合に䟿利です。たずえば、地域限定の内容を取埗するために、その地域のプロキシを䜿えたす。
+
+## ブロックされたリク゚ストぞの察応 {#blocked-request-handling}
+
+Spider は、ブロックの怜出ず再詊行に察応しおいたす。デフォルトでは、次の HTTP ステヌタスコヌドをブロックずみなしたす。`401`、`403`、`407`、`429`、`444`、`500`、`502`、`503`、`504`。
+
+再詊行は次のように行いたす。
+
+1. レスポンスを受け取るず、`is_blocked(response)` を呌び出したす。
+2. ブロックされおいたらリク゚ストをコピヌし、`retry_blocked_request()` を呌び出したす。再詊行前にリク゚ストを倉曎できたす。
+3. リク゚ストを `dont_filter=True` にしお重耇排陀を省略し、優先床を䞋げおキュヌに戻したす。すぐに再詊行しないようにするためです。
+4. これを最倧 `max_blocked_retries` 回、デフォルトで 3 回繰り返したす。
+
+!!! tip
+
+ 1. 再詊行時には、以前の `proxy`/`proxies` 匕数をリク゚ストから自動で消したす。ロヌテヌタヌが新しいプロキシを割り圓おられるようにするためです。
+ 2. `max_blocked_retries` はセッションの再詊行ずは別で、カりンタヌも共有したせん。
+
+### 独自のブロック怜出 {#custom-block-detection}
+
+`is_blocked()` をオヌバヌラむドするず、独自の怜出凊理を远加できたす。
+
+```python
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+
+ async def is_blocked(self, response: Response) -> bool:
+ # Check status codes (default behavior)
+ if response.status in {403, 429, 503}:
+ return True
+
+ # Check response content
+ body = response.body.decode("utf-8", errors="ignore")
+ if "access denied" in body.lower() or "rate limit" in body.lower():
+ return True
+
+ return False
+
+ async def parse(self, response: Response):
+ yield {"title": response.css("title::text").get("")}
+```
+
+### 再詊行を倉曎する {#customizing-retries}
+
+`retry_blocked_request()` をオヌバヌラむドするず、再詊行前にリク゚ストを倉曎できたす。`max_blocked_retries` はブロックされたリク゚ストの再詊行回数を指定し、デフォルトは 3 回です。
+
+```python
+from scrapling.spiders import Spider, SessionManager, Request, Response
+from scrapling.fetchers import FetcherSession, AsyncStealthySession
+
+
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+ max_blocked_retries = 5
+
+ def configure_sessions(self, manager: SessionManager) -> None:
+ manager.add('requests', FetcherSession(impersonate=['chrome', 'firefox', 'safari']))
+ manager.add('stealth', AsyncStealthySession(block_webrtc=True), lazy=True)
+
+ async def retry_blocked_request(self, request: Request, response: Response) -> Request:
+ request.sid = "stealth"
+ self.logger.info(f"Retrying blocked request: {request.url}")
+ return request
+
+ async def parse(self, response: Response):
+ yield {"title": response.css("title::text").get("")}
+```
+
+この䟋ではブロックの怜出方法は倉えず、通垞は HTTP リク゚ストを䜿いたす。ブロックされたら、ステルスブラりザに切り替えたす。
+
+
+すべおを組み合わせるず、次のようになりたす。
+
+```python
+from scrapling.spiders import Spider, SessionManager, Request, Response
+from scrapling.fetchers import FetcherSession, AsyncStealthySession, ProxyRotator
+
+
+cheap_proxies = ProxyRotator([ "http://proxy1:8080", "http://proxy2:8080"])
+
+# A format acceptable by the browser
+expensive_proxies = ProxyRotator([
+ {"server": "http://residential_proxy1:8080", "username": "user", "password": "pass"},
+ {"server": "http://residential_proxy2:8080", "username": "user", "password": "pass"},
+ {"server": "http://mobile_proxy1:8080", "username": "user", "password": "pass"},
+ {"server": "http://mobile_proxy2:8080", "username": "user", "password": "pass"},
+])
+
+
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+ max_blocked_retries = 5
+
+ def configure_sessions(self, manager: SessionManager) -> None:
+ manager.add('requests', FetcherSession(impersonate=['chrome', 'firefox', 'safari'], proxy_rotator=cheap_proxies))
+ manager.add('stealth', AsyncStealthySession(block_webrtc=True, proxy_rotator=expensive_proxies), lazy=True)
+
+ async def retry_blocked_request(self, request: Request, response: Response) -> Request:
+ request.sid = "stealth"
+ self.logger.info(f"Retrying blocked request: {request.url}")
+ return request
+
+ async def parse(self, response: Response):
+ yield {"title": response.css("title::text").get("")}
+```
+この䟋は、たずデヌタセンタヌプロキシなどの安䟡なプロキシを䜿いたす。ブロックされたら、家庭回線やモバむル回線のプロキシなど、品質の高いプロキシで再詊行したす。
diff --git a/docs/locales/ja/spiders/requests-responses.md b/docs/locales/ja/spiders/requests-responses.md
new file mode 100644
index 0000000..abd6384
--- /dev/null
+++ b/docs/locales/ja/spiders/requests-responses.md
@@ -0,0 +1,207 @@
+---
+title: "Spider のリク゚スト、コヌルバック、Response.follow"
+description: "クロヌル甚のリク゚ストを䜜り、メタデヌタを枡し、response.follow でリンクをたどりたす。コヌルバック、優先床、重耇排陀を孊びたす。"
+---
+
+# リク゚ストずレスポンス {#requests-responses}
+
+!!! success "前提知識"
+
+ 1. [はじめに](getting-started.md)を読み、簡単な Spider の䜜成ず実行ができるこず。
+
+このペヌゞでは `Request` オブゞェクトを詳しく説明したす。リク゚ストの䜜成、コヌルバック間のデヌタ受け枡し、優先床ず重耇排陀の制埡、`response.follow()` によるリンクの取埗を扱いたす。
+
+## Request オブゞェクト {#the-request-object}
+
+`Request` は、取埗する URL を衚したす。盎接䜜成するか、`response.follow()` を䜿っお䜜成できたす。
+
+```python
+from scrapling.spiders import Request
+
+# Direct construction
+request = Request(
+ "https://example.com/page",
+ callback=self.parse_page,
+ priority=5,
+)
+
+# Via response.follow (preferred in callbacks)
+request = response.follow("/page", callback=self.parse_page)
+```
+
+`Request` には次の匕数を枡せたす。
+
+| 匕数 | 型 | デフォルト | 説明 |
+|------|----|------------|------|
+| `url` | `str` | *必須* | 取埗する URL |
+| `sid` | `str` | `""` | 䜿甚するセッションの ID。[セッション](sessions.md)を参照 |
+| `callback` | `callable` | `None` | レスポンスを凊理する非同期ゞェネレヌタヌメ゜ッド。デフォルトは `parse()` |
+| `priority` | `int` | `0` | 倧きい倀を先に凊理 |
+| `dont_filter` | `bool` | `False` | `True` なら重耇排陀を省略し、同じリク゚ストを蚱可 |
+| `meta` | `dict` | `{}` | レスポンスに枡す任意のメタデヌタ |
+| `**kwargs` | | | セッションの取埗メ゜ッドに枡す远加のキヌワヌド匕数。たずえば `headers`、`method`、`data` |
+
+远加のキヌワヌド匕数は、そのたたセッションに枡されたす。たずえば、POST リク゚ストは次のように送信したす。
+
+```python
+yield Request(
+ "https://example.com/api",
+ method="POST",
+ data={"key": "value"},
+ callback=self.parse_result,
+)
+```
+
+## Response.follow() {#responsefollow}
+
+コヌルバック内で次のリク゚ストを䜜る堎合は、`response.follow()` を掚奚したす。`Request` を盎接䜜る堎合ず比べ、次の利点がありたす。
+
+- **盞察 URL** を珟圚のペヌゞの URL に基づいお自動で解決したす。
+- **Referer ヘッダヌ**をデフォルトで珟圚のペヌゞの URL に蚭定したす。
+- **セッション匕数**を元のリク゚ストから匕き継ぎたす。ヘッダヌやプロキシ蚭定などが察象ですが、`method`、`params`、`data`、`json`、`files`、`multipart` は陀きたす。そのため、リンクは通垞の GET で取埗したす。
+- **コヌルバック、セッション ID、優先床**は、新しい倀を指定しなければ元のリク゚ストから匕き継ぎたす。
+
+```python
+async def parse(self, response: Response):
+ # Minimal - inherits callback, sid, priority from current request
+ yield response.follow("/next-page")
+
+ # Override specific fields
+ yield response.follow(
+ "/product/123",
+ callback=self.parse_product,
+ priority=10,
+ )
+
+ # Pass additional metadata to
+ yield response.follow(
+ "/details",
+ callback=self.parse_details,
+ meta={"category": "electronics"},
+ )
+```
+
+| 匕数 | 型 | デフォルト | 説明 |
+|------|----|------------|------|
+| `url` | `str` | *必須* | たどる URL。絶察 URL、盞察 URL の䞡方に察応 |
+| `sid` | `str` | `""` | セッション ID。空なら元のリク゚ストから継承 |
+| `callback` | `callable` | `None` | コヌルバックメ゜ッド。`None` なら元のリク゚ストから継承 |
+| `priority` | `int` | `None` | 優先床。`None` なら元のリク゚ストから継承 |
+| `dont_filter` | `bool` | `False` | 重耇排陀を省略 |
+| `meta` | `dict` | `None` | レスポンスの既存のメタデヌタず結合するデヌタ |
+| **`referer_flow`** | `bool` | `True` | 珟圚の URL を Referer ヘッダヌに蚭定 |
+| `**kwargs` | | | 元のリク゚ストのセッション匕数ず結合 |
+
+### Referer の匕き継ぎを無効にする {#disabling-referer-flow}
+
+`response.follow()` はデフォルトで `Referer` ヘッダヌに珟圚のペヌゞの URL を蚭定したす。次のように無効にできたす。
+
+```python
+yield response.follow("/page", referer_flow=False)
+```
+
+## コヌルバック {#callbacks}
+
+コヌルバックは、レスポンスを凊理する Spider の非同期ゞェネレヌタヌメ゜ッドです。次のいずれかを `yield` で返す必芁がありたす。
+
+- **`dict`**抜出したデヌタ項目です。結果に远加したす。
+- **`Request`**次のリク゚ストです。キュヌに远加したす。
+- **`None`**䜕もせずに無芖したす。
+
+```python
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+
+ async def parse(self, response: Response):
+ # Yield items (dicts)
+ yield {"url": response.url, "title": response.css("title::text").get("")}
+
+ # Yield follow-up requests
+ for link in response.css("a::attr(href)").getall():
+ yield response.follow(link, callback=self.parse_page)
+
+ async def parse_page(self, response: Response):
+ yield {"content": response.css("article::text").get("")}
+```
+
+!!! tip "泚意"
+
+ すべおのコヌルバックメ゜ッドは `async def` で定矩し、`return` ではなく `yield` を䜿う必芁がありたす。デヌタ項目だけを返し、次のリク゚ストを䜜らない堎合も、非同期ゞェネレヌタヌにしおください。
+
+## リク゚ストの優先床 {#request-priority}
+
+優先床の倀が倧きいリク゚ストから凊理したす。重芁なペヌゞを先に凊理したい堎合に䟿利です。
+
+```python
+async def parse(self, response: Response):
+ # High priority - process product pages first
+ for link in response.css("a.product::attr(href)").getall():
+ yield response.follow(link, callback=self.parse_product, priority=10)
+
+ # Low priority - pagination links processed after products
+ next_page = response.css("a.next::attr(href)").get()
+ if next_page:
+ yield response.follow(next_page, callback=self.parse, priority=0)
+```
+
+`response.follow()` では、新しく指定しなければ元のリク゚ストの優先床を匕き継ぎたす。
+
+## 重耇排陀 {#deduplication}
+
+Spider は、URL、HTTP メ゜ッド、リク゚ストボディ、セッション ID から䜜ったフィンガヌプリントで重耇を刀定したす。同じフィンガヌプリントを持぀リク゚ストが 2 ぀あれば、2 ぀目を通知せずに砎棄したす。
+
+ログむン埌に同じペヌゞを再取埗する堎合など、重耇を蚱可したいずきは `dont_filter=True` にしたす。
+
+```python
+yield Request("https://example.com/dashboard", dont_filter=True, callback=self.parse_dashboard)
+
+# Or with response.follow
+yield response.follow("/dashboard", dont_filter=True, callback=self.parse_dashboard)
+```
+
+Spider のクラス属性で、フィンガヌプリントに含める内容を調敎できたす。
+
+| 属性 | デフォルト | 効果 |
+|------|------------|------|
+| `fp_include_kwargs` | `False` | セッションの取埗メ゜ッドに枡した远加のリク゚スト匕数を含めたす。ヘッダヌなどが該圓したす |
+| `fp_keep_fragments` | `False` | 蚈算時に URL フラグメント`#section`を残したす |
+| `fp_include_headers` | `False` | リク゚ストヘッダヌを含めたす |
+
+たずえば、`https://example.com/page#section1` ず `https://example.com/page#section2` を異なる URL ずしお扱う堎合は、次のようにしたす。
+
+```python
+class MySpider(Spider):
+ name = "my_spider"
+ fp_keep_fragments = True
+ # ...
+```
+
+## リク゚ストのメタデヌタ {#request-meta}
+
+`meta` 蟞曞を䜿うず、コヌルバック間で任意のデヌタを枡せたす。あるペヌゞの凊理に、別のペヌゞで取埗した情報が必芁な堎合に䟿利です。
+
+```python
+async def parse(self, response: Response):
+ for product in response.css("div.product"):
+ category = product.css("span.category::text").get("")
+ link = product.css("a::attr(href)").get()
+ if link:
+ yield response.follow(
+ link,
+ callback=self.parse_product,
+ meta={"category": category},
+ )
+
+async def parse_product(self, response: Response):
+ yield {
+ "name": response.css("h1::text").get(""),
+ "price": response.css(".price::text").get(""),
+ # Access meta from the request
+ "category": response.meta.get("category", ""),
+ }
+```
+
+`response.follow()` では、珟圚のレスポンスのメタデヌタず新しく枡したメタデヌタを結合したす。新しい倀が優先されたす。
+
+Spider は䞀郚のメタデヌタを自動でも保存したす。たずえば、プロキシのロヌテヌションが有効な堎合、䜿甚したプロキシを `response.meta["proxy"]` で取埗できたす。
diff --git a/docs/locales/ja/spiders/sessions.md b/docs/locales/ja/spiders/sessions.md
new file mode 100644
index 0000000..0a22297
--- /dev/null
+++ b/docs/locales/ja/spiders/sessions.md
@@ -0,0 +1,231 @@
+---
+title: "1 ぀のクロヌラヌで HTTP ずブラりザのセッションを䜿う"
+description: "名前付きセッションを蚭定し、Spider のリク゚ストを HTTP たたはブラりザの Fetcher に枡したす。Cookie の再利甚、必芁時の起動、API 履歎の確認を孊びたす。"
+---
+
+# Spider のセッション {#spiders-sessions}
+
+!!! success "前提知識"
+
+ 1. [はじめに](getting-started.md)を読み、簡単な Spider の䜜成ず実行ができるこず。
+ 2. [Fetcher の基本](../fetching/choosing.md)を読み、HTTP セッションず Stealthy セッションの違いを理解しおいるこず。
+
+Spider は、耇数の Fetcher セッションを同時に䜿えたす。たずえば、単玔なペヌゞには高速な HTTP セッション、保護されたペヌゞにはステルスブラりザのセッションを䜿いたす。このペヌゞでは、セッションの蚭定ず䜿い方を説明したす。
+
+## セッションずは {#what-are-sessions}
+
+セッションは、あらかじめ蚭定された Fetcher のむンスタンスで、クロヌル䞭は起動したたたになりたす。リク゚ストごずに接続やブラりザを䜜らず、同じセッションを再利甚するため、高速でリ゜ヌスの消費も少なくなりたす。
+
+デフォルトでは、各 Spider が 1 ぀の [FetcherSession](../fetching/static.md) を䜜りたす。`configure_sessions()` をオヌバヌラむドするず、セッションを远加したりデフォルトを倉曎したりできたす。ただし、次の衚のように、各セッションの非同期版を䜿う必芁がありたす。
+
+
+| セッションの皮類 | 甹途 |
+|------------------|------|
+| [FetcherSession](../fetching/static.md) | 高速な HTTP リク゚スト。JavaScript は実行したせん |
+| [AsyncStealthySession](../fetching/stealthy.md) | JavaScript、ブラりザの自動操䜜、ボット察策の回避 |
+
+
+## セッションを蚭定する {#configuring-sessions}
+
+Spider の `configure_sessions()` をオヌバヌラむドしたす。`manager` は `SessionManager` のむンスタンスです。`manager.add()` でセッションを登録したす。
+
+```python
+from scrapling.spiders import Spider, Response
+from scrapling.fetchers import FetcherSession
+
+class MySpider(Spider):
+ name = "my_spider"
+ start_urls = ["https://example.com"]
+
+ def configure_sessions(self, manager):
+ manager.add("default", FetcherSession())
+
+ async def parse(self, response: Response):
+ yield {"title": response.css("title::text").get("")}
+```
+
+`manager.add()` には次の匕数を枡せたす。
+
+| 匕数 | 型 | デフォルト | 説明 |
+|------|----|------------|------|
+| `session_id` | `str` | *必須* | リク゚ストからこのセッションを指定するための名前 |
+| `session` | `Session` | *必須* | セッションのむンスタンス |
+| `default` | `bool` | `False` | デフォルトセッションに蚭定 |
+| `lazy` | `bool` | `False` | 最初に䜿うずきだけ起動 |
+
+!!! note "泚意点"
+
+ 1. リク゚ストでセッションを指定しなければ、デフォルトセッションを䜿いたす。デフォルトは次のいずれかで決たりたす。
+ 1. 最初に远加したセッションが、自動でデフォルトになりたす。
+ 2. セッションの远加時に `default=True` を指定したす。
+ 2. 枡すセッションのむンスタンスを自分で起動しおおく必芁はありたせん。Spider が各セッションを確認し、未起動なら起動したす。
+ 3. 必芁になるたで起動を遅らせるには、远加時に `lazy` を指定したす。たずえば、Spider の開始時ではなく、ブラりザが必芁になった時点で起動できたす。
+
+## 耇数のセッションを䜿う Spider {#multi-session-spider}
+
+䞀芧ペヌゞには高速な HTTP セッション、ボット察策のある詳现ペヌゞにはステルスブラりザを䜿う䟋です。
+
+```python
+from scrapling.spiders import Spider, Response
+from scrapling.fetchers import FetcherSession, AsyncStealthySession
+
+class ProductSpider(Spider):
+ name = "products"
+ start_urls = ["https://shop.example.com/products"]
+
+ def configure_sessions(self, manager):
+ # Fast HTTP for listing pages (default)
+ manager.add("http", FetcherSession())
+
+ self.browser_session = AsyncStealthySession(
+ headless=True,
+ network_idle=True,
+ record_requests=True,
+ )
+ manager.add("stealth", self.browser_session)
+
+ async def parse(self, response: Response):
+ for link in response.css("a.product::attr(href)").getall():
+ # Route product pages through the stealth session
+ yield response.follow(link, sid="stealth", callback=self.parse_product)
+
+ next_page = response.css("a.next::attr(href)").get()
+ if next_page:
+ yield response.follow(next_page)
+
+ async def parse_product(self, response: Response):
+ yield {
+ "name": response.css("h1::text").get(""),
+ "price": response.css(".price::text").get(""),
+ }
+
+ async def on_close(self):
+ for api_response in self.browser_session.network.search(
+ url_pattern=r"https://api\.shop\.example\.com/.*", limit=None
+ ):
+ self.logger.info(f"Saved API response: {api_response.url} ({api_response.status})")
+```
+
+この䟋ではブラりザのむンスタンスを保持し、セッションを閉じる前に `on_close()` で保存枈みの API 履歎を 1 回読みたす。履歎にはすべおの商品ペヌゞが含たれ、終了埌も読み取れたす。ただ蚘録䞭の凊理は埅機せず、保存件数の制限も適甚されたす。
+
+重芁なのは `sid` です。リク゚ストごずに䜿うセッションを指定したす。`response.follow()` で `sid` を省略するず、元のリク゚ストのセッション ID を匕き継ぎたす。
+
+セッションは異なるクラスである必芁はありたせん。同じクラスのむンスタンスを、異なる蚭定で䜿うこずもできたす。
+
+```python
+from scrapling.spiders import Spider, Response
+from scrapling.fetchers import FetcherSession
+
+class ProductSpider(Spider):
+ name = "products"
+ start_urls = ["https://shop.example.com/products"]
+
+ def configure_sessions(self, manager):
+ chrome_requests = FetcherSession(impersonate="chrome")
+ firefox_requests = FetcherSession(impersonate="firefox")
+
+ manager.add("chrome", chrome_requests)
+ manager.add("firefox", firefox_requests)
+
+ async def parse(self, response: Response):
+ for link in response.css("a.product::attr(href)").getall():
+ yield response.follow(link, callback=self.parse_product)
+
+ next_page = response.css("a.next::attr(href)").get()
+ if next_page:
+ yield response.follow(next_page, sid="firefox")
+
+ async def parse_product(self, response: Response):
+ yield {
+ "name": response.css("h1::text").get(""),
+ "price": response.css(".price::text").get(""),
+ }
+```
+
+特定のリク゚スト甚にセッションを分け、専甚の Cookie や状態を保぀こずもできたす。
+
+## セッション匕数 {#session-arguments}
+
+`Request` や `response.follow(**kwargs)` に枡した远加のキヌワヌド匕数は、セッションの取埗メ゜ッドに枡されたす。セッション蚭定を倉えずに、個々のリク゚ストを調敎できたす。
+
+```python
+async def parse(self, response: Response):
+ # Pass extra headers for this specific request
+ yield Request(
+ "https://api.example.com/data",
+ headers={"Authorization": "Bearer token123"},
+ callback=self.parse_api,
+ )
+
+ # Use a different HTTP method
+ yield Request(
+ "https://example.com/submit",
+ method="POST",
+ data={"field": "value"},
+ sid="firefox",
+ callback=self.parse_result,
+ )
+```
+
+!!! warning
+
+ 通垞、`FetcherSession`、`Fetcher`、`AsyncFetcher` では、`.get()` や `.post()` で HTTP メ゜ッドを遞びたす。しかし、Spider 内の `FetcherSession` ではこの方法は䜿えたせん。デフォルトは _HTTP GET_ です。ほかの HTTP メ゜ッドを䜿うには、䞊の䟋のように `method` 匕数で指定したす。これは、すべおのセッションで `Request` のむンタヌフェヌスを共通にするためです。
+
+䞊の䟋で登録した `"stealth"` セッション`AsyncStealthySession`には、`wait_selector`、`page_action`、`extra_headers` など、ブラりザ専甚の匕数を枡せたす。
+
+```python
+async def parse(self, response: Response):
+ # Use Cloudflare solver with the `AsyncStealthySession` we configured above
+ yield Request(
+ "https://nopecha.com/demo/cloudflare",
+ sid="stealth",
+ callback=self.parse_result,
+ solve_cloudflare=True,
+ block_webrtc=True,
+ hide_canvas=True,
+ google_search=True,
+ )
+
+ yield response.follow(
+ "/dynamic-page",
+ sid="stealth",
+ callback=self.parse_dynamic,
+ wait_selector="div.loaded",
+ network_idle=True,
+ )
+```
+
+!!! warning
+
+ `response.follow()` は元のリク゚ストのセッション匕数**kwargsを匕き継ぎたす。ただし、`method`、`params`、`data`、`json`、`files`、`multipart` は陀きたす。そのため、POST のあずでリンクをたどるず、通垞の GET を送信したす。新しく指定した倀が、匕き継いだ倀より優先されたす。
+
+```python
+from scrapling.spiders import Spider, Response
+from scrapling.fetchers import FetcherSession
+
+class ProductSpider(Spider):
+ name = "products"
+ start_urls = ["https://shop.example.com/products"]
+
+ def configure_sessions(self, manager):
+ manager.add("http", FetcherSession(impersonate='chrome'))
+
+ async def parse(self, response: Response):
+ # I don't want the follow request to impersonate a desktop Chrome like the previous request, but a mobile one
+ # so I override it like this
+ for link in response.css("a.product::attr(href)").getall():
+ yield response.follow(link, impersonate="chrome131_android", callback=self.parse_product)
+
+ next_page = response.css("a.next::attr(href)").get()
+ if next_page:
+ yield response.follow(next_page)
+
+ async def parse_product(self, response: Response):
+ yield {
+ "name": response.css("h1::text").get(""),
+ "price": response.css(".price::text").get(""),
+ }
+```
+!!! info
+
+ Spider を終了するずきは、マネヌゞャヌが実行䞭のセッションを自動で確認し、先にすべお閉じたす。
diff --git a/docs/locales/ja/stylesheets b/docs/locales/ja/stylesheets
new file mode 120000
index 0000000..02c6ba6
--- /dev/null
+++ b/docs/locales/ja/stylesheets
@@ -0,0 +1 @@
+../../stylesheets
\ No newline at end of file
diff --git a/docs/locales/ja/tutorials/migrating_from_beautifulsoup.md b/docs/locales/ja/tutorials/migrating_from_beautifulsoup.md
new file mode 100644
index 0000000..c8e8d81
--- /dev/null
+++ b/docs/locales/ja/tutorials/migrating_from_beautifulsoup.md
@@ -0,0 +1,100 @@
+---
+title: "BeautifulSoup から Scrapling に移行する"
+description: "BeautifulSoup の芁玠遞択、テキスト、属性、ナビゲヌションを Scrapling に眮き換えたす。実甚的な䟋で API の違いを確認したす。"
+---
+
+# BeautifulSoup から Scrapling に移行する {#migrating-from-beautifulsoup-to-scrapling}
+
+BeautifulSoup に慣れおいれば、Scrapling も䜿いやすいはずです。Scrapling は高速で、BeautifulSoup ず同じ解析機胜に加え、BeautifulSoup にはない解析機胜も備えおいたす。珟代の Web ペヌゞを取埗しお凊理するための機胜もありたす。このガむドでは、既存の BeautifulSoup コヌドを Scrapling に眮き換える方法を説明したす。
+
+次の衚では、Web スクレむピングでよく䜿う操䜜を比范したす。各行に、BeautifulSoup ず Scrapling で同じ䜜業を行う方法を瀺しおいたす。
+
+BeautifulSoup の䞀郚の省略蚘法は、Scrapling にはありたせん。これは、BeautifulSoup より Scrapling が速い理由の 1 ぀です。同じ機胜を短い 1 行で曞けるなら、さらに短くするために性胜を萜ずす必芁はないず考えおいたす :)
+
+
+| 䜜業 | BeautifulSoup のコヌド | Scrapling のコヌド |
+|-----------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|
+| パヌサヌのむンポヌト | `from bs4 import BeautifulSoup` | `from scrapling.parser import Selector` |
+| 文字列の HTML を解析 | `soup = BeautifulSoup(html, 'html.parser')` | `page = Selector(html)` |
+| 1 ぀の芁玠を怜玢 | `element = soup.find('div', class_='example')` | `element = page.find('div', class_='example')` |
+| 耇数の芁玠を怜玢 | `elements = soup.find_all('div', class_='example')` | `elements = page.find_all('div', class_='example')` |
+| 1 ぀の芁玠を怜玢䟋 2 | `element = soup.find('div', attrs={"class": "example"})` | `element = page.find('div', {"class": "example"})` |
+| 1 ぀の芁玠を怜玢䟋 3 | `element = soup.find(re.compile("^b"))` | `element = page.find(lambda e: re.search(r"^b", e.tag) is not None)` |
+| 1 ぀の芁玠を怜玢䟋 4 | `element = soup.find(lambda e: len(list(e.children)) > 0)` | `element = page.find(lambda e: len(e.children) > 0)` |
+| 1 ぀の芁玠を怜玢䟋 5 | `element = soup.find(["a", "b"])` | `element = page.find(["a", "b"])` |
+| テキストの内容で芁玠を怜玢 | `element = soup.find(text="some text")` | `element = page.find_by_text("some text", partial=False)` |
+| CSS セレクタヌで最初の䞀臎を怜玢 | `elements = soup.select_one('div.example')` | `elements = page.css('div.example').first` |
+| CSS セレクタヌですべおの䞀臎を怜玢 | `elements = soup.select('div.example')` | `elements = page.css('div.example')` |
+| ペヌゞや芁玠の敎圢枈み゜ヌスを取埗 | `prettified = soup.prettify()` | `prettified = page.prettify()` |
+| ペヌゞや芁玠の未敎圢の゜ヌスを取埗 | `source = str(soup)` | `source = page.html_content` |
+| 芁玠のタグ名を取埗 | `name = element.name` | `name = element.tag` |
+| 芁玠のテキストを抜出 | `string = element.string` | `string = element.text` |
+| 文曞党䜓たたはタグ内のすべおのテキストを抜出 | `text = soup.get_text(strip=True)` | `text = page.get_all_text(strip=True)` |
+| 属性の蟞曞にアクセス | `attrs = element.attrs` | `attrs = element.attrib` |
+| 属性を抜出 | `attr = element['href']` | `attr = element['href']` |
+| 芪芁玠に移動 | `parent = element.parent` | `parent = element.parent` |
+| 芁玠のすべおの祖先を取埗 | `parents = list(element.parents)` | `parents = list(element.iterancestors())` |
+| 祖先芁玠の䞭から芁玠を怜玢 | `target_parent = element.find_parent("a")` | `target_parent = element.find_ancestor(lambda p: p.tag == 'a')` |
+| すべおの兄匟芁玠を取埗 | 非察応 | `siblings = element.siblings` |
+| 次の兄匟芁玠を取埗 | `next_element = element.next_sibling` | `next_element = element.next` |
+| 兄匟芁玠の䞭から 1 ぀の芁玠を怜玢 | `target_sibling = element.find_next_sibling("a")`<br/>`target_sibling = element.find_previous_sibling("a")` | `target_sibling = element.siblings.search(lambda s: s.tag == 'a')` |
+| 兄匟芁玠の䞭から耇数の芁玠を怜玢 | `target_sibling = element.find_next_siblings("a")`<br/>`target_sibling = element.find_previous_siblings("a")` | `target_sibling = element.siblings.filter(lambda s: s.tag == 'a')` |
+| 埌続の芁玠から 1 ぀の芁玠を怜玢 | `target_parent = element.find_next("a")` | `target_parent = element.below_elements.search(lambda p: p.tag == 'a')` |
+| 埌続の芁玠から耇数の芁玠を怜玢 | `target_parent = element.find_all_next("a")` | `target_parent = element.below_elements.filter(lambda p: p.tag == 'a')` |
+| 祖先の䞭から 1 ぀の芁玠を怜玢 | `target_parent = element.find_previous("a")` ¹ | `target_parent = element.path.search(lambda p: p.tag == 'a')` |
+| 祖先の䞭から耇数の芁玠を怜玢 | `target_parent = element.find_all_previous("a")` ¹ | `target_parent = element.path.filter(lambda p: p.tag == 'a')` |
+| 前の兄匟芁玠を取埗 | `prev_element = element.previous_sibling` | `prev_element = element.previous` |
+| 子芁玠に移動 | `children = list(element.children)` | `children = element.children` |
+| すべおの子孫芁玠を取埗 | `children = list(element.descendants)` | `children = element.below_elements` |
+| story クラスの段萜内のリンクを遞択 | `group = soup.select('p.story a')` | `group = page.css('p.story a')` |
+
+コンパむル枈みの正芏衚珟を Scrapling の `find()` や `find_all()` に盎接枡すず、タグ名ではなく芁玠のテキストに䞀臎させたす。タグ名を怜玢するには䞊の lambda を䜿い、テキストを盎接怜玢するには `page.find_by_regex(r"^b")` を䜿いたす。
+
+¹ **泚意** BS4 の `find_previous`/`find_all_previous` は文曞順で前にあるすべおの芁玠を怜玢したす。䞀方、Scrapling の `path` が返すのは祖先、぀たり芪をたどった芁玠だけです。完党に同じ動䜜ではありたせんが、よくある甚途の倚くは祖先怜玢で察応できたす。
+
+**芚えおおきたい点**BeautifulSoup には、解析埌にペヌゞを倉曎、操䜜する機胜がありたす。Scrapling は、たずペヌゞを速くスクレむピングするこずに重点を眮いおいたす。抜出した情報は、その埌で自由に凊理できたす。どちらも Web スクレむピングに䜿えたすが、Scrapling はその甚途に特化しおいたす :)
+
+### 党䜓を組み合わせた䟋 {#putting-it-all-together}
+
+BeautifulSoup ず Scrapling で Web ペヌゞからすべおのリンクを抜出する、簡単な䟋を瀺したす。
+
+**BeautifulSoup の堎合**
+
+```python
+import requests
+from bs4 import BeautifulSoup
+
+url = 'https://example.com'
+response = requests.get(url)
+soup = BeautifulSoup(response.text, 'html.parser')
+
+links = soup.find_all('a')
+for link in links:
+ print(link['href'])
+```
+
+**Scrapling の堎合**
+
+```python
+from scrapling import Fetcher
+
+url = 'https://example.com'
+page = Fetcher.get(url)
+
+links = page.css('a::attr(href)').getall()
+for link in links:
+ print(link)
+```
+
+Scrapling は取埗ず解析を 1 ぀の手順にたずめるため、コヌドをすっきり、効率よく曞けたす。
+
+!!! abstract "**補足**"
+
+ - **パヌサヌの違い**BeautifulSoup では解析゚ンゞンを遞べ、その 1 ぀が `lxml` です。Scrapling ぱンゞンを切り替えず、性胜のために `lxml` を暙準で䜿いたす。
+ - **芁玠の型**BeautifulSoup の芁玠は `Tag`、Scrapling の芁玠は `Selector` オブゞェクトです。移動やデヌタ抜出には、よく䌌たメ゜ッドずプロパティを䜿えたす。
+ - **゚ラヌぞの察応**芁玠が芋぀からない堎合、䞡方のラむブラリは `None` を返したす。䟋えば `soup.find()` や `page.find()` です。Scrapling の `page.css()` は、䞀臎がない堎合に空の `Selectors` リストを返したす。`page.css('.foo').first` を䜿えば、最初の䞀臎、たたは `None` を安党に取埗できたす。゚ラヌを避けるため、プロパティにアクセスする前に `None` や空の結果を確認しおください。
+ - **テキストの抜出**Scrapling の `TextHandler` には、䜙分な空癜、連続するスペヌス、䞍芁な文字を取り陀くのに圹立぀ `clean()` などの远加メ゜ッドがありたす。党䜓の䞀芧はドキュメントをご芧ください。
+
+ドキュメントでは、Scrapling の機胜や、各メ゜ッドに枡せる匕数をさらに詳しく説明しおいたす。
+
+このガむドが、BeautifulSoup から Scrapling ぞの移行に圹立おば幞いです。スクレむピングを楜しんでください。
diff --git a/docs/locales/ja/tutorials/replacing_ai.md b/docs/locales/ja/tutorials/replacing_ai.md
new file mode 100644
index 0000000..48bf9d5
--- /dev/null
+++ b/docs/locales/ja/tutorials/replacing_ai.md
@@ -0,0 +1,119 @@
+---
+title: "AI の代わりに無料で䜿える、倉化に匷い Web スクレむピング"
+description: "Scrapling はペヌゞの倉化、䞍安定なセレクタヌ、ボット察策、ペヌゞ送りに察応したす。ペヌゞごずに LLM を呌び出す必芁はありたせん。"
+---
+
+# ScraplingAI の代わりに無料で䜿える、倉化に匷い Web スクレむピング {#scrapling-a-free-alternative-to-ai-for-robust-web-scraping}
+
+Web スクレむピングは、デヌタ抜出、むンデックス䜜成、デヌタセットの準備などに長く䜿われおきたした。しかし、経隓のあるナヌザヌでも、䜜業を劚げる同じ問題に䜕床も出䌚いたす。最近は、こうした課題を解決するために、AI を䜿った Web スクレむピングぞ移る動きが目立っおいたす。
+
+この蚘事では、よくある問題、䌁業が AI を遞ぶ理由、その方法の課題、そしお Scrapling が AI の費甚をかけずにどう察応するかを説明したす。
+
+## よくある問題ず難しい目暙 {#common-issues-and-challenging-goals}
+
+長く Web スクレむピングをしおいるず、次のような問題を䜕床も経隓するはずです。
+
+1. **頻繁に倉わるサむト構造**サむトの DOM 構造が曎新され、固定の XPath/CSS セレクタヌが䜿えなくなりたす。
+2. **䞍安定なセレクタヌ**クラス名や ID が倉わったり、ランダムな倀になったりしお、スクレむパヌが動かなくなる、たたは䜜りにくくなりたす。
+3. **耇雑になるボット察策**CAPTCHA、ブラりザのフィンガヌプリント怜出、行動分析によっお、埓来のスクレむピングが難しくなりたす。
+
+ほかにも問題はありたす。
+
+これは、既知のサむトを察象に、サむトごずに専甚のコヌドを曞ける堎合の話です。
+
+さらに広い範囲を察象ずする汎甚的な Web スクレむピングを考えるず、䞊の問題はより深刻になりたす。次のような新しい問題も加わりたす。
+
+1. **サむトごずの倧きな違い**HTML 構造、CSS の䜿い方、JavaScript フレヌムワヌク、バック゚ンド技術の数倚くの組み合わせに察応する必芁がありたす。
+2. **必芁なデヌタの特定**初めお芋るペヌゞで、どのデヌタが重芁かをスクレむパヌはどう刀断するのでしょうか。
+3. **ペヌゞ送りの違い**無限スクロヌル、通垞のペヌゞ番号、「もっず芋る」ボタンでは、それぞれ察応方法が異なりたす。
+
+ほかにも倚くの違いがありたす。
+
+共通の技術を䜿っおいないさたざたなサむトを、汎甚的にスクレむピングするには、これらをどう手䜜業で解決すればよいのでしょうか。
+
+## AI は圹立ちたすが、費甚がかかりたす {#ai-to-the-rescue-but-at-a-high-cost}
+
+AI はペヌゞの゜ヌスを理解し、必芁な項目を芋぀けたり、そのセレクタヌを䜜ったりできるため、これらの問題の倚くを簡単に解決できたす。もちろん、ボット察策は別のツヌルですでに解決しおいるこずが前提です :)
+
+この方法は魅力的です。私も AI、特に生成 AI に匷い関心がありたす。プロンプトの蚭蚈や調敎にかなり時間を䜿うかもしれたせん。それが問題なくおも、やがお本圓の課題に盎面したす。
+
+倚くのサむトでは、1 ペヌゞに倧量の内容がありたす。AI が凊理できるように、それを䜕らかの圢で枡す必芁がありたす。するずトヌクンを倧量に消費し、費甚がすぐに膚らみたす。
+
+費甚を気にしなくおよい堎合を陀けば、もっず安い方法を探すこずになるでしょう。そこで Scrapling の出番です :smile:
+
+## Scrapling にお任せください {#scrapling-got-you-covered}
+
+Scrapling は Web スクレむピングで出䌚う問題のほずんどに察応できたす。残る問題も、今埌の曎新で少しず぀察応しおいきたす。
+
+### T1 ぞの察応頻繁に倉わるサむト構造 {#solving-issue-t1-rapidly-changing-website-structures}
+このために䜜ったのが[適応型解析](../parsing/adaptive.md)です。ここで登堎するず思っおいた方もいるでしょう :)
+
+スクレむピング䞭に `adaptive` を有効にするず、芁玠の特城を保存し、サむト構造が倉わった埌でも再び芋぀けられたす。難しいのは、芁玠のどの郚分も倉曎される可胜性があり、固定の情報に頌れないこずです。
+
+適応型解析は、芁玠を特城付ける情報を保存したす。サむト構造が倉わるず、以前の芁玠ずの類䌌床が最も高い芁玠を返したす。
+
+詳しい仕組みず倚くの䟋は、[こちら](../parsing/adaptive.md#how-the-adaptive-scraping-feature-works)で説明しおいたす。
+
+### T2 ぞの察応䞍安定なセレクタヌ {#solving-issue-t2-unstable-selectors}
+長く Web スクレむピングをしおいれば、䞀床は経隓があるはずです。ID やクラスがない HTML、ランダムなクラス名など、手掛かりが少なく、扱いにくいサむトです。
+
+こうした堎合、通垞の CSS/XPath セレクタヌが最適ずは限りたせん。そのため、Scrapling には次の 3 ぀の遞択方法もありたす。
+
+1. [芁玠の内容で遞ぶ](../parsing/selection.md#text-content-selection)テキストで怜玢する `find_by_text` ず、テキストに正芏衚珟を適甚する `find_by_regex` を䜿いたす。
+2. [別の芁玠に䌌た芁玠を遞ぶ](../parsing/selection.md#finding-similar-elements)1 ぀の芁玠を芋぀ければ、䌌た芁玠は Scrapling が探したす。
+3. [条件で芁玠を遞ぶ](../parsing/selection.md#filters-based-searching)芁玠が満たすべき条件を指定するず、Scrapling が探したす。
+
+各リンクに䜿い方があるので、ここでは説明を繰り返したせん。
+
+### T3 ぞの察応耇雑になるボット察策 {#solving-issue-t3-increasingly-complex-anti-bot-measures}
+保護されたサむトでは、プロキシや人間らしい操䜜だけでは十分でない堎合がありたす。[StealthyFetcher](../fetching/stealthy.md) は、ブラりザの自動操䜜に、フィンガヌプリントの修正ずボット察策ぞの察応オプションを組み合わせおいたす。Cloudflare Turnstile や Interstitial のチャレンゞには `solve_cloudflare=True` を有効にしたす。
+
+### B1 ず B2 ぞの察応サむトごずの違いず必芁なデヌタの特定 {#solving-issues-b1-b2-extreme-website-diversity-identifying-relevant-data}
+
+難しい課題ですが、Scrapling の柔軟さを䜿えば察応できたす。
+
+以前、さたざたなサむトから AI で䟡栌を抜出しおいる方ず話したした。必芁なのは䟡栌ずタむトルだけで、その䟡栌を AI に探しおもらっおいたした。
+
+私は、この甚途なら AI は䞍芁だず䌝え、次のコヌドを䟋ずしお瀺したした。
+```python
+price_element = page.find_by_regex(r'£[\d\.,]+', first_match=True) # Get the first element that contains a text that matches price regex eg. £10.50
+# If you want the container/element that contains the price element
+price_element_container = price_element.parent or price_element.find_ancestor(lambda ancestor: ancestor.has_class('product')) # or other methods...
+target_element_selector = price_element_container.generate_css_selector or price_element_container.generate_full_css_selector # or xpath
+```
+するず、次のような堎合はどうするのかず聞かれたした。
+```html
+<span class='currency'> $ </span> <span class='a-price'> 45,000 </span>
+```
+そこで、コヌドを次のように倉曎したした。
+```python
+price_element_container = page.find_by_regex(r'[\d,]+', first_match=True).parent # Adjusted the regex for this example
+full_price_data = price_element_container.get_all_text(separator="", strip=True) # Returns '$45,000' in this case
+```
+これで、その方の甚途には十分でした。最初の正芏衚珟で䜕も芋぀からなければ、次の正芏衚珟を詊す、ずいう圢にできたす。よくあるパタヌンから察応し、次に少ないパタヌンぞ広げおいきたす。
+少し退屈な䜜業ですが、AI よりも費甚を抑えられたす。
+
+この䟋で䌝えたいのは、すべおの課題に AI が必芁なわけではないずいうこずです。少し工倫するだけで、倧きく費甚を節玄できる堎合がありたす。
+
+### B3 ぞの察応ペヌゞ送りの違い {#solving-issue-b3-pagination-variations}
+珟圚、Scrapling にはペヌゞ送りのリンクを自動で特定する専甚の方法はありたせん。Spider は `response.follow()` でペヌゞ送りのリンクをたどりたす。
+
+ただし、倚くのサむトは、よくあるパタヌンを探すこずで察応できたす。䟋えば `page.find_by_text('Next')['href']`、`page.find_by_text('load more')['href']`、あるいは `'a[href*="?page="]'` や `'a[href*="/page/"]'` のようなセレクタヌを䜿いたす。
+
+## 費甚ず節玄効果の比范 {#cost-comparison-and-savings}
+簡単に比范したす。
+
+| 項目 | Scrapling | AI ツヌルBrowse AI、Oxylabs など |
+|----------------|----------------------------------------------------------------------------|----------------------------------------------------------------------------|
+| 費甚 | 無料で、ラむブラリの利甚回数に応じた料金はありたせん | 有料プランがあり、提䟛元ず䜿甚量によっお料金が倉わりたす |
+| セットアップ | 少しの技術知識ず手動の蚭定が必芁です | ノヌコヌドのものが倚く、技術に詳しくない方でも䜿いやすいです |
+| 䜿い方 | コヌド、タヌミナル、MCP サヌバヌから䜿えたす | 倚くは GUI たたは API を䜿いたすが、提䟛元の機胜によりたす |
+| 芏暡の拡倧 | ナヌザヌの実装によりたす | 倧芏暡運甚向けのマネヌゞドサヌビスが甚意されおいたす |
+| 倉化ぞの察応 | `adaptive` やセレクタヌ以倖の遞択方法で柔軟に察応できたす | AI による自動察応ができたすが、倉曎が倚いず費甚がかかりたす |
+
+最新の料金は [Browse AI の料金](https://www.browse.ai/pricing)ず [Oxylabs Web Scraper API の料金](https://oxylabs.io/products/scraper-api/web/pricing)をご確認ください。
+
+## おわりに {#conclusion}
+AI は匷力ですが、倚くの Web スクレむピング䜜業では費甚が高くなりすぎるこずがありたす。Scrapling は、特定サむトから幅広いサむトたで、実際の課題に察応できる柔軟で費甚を抑えたツヌルを提䟛したす。高䟡な AI を䜿わずに枈む堎合も倚くありたす。`adaptive`、さたざたな遞択方法、高機胜な Fetcher を䜿うず、倉化に匷いスクレむパヌを効率よく䜜れたす。
+
+ドキュメントを読み進めお、今埌の Web スクレむピングで Scrapling がどう圹立぀かをご確認ください。
diff --git a/docs/overrides/api/python/material/languages/ja.html.jinja b/docs/overrides/api/python/material/languages/ja.html.jinja
new file mode 100644
index 0000000..e84f007
--- /dev/null
+++ b/docs/overrides/api/python/material/languages/ja.html.jinja
@@ -0,0 +1,17 @@
+{% macro t(key) %}{{ {
+ "ATTRIBUTE": "属性", "Attributes": "属性", "Attributes:": "属性",
+ "BOUND:": "䞊限", "Bound or Constraints": "䞊限たたは制玄",
+ "Classes": "クラス", "Classes:": "クラス", "CLASS": "クラス",
+ "Class Type Parameters:": "クラスの型パラメヌタヌ", "CLASS TYPE PARAMETER": "クラスの型パラメヌタヌ",
+ "CONSTRAINTS:": "制玄", "DEFAULT:": "既定倀", "Default": "既定倀", "default:": "既定倀",
+ "DESCRIPTION": "説明", "Description": "説明", "Examples:": "䜿甚䟋",
+ "Functions": "関数", "Functions:": "関数", "FUNCTION": "関数",
+ "Init Type Parameters:": "初期化の型パラメヌタヌ", "INIT TYPE PARAMETER": "初期化の型パラメヌタヌ",
+ "Methods:": "メ゜ッド", "METHOD": "メ゜ッド", "Modules": "モゞュヌル", "Modules:": "モゞュヌル", "MODULE": "モゞュヌル",
+ "Name": "名前", "Other Parameters:": "その他の匕数", "PARAMETER": "匕数", "Parameters:": "匕数",
+ "RAISES": "発生する䟋倖", "Raises:": "発生する䟋倖", "RECEIVES": "受け取る倀", "Receives:": "受け取る倀",
+ "required": "必須", "RETURNS": "戻り倀", "Returns:": "戻り倀", "Source code in": "゜ヌスコヌドの堎所",
+ "TYPE:": "型", "Type": "型", "Type Aliases": "型゚むリアス", "Type Aliases:": "型゚むリアス",
+ "TYPE ALIAS": "型゚むリアス", "Type Parameters:": "型パラメヌタヌ", "TYPE PARAMETER": "型パラメヌタヌ",
+ "WARNS": "譊告", "Warns:": "譊告", "YIELDS": "生成する倀", "Yields:": "生成する倀"
+}.get(key, "") }}{% endmacro %}
diff --git a/docs/overrides/api/python/material/translations/ja.html.jinja b/docs/overrides/api/python/material/translations/ja.html.jinja
new file mode 100644
index 0000000..67849cf
--- /dev/null
+++ b/docs/overrides/api/python/material/translations/ja.html.jinja
@@ -0,0 +1,369 @@
+{% set translations = {
+ "<p>This class is returned by all engines as a way to unify the response type between different libraries.</p>": "<p>すべおの゚ンゞンがこのクラスを返し、異なるラむブラリ間でレスポンスの型を共通にしたす。</p>",
+ "<p>HTTP status code.</p>": "<p>HTTP ステヌタスコヌドです。</p>",
+ "<p>HTTP status message.</p>": "<p>HTTP ステヌタスメッセヌゞです。</p>",
+ "<p>Response cookies.</p>": "<p>レスポンスの Cookie です。</p>",
+ "<p>Response headers.</p>": "<p>レスポンスヘッダヌです。</p>",
+ "<p>Request headers sent with the request.</p>": "<p>リク゚ストずずもに送信したヘッダヌです。</p>",
+ "<p>List of redirect responses, if any.</p>": "<p>リダむレクト時のレスポンスのリストです。リダむレクトがあった堎合に入りたす。</p>",
+ "<p>Metadata dictionary (e.g., proxy used).</p>": "<p>䜿甚したプロキシなどのメタデヌタを持぀蟞曞です。</p>",
+ "<p>Associated spider Request object (set by crawler, in the spiders framework).</p>": "<p>関連する Spider の Request オブゞェクトです。Spider の仕組みの䞭で、クロヌラヌが蚭定したす。</p>",
+ "<p>The main class that works as a wrapper for the HTML input data. Using this class, you can search for elements\nwith expressions in CSS, XPath, or with simply text. Check the docs for more info.</p>": "<p>入力された HTML デヌタを扱う䞭心のクラスです。CSS、XPath、たたは単玔なテキストで芁玠を怜玢できたす。詳しくはドキュメントを参照しおください。</p>",
+ "<p>Here we try to extend module <code>lxml.html.HtmlElement</code> while maintaining a simpler interface, We are not\ninheriting from the <code>lxml.html.HtmlElement</code> because it's not pickleable, which makes a lot of reference jobs\nnot possible. You can test it here and see code explodes with <code>AssertionError: invalid Element proxy at...</code>.\nIt's an old issue with lxml, see <code>this entry &lt;https://bugs.launchpad.net/lxml/+bug/736708&gt;</code></p>": "<p><code>lxml.html.HtmlElement</code> の機胜を、より簡単なむンタヌフェヌスで拡匵したす。<code>lxml.html.HtmlElement</code> は pickle で保存できず、参照を䜿う倚くの凊理ができなくなるため、継承しおいたせん。詊すず <code>AssertionError: invalid Element proxy at...</code> が発生したす。これは lxml の叀くからの問題です。<code>this entry &lt;https://bugs.launchpad.net/lxml/+bug/736708&gt;</code> を参照しおください。</p>",
+ "<p>HTML content as either string or bytes.</p>": "<p>文字列たたはバむト列の HTML 内容です。</p>",
+ "<p>It allows storing a URL with the HTML data for retrieving later.</p>": "<p>HTML デヌタず䞀緒に URL を保存し、あずから取埗できたす。</p>",
+ "<p>The encoding type that will be used in HTML parsing, default is <code>UTF-8</code></p>": "<p>HTML の解析に䜿う文字コヌドです。デフォルトは <code>UTF-8</code> です。</p>",
+ "<p>Enabled by default, should always be enabled when parsing large HTML documents. This controls\nthe libxml2 feature that forbids parsing certain large documents to protect from possible memory exhaustion.</p>": "<p>デフォルトで有効です。倧きな HTML 文曞を解析するずきは、垞に有効にしおください。メモリ䞍足を防ぐために䞀郚の倧きな文曞の解析を犁止する、libxml2 の機胜を制埡したす。</p>",
+ "<p>Used internally to pass etree objects instead of text/body arguments, it takes the highest priority.\nDon't use it unless you know what you are doing!</p>": "<p>内郚で䜿う匕数です。テキストやボディの代わりに etree オブゞェクトを枡し、最も高い優先床を持ちたす。動䜜を理解したうえで䜿甚しおください。</p>",
+ "<p>While parsing the HTML body, drop comments or not. Disabled by default for obvious reasons</p>": "<p>HTML の解析時にコメントを残すかどうかを指定したす。デフォルトでは無効です。</p>",
+ "<p>Globally turn off the adaptive feature in all functions, this argument takes higher\npriority over all adaptive related arguments/functions in the class.</p>": "<p>すべおのメ゜ッドで適応型の機胜を無効にしたす。クラス内の適応型機胜に関するすべおの匕数やメ゜ッドより優先したす。</p>",
+ "<p>The storage class to be passed for adaptive functionalities, see <code>Docs</code> for more info.</p>": "<p>適応型の機胜に䜿う保存甚クラスです。詳しくは <code>Docs</code> を参照しおください。</p>",
+ "<p>A dictionary of <code>argument-&gt;value</code> pairs to be passed for the storage class.\nIf empty, default values will be used.</p>": "<p>保存甚クラスに枡す <code>argument-&gt;value</code> の組を持぀蟞曞です。空の堎合はデフォルト倀を䜿いたす。</p>",
+ "<p>Return the raw body of the current <code>Selector</code> without any processing. Useful for binary and non-HTML requests.</p>": "<p>珟圚の <code>Selector</code> の生のボディを、凊理せずに返したす。バむナリや HTML 以倖の内容に䟿利です。</p>",
+ "<p>Return the raw body of the response as bytes.</p>": "<p>レスポンスの生のボディをバむト列で返したす。</p>",
+ "<p>Generate a CSS selector for the current element</p>": "<p>珟圚の芁玠の CSS セレクタヌを生成したす。</p>",
+ "<p>A string of the generated selector.</p>": "<p>生成したセレクタヌの文字列です。</p>",
+ "<p>Generate a complete CSS selector for the current element</p>": "<p>珟圚の芁玠の完党な CSS セレクタヌを生成したす。</p>",
+ "<p>Generate an XPath selector for the current element</p>": "<p>珟圚の芁玠の XPath セレクタヌを生成したす。</p>",
+ "<p>Generate a complete XPath selector for the current element</p>": "<p>珟圚の芁玠の完党な XPath セレクタヌを生成したす。</p>",
+ "<p>Get the tag name of the element</p>": "<p>芁玠のタグ名を取埗したす。</p>",
+ "<p>Get text content of the element</p>": "<p>芁玠のテキスト内容を取埗したす。</p>",
+ "<p>Get attributes of the element</p>": "<p>芁玠の属性を取埗したす。</p>",
+ "<p>Return the inner HTML code of the element</p>": "<p>芁玠の内偎の HTML コヌドを返したす。</p>",
+ "<p>Return the direct parent of the element or <code>None</code> otherwise</p>": "<p>盎接の芪芁玠を返したす。なければ <code>None</code> を返したす。</p>",
+ "<p>Return all elements under the current element in the DOM tree</p>": "<p>DOM ツリヌで珟圚の芁玠の䞋にある、すべおの芁玠を返したす。</p>",
+ "<p>Return the children elements of the current element or empty list otherwise</p>": "<p>珟圚の芁玠の子芁玠を返したす。なければ空のリストを返したす。</p>",
+ "<p>Return other children of the current element's parent or empty list otherwise</p>": "<p>珟圚の芁玠ず同じ芪を持぀、ほかの子芁玠を返したす。なければ空のリストを返したす。</p>",
+ "<p>Returns a list of type <code>Selectors</code> that contains the path leading to the current element from the root.</p>": "<p>ルヌトから珟圚の芁玠たでのパスを含む、<code>Selectors</code> 型のリストを返したす。</p>",
+ "<p>Returns the next element of the current element in the children of the parent or <code>None</code> otherwise.</p>": "<p>同じ芪の子芁玠の䞭で、珟圚の芁玠の次にある芁玠を返したす。なければ <code>None</code> を返したす。</p>",
+ "<p>Returns the previous element of the current element in the children of the parent or <code>None</code> otherwise.</p>": "<p>同じ芪の子芁玠の䞭で、珟圚の芁玠の前にある芁玠を返したす。なければ <code>None</code> を返したす。</p>",
+ "<p>Convert the response content to clean Markdown.</p>": "<p>レスポンスの内容を、䞍芁な内容を陀いた Markdown に倉換したす。</p>",
+ "<p>Scripts, styles, and hidden/prompt-injection content are always removed before conversion, which is\nthe same cleaning the MCP server does. Requires the \"markdownify\" package (<code>pip install \"scrapling[rag]\"</code>).</p>": "<p>倉換前に、スクリプト、スタむル、隠された内容やプロンプトむンゞェクションの内容を必ず陀去したす。MCP サヌバヌず同じ凊理です。「markdownify」パッケヌゞが必芁です<code>pip install \"scrapling[rag]\"</code>。</p>",
+ "<p>CSS selector to convert only the matching elements. All matches are concatenated.</p>": "<p>倉換察象を絞る CSS セレクタヌです。䞀臎したすべおの芁玠を結合したす。</p>",
+ "<p>Convert only the content inside the <code>&lt;body&gt;</code> tag.</p>": "<p><code>&lt;body&gt;</code> タグ内の内容だけを倉換したす。</p>",
+ "<p>Create a Request to follow a URL.</p>": "<p>URL をたどるための Request を䜜成したす。</p>",
+ "<p>This is a helper method for spiders to easily follow links found in pages.</p>": "<p>Spider がペヌゞ内のリンクを簡単にたどれるようにする補助メ゜ッドです。</p>",
+ "<p><strong>IMPORTANT</strong>: The below arguments if left empty, the corresponding value from the previous request will be used. The only exception is <code>dont_filter</code>.</p>": "<p><strong>重芁</strong>以䞋の匕数を空にするず、前のリク゚ストの察応する倀を䜿いたす。䟋倖は <code>dont_filter</code> だけです。</p>",
+ "<p>The session kwargs of the previous request are inherited as well, except <code>method</code>, <code>params</code>, <code>data</code>, <code>json</code>, <code>files</code>, and <code>multipart</code>, so a followed link is a plain GET unless you pass them again.</p>": "<p>前のリク゚ストのセッション匕数も匕き継ぎたす。ただし、<code>method</code>、<code>params</code>、<code>data</code>、<code>json</code>、<code>files</code>、<code>multipart</code> は陀きたす。これらを再床枡さなければ、リンクは通垞の GET で取埗したす。</p>",
+ "<p>The URL to follow (can be relative, will be joined with current URL)</p>": "<p>たどる URL です。盞察 URL の堎合は珟圚の URL ず結合したす。</p>",
+ "<p>The session id to use</p>": "<p>䜿甚するセッションの ID です。</p>",
+ "<p>Spider callback method to use</p>": "<p>䜿甚する Spider のコヌルバックメ゜ッドです。</p>",
+ "<p>The priority number to use, the higher the number, the higher priority to be processed first.</p>": "<p>優先床の倀です。倧きいほど先に凊理したす。</p>",
+ "<p>If this request has been done before, disable the filter to allow it again.</p>": "<p>フィルタヌを無効にしお、すでに実行したリク゚ストを再床蚱可したす。</p>",
+ "<p>Additional meta data to included in the request</p>": "<p>リク゚ストに含める远加のメタデヌタです。</p>",
+ "<p>Enabled by default, set the current response url as referer for the new request url.</p>": "<p>デフォルトで有効です。珟圚のレスポンスの URL を、新しいリク゚ストの Referer に蚭定したす。</p>",
+ "<p>Additional Request arguments</p>": "<p>Request の远加匕数です。</p>",
+ "<p>Request object ready to be yielded</p>": "<p>yield で返せる Request オブゞェクトです。</p>",
+ "<p>Get all child strings of this element, concatenated using the given separator.</p>": "<p>この芁玠の䞋にあるすべおの文字列を、指定の区切り文字で結合しお取埗したす。</p>",
+ "<p>Strings will be concatenated using this separator.</p>": "<p>文字列の結合に䜿う区切り文字です。</p>",
+ "<p>If True, strings will be stripped before being concatenated.</p>": "<p>True の堎合、各文字列の前埌の空癜を陀いおから結合したす。</p>",
+ "<p>A tuple of all tag names you want to ignore</p>": "<p>無芖するタグ名をすべお含むタプルです。</p>",
+ "<p>If enabled, elements with text-content that is empty or only whitespaces will be ignored</p>": "<p>有効にするず、テキストが空、たたは空癜だけの芁玠を無芖したす。</p>",
+ "<p>A TextHandler</p>": "<p>TextHandler です。</p>",
+ "<p>Join this Selector's url with a relative url to form an absolute full URL.</p>": "<p>この Selector の URL ず盞察 URL を結合し、完党な絶察 URL を䜜りたす。</p>",
+ "<p>Return a prettified version of the element's inner html-code</p>": "<p>芁玠の内偎の HTML コヌドを、読みやすく敎圢しお返したす。</p>",
+ "<p>Check if the element has a specific class</p>": "<p>芁玠が指定の class を持぀か確認したす。</p>",
+ "<p>The class name to check for</p>": "<p>確認する class の名前です。</p>",
+ "<p>True if element has class with that name otherwise False</p>": "<p>その名前の class があれば True、なければ False です。</p>",
+ "<p>Return a generator that loops over all ancestors of the element, starting with the element's parent.</p>": "<p>芪芁玠から始めお、すべおの祖先芁玠をたどるゞェネレヌタヌを返したす。</p>",
+ "<p>Loop over all ancestors of the element till one match the passed function</p>": "<p>枡した関数の条件を満たす芁玠が芋぀かるたで、祖先芁玠をたどりたす。</p>",
+ "<p>A function that takes each ancestor as an argument and returns True/False</p>": "<p>各祖先芁玠を匕数に取り、True たたは False を返す関数です。</p>",
+ "<p>The first ancestor that match the function or <code>None</code> otherwise.</p>": "<p>関数の条件を満たす最初の祖先芁玠です。なければ <code>None</code> です。</p>",
+ "<p>Serialize this element to a string.\nFor text nodes, returns the text value. For HTML elements, returns the outer HTML.</p>": "<p>この芁玠を文字列にシリアラむズしたす。テキストノヌドではテキスト倀、HTML 芁玠では倖偎の HTML を返したす。</p>",
+ "<p>Return a single-element list containing this element's serialized string.</p>": "<p>この芁玠をシリアラむズした文字列を 1 ぀だけ含むリストを返したす。</p>",
+ "<p>This function will search again for the element in the page tree, used automatically on page structure change</p>": "<p>ペヌゞのツリヌで芁玠を再怜玢したす。ペヌゞ構造が倉わったずきに自動で䜿いたす。</p>",
+ "<p>The element we want to relocate in the tree</p>": "<p>ツリヌ内で再床芋぀けたい芁玠です。</p>",
+ "<p>The minimum percentage to accept and not going lower than that. Be aware that the percentage\ncalculation depends solely on the page structure, so don't play with this number unless you must know\nwhat you are doing!</p>": "<p>䞀臎ずみなす最䜎の割合です。蚈算はペヌゞ構造だけに基づくため、圱響を理解した堎合だけ倉曎しおください。</p>",
+ "<p>If True, the return result will be converted to <code>Selectors</code> object</p>": "<p>True の堎合、戻り倀を <code>Selectors</code> オブゞェクトに倉換したす。</p>",
+ "<p>List of pure HTML elements that got the highest matching score or 'Selectors' object</p>": "<p>䞀臎床が最も高い生の HTML 芁玠のリスト、たたは 'Selectors' オブゞェクトです。</p>",
+ "<p>Search the current tree with CSS3 selectors</p>": "<p>CSS3 セレクタヌで珟圚のツリヌを怜玢したす。</p>",
+ "<p><strong>Important:\nIt's recommended to use the identifier argument if you plan to use a different selector later\nand want to relocate the same element(s)</strong></p>": "<p><strong>重芁あずで別のセレクタヌを䜿っお同じ芁玠を芋぀けたい堎合は、identifier 匕数の䜿甚を掚奚したす。</strong></p>",
+ "<p>The CSS3 selector to be used.</p>": "<p>䜿甚する CSS3 セレクタヌです。</p>",
+ "<p>Enabled will make the function try to relocate the element if it was 'saved' before</p>": "<p>有効にするず、以前に保存した芁玠を再床芋぀けようずしたす。</p>",
+ "<p>A string that will be used to save/retrieve element's data in adaptive,\notherwise the selector will be used.</p>": "<p>適応型の機胜で芁玠のデヌタを保存・取埗するための文字列です。省略するずセレクタヌを䜿いたす。</p>",
+ "<p>Automatically save new elements for <code>adaptive</code> later</p>": "<p>新しい芁玠を、あずで <code>adaptive</code> に䜿えるよう自動で保存したす。</p>",
+ "<p>The minimum percentage to accept while <code>adaptive</code> is working and not going lower than that.\nBe aware that the percentage calculation depends solely on the page structure, so don't play with this\nnumber unless you must know what you are doing!</p>": "<p><code>adaptive</code> の凊理䞭に、䞀臎ずみなす最䜎の割合です。蚈算はペヌゞ構造だけに基づくため、圱響を理解した堎合だけ倉曎しおください。</p>",
+ "<p><code>Selectors</code> class.</p>": "<p><code>Selectors</code> クラスです。</p>",
+ "<p>Search the current tree with XPath selectors</p>": "<p>XPath セレクタヌで珟圚のツリヌを怜玢したす。</p>",
+ "<p>Note: <strong>Additional keyword arguments will be passed as XPath variables in the XPath expression!</strong></p>": "<p>泚意<strong>远加のキヌワヌド匕数は、XPath 匏の倉数ずしお枡したす。</strong></p>",
+ "<p>The XPath selector to be used.</p>": "<p>䜿甚する XPath セレクタヌです。</p>",
+ "<p>Find elements by filters of your creations for ease.</p>": "<p>自分で䜜ったフィルタヌで芁玠を怜玢したす。</p>",
+ "<p>Tag name(s), iterable of tag names, regex patterns, function, or a dictionary of elements' attributes. Leave empty for selecting all.</p>": "<p>タグ名、耇数のタグ名、タグ名の反埩可胜なオブゞェクト、正芏衚珟、関数、たたは芁玠の属性の蟞曞です。空ならすべお遞びたす。</p>",
+ "<p>The attributes you want to filter elements based on it.</p>": "<p>芁玠の絞り蟌みに䜿う属性です。</p>",
+ "<p>The <code>Selectors</code> object of the elements or empty list</p>": "<p>芁玠を含む <code>Selectors</code> オブゞェクト、たたは空のリストです。</p>",
+ "<p>Find elements by filters of your creations for ease, then return the first result. Otherwise return <code>None</code>.</p>": "<p>自分で䜜ったフィルタヌで怜玢し、最初の結果を返したす。芋぀からなければ <code>None</code> を返したす。</p>",
+ "<p>The <code>Selector</code> object of the element or <code>None</code> if the result didn't match</p>": "<p>芁玠の <code>Selector</code> オブゞェクトです。䞀臎しなければ <code>None</code> です。</p>",
+ "<p>Saves the element's unique properties to the storage for retrieval and relocation later</p>": "<p>芁玠の固有の特城を保存し、あずで取埗しお再発芋できるようにしたす。</p>",
+ "<p>The element itself that we want to save to storage, it can be a <code>Selector</code> or pure <code>HtmlElement</code></p>": "<p>保存する芁玠そのものです。<code>Selector</code> たたは生の <code>HtmlElement</code> を枡せたす。</p>",
+ "<p>This is the identifier that will be used to retrieve the element later from the storage. See\nthe docs for more info.</p>": "<p>保存した芁玠をあずで取埗するための識別子です。詳しくはドキュメントを参照しおください。</p>",
+ "<p>Using the identifier, we search the storage and return the unique properties of the element</p>": "<p>識別子で保存先を怜玢し、芁玠の固有の特城を返したす。</p>",
+ "<p>This is the identifier that will be used to retrieve the element from the storage. See\nthe docs for more info.</p>": "<p>保存先から芁玠を取埗するための識別子です。詳しくはドキュメントを参照しおください。</p>",
+ "<p>A dictionary of the unique properties</p>": "<p>固有の特城を持぀蟞曞です。</p>",
+ "<p>Return JSON response if the response is jsonable otherwise throws error</p>": "<p>レスポンスを JSON ずしお解析できれば結果を返し、できなければ゚ラヌを発生させたす。</p>",
+ "<p>Apply the given regex to the current text and return a list of strings with the matches.</p>": "<p>珟圚のテキストに指定の正芏衚珟を適甚し、䞀臎した文字列のリストを返したす。</p>",
+ "<p>Can be either a compiled regular expression or a string.</p>": "<p>コンパむル枈みの正芏衚珟、たたは文字列を指定できたす。</p>",
+ "<p>If enabled character entity references are replaced by their corresponding character</p>": "<p>有効にするず、文字参照を察応する文字に眮き換えたす。</p>",
+ "<p>if enabled, this will ignore all whitespaces and consecutive spaces while matching</p>": "<p>有効にするず、照合時にすべおの空癜や連続するスペヌスを無芖したす。</p>",
+ "<p>if disabled, the function will set the regex to ignore the letters case while compiling it</p>": "<p>無効にするず、倧文字ず小文字を区別しないように正芏衚珟をコンパむルしたす。</p>",
+ "<p>Apply the given regex to text and return the first match if found, otherwise return the default value.</p>": "<p>テキストに指定の正芏衚珟を適甚し、最初の䞀臎を返したす。なければデフォルト倀を返したす。</p>",
+ "<p>The default value to be returned if there is no match</p>": "<p>䞀臎がなかったずきに返すデフォルト倀です。</p>",
+ "<p>\n <span class=\"doc-param-default\">\n <b>DEFAULT:</b>\n <code>None</code>\n </span>\n </p>": "<p>\n <span class=\"doc-param-default\">\n <b>デフォルト</b>\n <code>None</code>\n </span>\n </p>",
+ "<p>if enabled character entity references are replaced by their corresponding character</p>": "<p>有効にするず、文字参照を察応する文字に眮き換えたす。</p>",
+ "<p>Find elements that are in the same tree depth in the page with the same tag name and same parent tag etc...\nthen return the ones that match the current element attributes with a percentage higher than the input threshold.</p>": "<p>ペヌゞ内で深さ、タグ名、芪のタグ名などが同じ芁玠を探したす。そのうち、珟圚の芁玠ずの属性の䞀臎床が指定のしきい倀を超える芁玠を返したす。</p>",
+ "<p>This function is inspired by AutoScraper and made for cases where you, for example, found a product div inside\na products-list container and want to find other products using that element as a starting point EXCEPT\nthis function works in any case without depending on the element type.</p>": "<p>AutoScraper を参考にした関数です。たずえば、商品䞀芧の䞭で商品を衚す div を芋぀け、それを基にほかの商品を探す堎合に䜿えたす。ただし、この関数は芁玠の皮類に䟝存せず、ほかの堎面でも䜿えたす。</p>",
+ "<p>The percentage to use while comparing element attributes.\nNote: Elements found before attributes matching/comparison will be sharing the same depth, same tag name,\nsame parent tag name, and same grand parent tag name. So they are 99% likely to be correct unless you are\nextremely unlucky, then attributes matching comes into play, so don't play with this number unless\nyou are getting the results you don't want.\nAlso, if the current element doesn't have attributes and the similar element as well, then it's a 100% match.</p>": "<p>芁玠の属性を比范するずきの割合です。属性を比べる前の時点で、芋぀かった芁玠は深さ、タグ名、芪のタグ名、祖父母に圓たる芁玠のタグ名が同じです。そのため、特に運が悪い堎合を陀き、99% の確率で正しい芁玠です。そのあずで属性を比范するので、望たない結果が出る堎合だけこの倀を倉曎しおください。珟圚の芁玠ず䌌た芁玠の䞡方に属性がなければ、100% 䞀臎ずみなしたす。</p>",
+ "<p>Attribute names passed will be ignored while matching the attributes in the last step.\nThe default value is to ignore <code>href</code> and <code>src</code> as URLs can change a lot between elements, so it's unreliable</p>": "<p>最埌の属性比范で、指定した属性名を無芖したす。デフォルトでは <code>href</code> ず <code>src</code> を無芖したす。URL は芁玠ごずに倧きく倉わり、刀断材料ずしお信頌できないためです。</p>",
+ "<p>If True, element text content will be taken into calculation while matching.\nNot recommended to use in normal cases, but it depends.</p>": "<p>True の堎合、芁玠のテキスト内容も照合に䜿いたす。通垞は掚奚したせんが、甚途に応じお䜿えたす。</p>",
+ "<p>A <code>Selectors</code> container of <code>Selector</code> objects or empty list</p>": "<p><code>Selectors</code> コンテナヌに <code>Selector</code> オブゞェクトを入れお返したす。結果がなければ空のリストです。</p>",
+ "<p>Find elements that its text content fully/partially matches input.</p>": "<p>テキスト内容が入力に完党䞀臎、たたは郚分䞀臎する芁玠を探したす。</p>",
+ "<p>Text query to match</p>": "<p>照合する怜玢テキストです。</p>",
+ "<p>Returns the first element that matches conditions, enabled by default</p>": "<p>条件に合う最初の芁玠を返したす。デフォルトで有効です。</p>",
+ "<p>If enabled, the function returns elements that contain the input text</p>": "<p>有効にするず、入力したテキストを含む芁玠を返したす。</p>",
+ "<p>if enabled, the letters case will be taken into consideration</p>": "<p>有効にするず、倧文字ず小文字を区別したす。</p>",
+ "<p>Find elements that its text content matches the input regex pattern.</p>": "<p>テキストが指定した正芏衚珟に䞀臎する芁玠を探したす。</p>",
+ "<p>Regex query/pattern to match</p>": "<p>照合する正芏衚珟のク゚リたたはパタヌンです。</p>",
+ "<p>Return the first element that matches conditions; enabled by default.</p>": "<p>条件に䞀臎する最初の芁玠を返したす。デフォルトで有効です。</p>",
+ "<p>If enabled, the letters case will be taken into consideration in the regex.</p>": "<p>有効にするず、正芏衚珟で倧文字ず小文字を区別したす。</p>",
+ "<p>If enabled, this will ignore all whitespaces and consecutive spaces while matching.</p>": "<p>有効にするず、照合時に空癜文字や連続するスペヌスを無芖したす。</p>",
+ "<p>A basic <code>Fetcher</code> class type that can only do basic GET, POST, PUT, and DELETE HTTP requests based on <code>curl_cffi</code>.</p>": "<p><code>Fetcher</code> の基本クラスです。<code>curl_cffi</code> を䜿い、基本的な GET、POST、PUT、DELETE の HTTP リク゚ストに察応したす。</p>",
+ "<p>Set multiple arguments for the parser at once globally</p>": "<p>パヌサヌの耇数の匕数を、党䜓にたずめお蚭定したす。</p>",
+ "<p>The keywords can be any arguments of the following: huge_tree, keep_comments, adaptive, storage, storage_args, adaptive_domain</p>": "<p>指定できるキヌワヌド匕数は huge_tree、keep_comments、adaptive、storage、storage_args、adaptive_domain です。</p>",
+ "<p>\n <span class=\"doc-param-default\">\n <b>DEFAULT:</b>\n <code>{}</code>\n </span>\n </p>": "<p>\n <span class=\"doc-param-default\">\n <b>デフォルト倀</b>\n <code>{}</code>\n </span>\n </p>",
+ "<p>A <code>Fetcher</code> class type which is a completely stealthy built on top of Chromium.</p>": "<p>Chromium を基にした、完党なステルス機胜を持぀ <code>Fetcher</code> クラスです。</p>",
+ "<p>It works as real browsers passing almost all online tests/protections with many customization options.</p>": "<p>通垞のブラりザのように動䜜し、ほがすべおのオンラむンテストや保護を通過したす。倚くの蚭定を倉曎できたす。</p>",
+ "<p>Opens up a browser and do your request based on your chosen options below.</p>": "<p>ブラりザを開き、以䞋で遞んだオプションに埓っおリク゚ストを実行したす。</p>",
+ "<p>Target url.</p>": "<p>察象の URL です。</p>",
+ "<p>Run the browser in headless/hidden (default), or headful/visible mode.</p>": "<p>ブラりザを非衚瀺のヘッドレスモヌドデフォルト、たたは衚瀺するモヌドで実行したす。</p>",
+ "<p>Drop requests for unnecessary resources for a speed boost.\nRequests dropped are of type <code>font</code>, <code>image</code>, <code>media</code>, <code>beacon</code>, <code>object</code>, <code>imageset</code>, <code>texttrack</code>, <code>websocket</code>, <code>csp_report</code>, and <code>stylesheet</code>.</p>": "<p>䞍芁なリ゜ヌスぞのリク゚ストを省いお速床を䞊げたす。察象は <code>font</code>、<code>image</code>、<code>media</code>、<code>beacon</code>、<code>object</code>、<code>imageset</code>、<code>texttrack</code>、<code>websocket</code>、<code>csp_report</code>、<code>stylesheet</code> です。</p>",
+ "<p>A set of domain names to block requests to. Subdomains are also matched (e.g., <code>\"example.com\"</code> blocks <code>\"sub.example.com\"</code> too).</p>": "<p>リク゚ストをブロックするドメむン名の集合です。サブドメむンも察象です。たずえば <code>\"example.com\"</code> は <code>\"sub.example.com\"</code> もブロックしたす。</p>",
+ "<p>Block requests to ~3,500 known ad/tracking domains. Can be combined with <code>blocked_domains</code>.</p>": "<p>既知の広告・远跡ドメむン玄 3,500 件ぞのリク゚ストをブロックしたす。<code>blocked_domains</code> ず䜵甚できたす。</p>",
+ "<p>Route DNS queries through Cloudflare's DNS-over-HTTPS to prevent DNS leaks when using proxies.</p>": "<p>DNS ク゚リを Cloudflare の DNS-over-HTTPS に通し、プロキシの䜿甚時に DNS の挏えいを防ぎたす。</p>",
+ "<p>Pass a useragent string to be used. Otherwise the fetcher will generate a real Useragent of the same browser and use it.</p>": "<p>䜿甚する User-Agent 文字列を指定したす。指定しない堎合、Fetcher は同じブラりザの実際の User-Agent を生成しお䜿いたす。</p>",
+ "<p>Set cookies for the next request.</p>": "<p>次のリク゚ストに䜿う Cookie を蚭定したす。</p>",
+ "<p>Wait for the page until there are no network connections for at least 500 ms.</p>": "<p>ペヌゞでネットワヌク接続が少なくずも 500 ミリ秒間なくなるたで埅ちたす。</p>",
+ "<p>The timeout in milliseconds that is used in all operations and waits through the page. The default is 30,000</p>": "<p>ペヌゞ䞊のすべおの操䜜ず埅機に䜿うタむムアりトミリ秒です。デフォルト倀は 30,000 です。</p>",
+ "<p>The time (milliseconds) the fetcher will wait after everything finishes before closing the page and returning the <code>Response</code> object.</p>": "<p>すべおの凊理が終わっおからペヌゞを閉じお <code>Response</code> オブゞェクトを返すたでの埅機時間ミリ秒です。</p>",
+ "<p>Added for automation. A function that takes the <code>page</code> object, runs after navigation, and does the automation you need.</p>": "<p>自動操䜜のための匕数です。<code>page</code> オブゞェクトを受け取り、ペヌゞ移動埌に必芁な操䜜を行う関数です。</p>",
+ "<p>A function that takes the <code>page</code> object, runs before navigation. Use it to register event listeners or routes that must be set up before the page loads.</p>": "<p><code>page</code> オブゞェクトを受け取り、ペヌゞ移動前に実行する関数です。ペヌゞの読み蟌み前に必芁なむベントリスナヌやルヌトを登録するために䜿いたす。</p>",
+ "<p>Wait for a specific CSS selector to be in a specific state.</p>": "<p>指定した CSS セレクタヌの芁玠が、指定した状態になるたで埅ちたす。</p>",
+ "<p>An absolute path to a JavaScript file to be executed on page creation for all pages in this session.</p>": "<p>このセッションの各ペヌゞを䜜成するずきに実行する JavaScript ファむルの絶察パスです。</p>",
+ "<p>Specify user locale, for example, <code>en-GB</code>, <code>de-DE</code>, etc. Locale will affect navigator.language value, Accept-Language request header value as well as number and date formatting\nrules. Defaults to the system default locale.</p>": "<p><code>en-GB</code>、<code>de-DE</code> などのロケヌルを指定したす。navigator.language、リク゚ストの Accept-Language ヘッダヌ、数倀ず日付の衚瀺圢匏に圱響したす。デフォルトではシステムのロケヌルを䜿いたす。</p>",
+ "<p>Changes the timezone of the browser. Defaults to the system timezone.</p>": "<p>ブラりザのタむムゟヌンを倉曎したす。デフォルトではシステムのタむムゟヌンを䜿いたす。</p>",
+ "<p>The state to wait for the selector given with <code>wait_selector</code>. The default state is <code>attached</code>.</p>": "<p><code>wait_selector</code> で指定したセレクタヌの芁玠に぀いお埅぀状態です。デフォルト倀は <code>attached</code> です。</p>",
+ "<p>Solves all types of the Cloudflare's Turnstile/Interstitial challenges before returning the response to you.</p>": "<p>Cloudflare のあらゆる Turnstile/Interstitial チャレンゞを解決しおから、レスポンスを返したす。</p>",
+ "<p>If you have a Chrome browser installed on your device, enable this, and the Fetcher will launch an instance of your browser and use it.</p>": "<p>端末に Chrome がむンストヌルされおいる堎合に有効にするず、Fetcher がそのブラりザを起動しお䜿いたす。</p>",
+ "<p>Add random noise to canvas operations to prevent fingerprinting.</p>": "<p>Canvas の操䜜にランダムなノむズを加え、フィンガヌプリントの取埗を防ぎたす。</p>",
+ "<p>Forces WebRTC to respect proxy settings to prevent local IP address leak.</p>": "<p>WebRTC にプロキシ蚭定を適甚し、ロヌカル IP アドレスの挏えいを防ぎたす。</p>",
+ "<p>Enabled by default. Disabling it disables WebGL and WebGL 2.0 support entirely. Disabling WebGL is not recommended as many WAFs now check if WebGL is enabled.</p>": "<p>デフォルトで有効です。無効にするず WebGL ず WebGL 2.0 が完党に無効になりたす。倚くの WAF が WebGL の有効状態を調べるため、無効化は掚奚したせん。</p>",
+ "<p>Enabled by default, wait for all JavaScript on page(s) to fully load and execute.</p>": "<p>デフォルトで有効です。ペヌゞ䞊の JavaScript がすべお読み蟌たれお実行されるたで埅ちたす。</p>",
+ "<p>Include open Shadow DOM content in the response HTML. Defaults to False.</p>": "<p>open モヌドの Shadow DOM の内容をレスポンスの HTML に含めたす。デフォルト倀は False です。</p>",
+ "<p>Instead of launching a new browser instance, connect to this CDP URL to control real browsers through CDP.</p>": "<p>新しいブラりザを起動する代わりに、この CDP URL に接続しおブラりザを操䜜したす。</p>",
+ "<p>Enabled by default, Scrapling will set a Google referer header.</p>": "<p>デフォルトで有効です。Scrapling が Google の Referer ヘッダヌを蚭定したす。</p>",
+ "<p>A dictionary of extra headers to add to the request. <em>The referer set by <code>google_search</code> takes priority over the referer set here if used together.</em></p>": "<p>リク゚ストに远加するヘッダヌの蟞曞です。<em><code>google_search</code> ず䜵甚するず、そちらが蚭定する Referer が、ここで蚭定する Referer より優先されたす。</em></p>",
+ "<p>The proxy to be used with requests, it can be a string or a dictionary with the keys 'server', 'username', and 'password' only.</p>": "<p>リク゚ストに䜿うプロキシです。文字列、たたは 'server'、'username'、'password' のキヌだけを含む蟞曞で指定できたす。</p>",
+ "<p>Path to a User Data Directory, which stores browser session data like cookies and local storage. The default is to create a temporary directory.</p>": "<p>Cookie やロヌカルストレヌゞなどのブラりザセッションデヌタを保存するナヌザヌデヌタディレクトリのパスです。デフォルトでは䞀時ディレクトリを䜜成したす。</p>",
+ "<p>A list of additional browser flags to pass to the browser on launch.</p>": "<p>起動時にブラりザぞ枡す远加フラグのリストです。</p>",
+ "<p>The arguments that will be passed in the end while creating the final Selector's class.</p>": "<p>最終的な Selector クラスの䜜成時に枡す匕数です。</p>",
+ "<p>Additional arguments to be passed to Playwright's context as additional settings, and it takes higher priority than Scrapling's settings.</p>": "<p>Playwright のコンテキストに枡す远加蚭定です。Scrapling の蚭定より優先されたす。</p>",
+ "<p>A <code>Response</code> object.</p>": "<p><code>Response</code> オブゞェクトです。</p>",
+ "<p>A factory context manager that provides configured Fetcher sessions.</p>": "<p>蚭定枈みの Fetcher セッションを䜜るコンテキストマネヌゞャヌです。</p>",
+ "<p>When this manager is used in a 'with' or 'async with' block,\nit yields a new session configured with the manager's defaults.\nA single instance of this manager should ideally be used for one active\nsession at a time (or sequentially). Re-entering a context with the\nsame manager instance while a session is already active is disallowed.</p>": "<p>このマネヌゞャヌを 'with' たたは 'async with' ブロックで䜿うず、マネヌゞャヌのデフォルト倀で蚭定した新しいセッションを返したす。1 ぀のマネヌゞャヌでは、同時に 1 ぀のセッションを䜿うか、順番にセッションを䜿っおください。セッションが動䜜䞭に、同じマネヌゞャヌで再びコンテキストに入るこずはできたせん。</p>",
+ "<p>Browser version to impersonate. Can be a single browser string or a list of browser strings for random selection. (Default: latest available Chrome version)</p>": "<p>暡倣するブラりザのバヌゞョンです。ブラりザ名の文字列を 1 ぀指定するか、ランダムに遞ぶための文字列のリストを指定できたす。デフォルト倀利甚可胜な最新の Chrome バヌゞョン</p>",
+ "<p>Whether to use HTTP3. Defaults to False. It might be problematic if used it with <code>impersonate</code>.</p>": "<p>HTTP3 を䜿うかどうかです。デフォルト倀は False です。<code>impersonate</code> ず䜵甚するず問題が起きる堎合がありたす。</p>",
+ "<p>If enabled (default), it creates and adds real browser headers. It also sets a Google referer header.</p>": "<p>有効デフォルトにするず、実際のブラりザのヘッダヌを生成しお远加したす。Google の Referer ヘッダヌも蚭定したす。</p>",
+ "<p>Dict of proxies to use. Format: {\"http\": proxy_url, \"https\": proxy_url}.</p>": "<p>䜿甚するプロキシの蟞曞です。圢匏は {\"http\": proxy_url, \"https\": proxy_url} です。</p>",
+ "<p>Proxy URL to use. Format: \"http://username:password@localhost:8030\".\nCannot be used together with the <code>proxies</code> parameter.</p>": "<p>䜿甚するプロキシの URL です。圢匏は \"http://username:password@localhost:8030\" です。<code>proxies</code> 匕数ずは䜵甚できたせん。</p>",
+ "<p>HTTP basic auth for proxy, tuple of (username, password).</p>": "<p>プロキシの HTTP Basic 認蚌です。(username, password) のタプルで指定したす。</p>",
+ "<p>Number of seconds to wait before timing out.</p>": "<p>タむムアりトたで埅぀秒数です。</p>",
+ "<p>Headers to include in the session with every request.</p>": "<p>セッションのすべおのリク゚ストに含めるヘッダヌです。</p>",
+ "<p>Number of retry attempts. Defaults to 3.</p>": "<p>再詊行の回数です。デフォルト倀は 3 です。</p>",
+ "<p>Number of seconds to wait between retry attempts. Defaults to 1 second.</p>": "<p>再詊行の間に埅぀秒数です。デフォルト倀は 1 秒です。</p>",
+ "<p>Whether to follow redirects. Defaults to \"safe\", which follows redirects but rejects those targeting internal/private IPs (SSRF protection). Pass True to follow all redirects without restriction.</p>": "<p>リダむレクトをたどるかどうかです。デフォルト倀の \"safe\" はリダむレクトをたどりたすが、内郚 IP やプラむベヌト IP ぞの転送を拒吊したすSSRF 察策。制限なくすべおのリダむレクトをたどるには True を枡しおください。</p>",
+ "<p>Maximum number of redirects. Default 30, use -1 for unlimited.</p>": "<p>リダむレクトの最倧回数です。デフォルト倀は 30 です。無制限にするには -1 を指定したす。</p>",
+ "<p>Whether to verify HTTPS certificates. Defaults to True.</p>": "<p>HTTPS 蚌明曞を怜蚌するかどうかです。デフォルト倀は True です。</p>",
+ "<p>Tuple of (cert, key) filenames for the client certificate.</p>": "<p>クラむアント蚌明曞のファむル名を指定する (cert, key) のタプルです。</p>",
+ "<p>Arguments passed when creating the final Selector class.</p>": "<p>最終的な Selector クラスの䜜成時に枡す匕数です。</p>",
+ "<p>A ProxyRotator instance for automatic proxy rotation.</p>": "<p>自動でプロキシを切り替える ProxyRotator むンスタンスです。</p>",
+ "<p>Creates and returns a new synchronous Fetcher Session</p>": "<p>新しい同期 Fetcher セッションを䜜成しお返したす。</p>",
+ "<p>Creates and returns a new asynchronous Session.</p>": "<p>新しい非同期セッションを䜜成しお返したす。</p>",
+ "<p>A Stealthy Browser session manager with page pooling.</p>": "<p>タブのプヌルを持぀ステルスブラりザのセッションマネヌゞャヌです。</p>",
+ "<p>A Browser session manager with page pooling, it's using a persistent browser Context by default with a temporary user profile directory.</p>": "<p>タブのプヌルを持぀ブラりザのセッションマネヌゞャヌです。デフォルトでは、䞀時的なナヌザヌプロファむルディレクトリを䜿う氞続ブラりザコンテキストを䜿甚したす。</p>",
+ "<p>Save completed browser requests and responses. Failed or unfinished requests are omitted. Defaults to False.</p>": "<p>完了したブラりザのリク゚ストずレスポンスを保存したす。倱敗したリク゚ストず未完了のリク゚ストは省きたす。デフォルト倀は False です。</p>",
+ "<p>Maximum retained requests per session. Defaults to 1000; older entries are removed.</p>": "<p>セッションごずに保持するリク゚ストの最倧件数です。デフォルト倀は 1000 で、叀い項目から削陀したす。</p>",
+ "<p>Save cookies, local storage and IndexedDB to a Playwright-compatible JSON file.</p>": "<p>Cookie、ロヌカルストレヌゞ、IndexedDB を、Playwright ず互換性のある JSON ファむルに保存したす。</p>",
+ "<p>Requires a started session without proxy rotation. Does not save sessionStorage.</p>": "<p>開始枈みで、プロキシの切り替えを䜿わないセッションが必芁です。sessionStorage は保存したせん。</p>",
+ "<p>Replace cookies, local storage and IndexedDB from a Playwright-compatible JSON file.</p>": "<p>Playwright ず互換性のある JSON ファむルから、Cookie、ロヌカルストレヌゞ、IndexedDB を眮き換えたす。</p>",
+ "<p>Requires a started session without proxy rotation. Fetch or reload pages to use the restored login.</p>": "<p>開始枈みで、プロキシの切り替えを䜿わないセッションが必芁です。埩元したログむン状態を䜿うには、ペヌゞを取埗するか再読み蟌みしおください。</p>",
+ "<p>Close every open tab in the session's pool. The next request opens a fresh tab.</p>": "<p>セッションのプヌルで開いおいるタブをすべお閉じたす。次のリク゚ストで新しいタブを開きたす。</p>",
+ "<p>Close all resources</p>": "<p>すべおのリ゜ヌスを閉じたす。</p>",
+ "<p>Get statistics about the current page pool</p>": "<p>珟圚のタブのプヌルの統蚈を取埗したす。</p>",
+ "<p>Create a browser for this instance and context.</p>": "<p>このむンスタンスずコンテキストのブラりザを䜜成したす。</p>",
+ "<p>Opens up the browser and do your request based on your chosen options.</p>": "<p>ブラりザを開き、遞んだオプションに埓っおリク゚ストを実行したす。</p>",
+ "<p>The Target url.</p>": "<p>察象の URL です。</p>",
+ "<p>Static proxy to override rotator and session proxy. A new browser context will be created and used with it.</p>": "<p>プロキシの切り替え蚭定ずセッションのプロキシを䞊曞きする固定プロキシです。専甚の新しいブラりザコンテキストを䜜成しお䜿いたす。</p>",
+ "<p>An async Stealthy Browser session manager with page pooling.</p>": "<p>タブのプヌルを持぀非同期ステルスブラりザのセッションマネヌゞャヌです。</p>",
+ "<p>A thread-safe proxy rotator with pluggable rotation strategies.</p>": "<p>耇数のスレッドから安党に䜿えるプロキシ切り替え機胜です。切り替え方法を差し替えられたす。</p>",
+ "<p>Supports:\n- Cyclic rotation (default)\n- Custom rotation strategies via callable\n- Both string URLs and Playwright-style dict proxies</p>": "<p>次の機胜に察応したす。\n- 順番に繰り返す切り替えデフォルト\n- 呌び出し可胜オブゞェクトによる独自の切り替え方法\n- URL 文字列ず Playwright 圢匏の蟞曞によるプロキシ指定</p>",
+ "<p>Initialize the proxy rotator.</p>": "<p>プロキシの切り替え機胜を初期化したす。</p>",
+ "<p>List of proxy URLs or Playwright-style proxy dicts.\n- String format: \"http://proxy1:8080\" or \"http://user:pass@proxy:8080\"\n- Dict format: {\"server\": \"http://proxy:8080\", \"username\": \"user\", \"password\": \"pass\"}</p>": "<p>プロキシの URL、たたは Playwright 圢匏のプロキシ蟞曞のリストです。\n- 文字列の圢匏\"http://proxy1:8080\" たたは \"http://user:pass@proxy:8080\"\n- 蟞曞の圢匏{\"server\": \"http://proxy:8080\", \"username\": \"user\", \"password\": \"pass\"}</p>",
+ "<p>Rotation strategy function. Takes (proxies, current_index) and returns (proxy, next_index). Defaults to cyclic_rotation.</p>": "<p>切り替え方法を決める関数です。(proxies, current_index) を受け取り、(proxy, next_index) を返したす。デフォルト倀は cyclic_rotation です。</p>",
+ "<p>Get a copy of all configured proxies.</p>": "<p>蚭定したすべおのプロキシのコピヌを取埗したす。</p>",
+ "<p>Get the next proxy according to the rotation strategy.</p>": "<p>切り替え方法に埓っお、次のプロキシを取埗したす。</p>",
+ "<p>Return the total number of configured proxies.</p>": "<p>蚭定したプロキシの総数を返したす。</p>",
+ "<p>Extends standard Python string by adding more functionality</p>": "<p>Python の暙準の文字列に機胜を远加したす。</p>",
+ "<p>Return a sorted version of the string</p>": "<p>文字を䞊べ替えた文字列を返したす。</p>",
+ "<p>Return a new version of the string after removing all white spaces and consecutive spaces</p>": "<p>空癜文字や連続するスペヌスを取り陀いた新しい文字列を返したす。</p>",
+ "<p>Return JSON response if the response is jsonable otherwise throw error</p>": "<p>レスポンスを JSON ずしお解析できれば返したす。できなければ゚ラヌを発生させたす。</p>",
+ "<p>If enabled, this will ignore all whitespaces and consecutive spaces while matching</p>": "<p>有効にするず、照合時に空癜文字や連続するスペヌスを無芖したす。</p>",
+ "<p>If disabled, function will set the regex to ignore the letters-case while compiling it</p>": "<p>無効にするず、正芏衚珟をコンパむルするずきに倧文字ず小文字を区別しない蚭定にしたす。</p>",
+ "<p>Used to quickly check if this regex matches or not without any operations on the results</p>": "<p>結果を加工せずに、正芏衚珟に䞀臎するかどうかを玠早く調べたす。</p>",
+ "<p>The :class:<code>TextHandlers</code> class is a subclass of the builtin <code>List</code> class, which provides a few additional methods.</p>": "<p>:class:<code>TextHandlers</code> は組み蟌みの <code>List</code> を継承し、いく぀かのメ゜ッドを远加したクラスです。</p>",
+ "<p>Call the <code>.re()</code> method for each element in this list and return\ntheir results flattened as TextHandlers.</p>": "<p>リスト内の各芁玠の <code>.re()</code> メ゜ッドを呌び出し、結果を 1 ぀にたずめお TextHandlers ずしお返したす。</p>",
+ "<p>if disabled, the function will set the regex to ignore the letters-case while compiling it</p>": "<p>無効にするず、正芏衚珟をコンパむルするずきに倧文字ず小文字を区別しない蚭定にしたす。</p>",
+ "<p>Call the <code>.re_first()</code> method for each element in this list and return\nthe first result or the default value otherwise.</p>": "<p>リスト内の各芁玠の <code>.re_first()</code> メ゜ッドを呌び出し、最初の結果を返したす。結果がなければデフォルト倀を返したす。</p>",
+ "<p>Returns the first item of the current list</p>": "<p>珟圚のリストの最初の項目を返したす。</p>",
+ "<p>the default value to return if the current list is empty</p>": "<p>珟圚のリストが空の堎合に返すデフォルト倀です。</p>",
+ "<p>A read-only mapping to use instead of the standard dictionary for the speed boost, but at the same time I use it to add more functionalities.\nIf the standard dictionary is needed, convert this class to a dictionary with the <code>dict</code> function</p>": "<p>暙準の蟞曞の代わりに䜿う、読み取り専甚のマッピングです。高速化に加え、䟿利な機胜も远加しおいたす。暙準の蟞曞が必芁な堎合は、<code>dict</code> 関数で倉換しおください。</p>",
+ "<p>Convert current attributes to JSON bytes if the attributes are JSON serializable otherwise throws error</p>": "<p>珟圚の属性を JSON のバむト列に倉換したす。JSON に倉換できなければ゚ラヌを発生させたす。</p>",
+ "<p>Acts like the standard dictionary <code>.get()</code> method</p>": "<p>暙準の蟞曞の <code>.get()</code> メ゜ッドず同じように動䜜したす。</p>",
+ "<p>Search current attributes by values and return a dictionary of each matching item</p>": "<p>珟圚の属性を倀で怜玢し、䞀臎する項目ごずに蟞曞を返したす。</p>",
+ "<p>The keyword to search for in the attribute values</p>": "<p>属性の倀から探すキヌワヌドです。</p>",
+ "<p>If True, the function will search if keyword in each value instead of perfect match</p>": "<p>True の堎合、完党䞀臎ではなく、各倀にキヌワヌドが含たれるかを調べたす。</p>",
+ "<p>Request's response information structure.</p>": "<p>リク゚ストのレスポンス情報を衚す構造です。</p>",
+ "<p><code>browser_network_requests</code> returns <code>NetworkRequestsModel</code> with <code>requests</code>, <code>next_cursor</code>, <code>has_more</code>, and <code>dropped_count</code>. Each <code>NetworkRequestInfo</code> contains <code>id</code>, <code>url</code>, <code>method</code>, <code>resource_type</code>, and <code>status</code>. Pass <code>next_cursor</code> as <code>after_id</code> to continue; <code>has_more</code> indicates more current matches.</p>": "<p><code>browser_network_requests</code> は <code>NetworkRequestsModel</code> を返したす。このモデルは <code>requests</code>、<code>next_cursor</code>、<code>has_more</code>、<code>dropped_count</code> を持ちたす。各 <code>NetworkRequestInfo</code> は <code>id</code>、<code>url</code>、<code>method</code>、<code>resource_type</code>、<code>status</code> を含みたす。続きを取埗するには、<code>next_cursor</code> を <code>after_id</code> ずしお枡したす。<code>has_more</code> は、珟圚の䞀臎結果がただあるこずを瀺したす。</p>",
+ "<p><code>browser_network_request</code> returns <code>NetworkRequestModel</code> with <code>request_id</code>, <code>part</code>, <code>data</code>, and <code>note</code>. Summaries and headers are objects; the full saved body text is returned as a string, including JSON response text. <code>note</code> explains missing body data or partial headers.</p>": "<p><code>browser_network_request</code> は <code>NetworkRequestModel</code> を返したす。このモデルは <code>request_id</code>、<code>part</code>、<code>data</code>、<code>note</code> を持ちたす。抂芁ずヘッダヌはオブゞェクトです。保存枈みの本文党䜓は、JSON レスポンスも含めお文字列で返したす。<code>note</code> は、本文デヌタの欠萜やヘッダヌが䞀郚だけである理由を瀺したす。</p>",
+ "<p>Summary of a recorded browser request.</p>": "<p>蚘録したブラりザリク゚ストの抂芁です。</p>",
+ "<p>Recorded request summaries and pagination details.</p>": "<p>蚘録したリク゚ストの抂芁ずペヌゞ分割の情報です。</p>",
+ "<p>One complete saved request part, with an optional note.</p>": "<p>保存枈みリク゚ストの指定郚分党䜓ず、省略可胜な泚蚘です。</p>",
+ "<p>Model classes for session management:</p>": "<p>セッション管理のモデルクラスです。</p>",
+ "<p>Information about an open browser session.</p>": "<p>開いおいるブラりザセッションの情報です。</p>",
+ "<p>Response returned when a new session is created.</p>": "<p>新しいセッションの䜜成時に返すレスポンスです。</p>",
+ "<p>Response returned when a session is closed.</p>": "<p>セッションを閉じたずきに返すレスポンスです。</p>",
+ "<p>The main MCP server class that provides all web scraping tools:</p>": "<p>すべおの Web スクレむピングツヌルを提䟛する MCP サヌバヌの䞻芁クラスです。</p>",
+ "<p><strong><code>browser_fetch_once</code></strong>: Fetch one URL through a stealthy browser with JavaScript rendering and Cloudflare handling, then close the browser. Use a persistent session for later actions or network history.</p>": "<p><strong><code>browser_fetch_once</code></strong>ステルスブラりザで 1 ぀の URL を取埗し、JavaScript の実行ず Cloudflare ぞの察応を行っおから、ブラりザを閉じたす。埌で操䜜したり、ネットワヌク履歎を確認したりする堎合は、氞続セッションを䜿っおください。</p>",
+ "<p><strong><code>browser_extract</code></strong>: Read the current page or one element as an AI snapshot, HTML, Markdown, or text without reloading it. Keep results from forms and page actions. Snapshots include element roles, names, references, positions, and sizes; regex search returns matching lines with nearby context and parent nodes.</p>": "<p><strong><code>browser_extract</code></strong>再読み蟌みせずに、珟圚のペヌゞや 1 ぀の芁玠を AI スナップショット、HTML、Markdown、テキストずしお読み取りたす。フォヌム入力やペヌゞ操䜜の結果を保持したす。スナップショットには、芁玠のロヌル、名前、参照、䜍眮、サむズが含たれたす。正芏衚珟で怜玢するず、䞀臎した行ず、その前埌の文脈、芪ノヌドを返したす。</p>",
+ "<p><strong><code>browser_actions</code></strong>: Chain mouse moves, hovers, clicks, scrolling, field filling, keyboard shortcuts, dialog replies, and waits in one call. Accept or dismiss alerts and confirmations, or enter text in prompts. Fill a search box, submit it, wait for results, and open a result without a separate call for each step.</p>": "<p><strong><code>browser_actions</code></strong>1 回の呌び出しで、マりス移動、ホバヌ、クリック、スクロヌル、入力欄の操䜜、キヌボヌドショヌトカット、ダむアログぞの応答、埅機を続けお実行したす。アラヌトや確認を受け入れたり閉じたり、入力ダむアログにテキストを入れたりできたす。怜玢欄ぞの入力、送信、結果の埅機、結果を開く操䜜を、個別に呌び出さずに実行できたす。</p>",
+ "<p>Moves and clicks target selectors, snapshot references, or coordinates; element targets wait and scroll into view. Supports movement in multiple steps, left, right, and middle clicks, double-clicks, and scrolling nested panels.</p>": "<p>移動ずクリックでは、セレクタヌ、スナップショットの参照、座暙で察象を指定したす。察象が芁玠の堎合は、埅機しお衚瀺範囲たでスクロヌルしたす。耇数の段階に分けた移動、巊、右、䞭倮ボタンのクリック、ダブルクリック、入れ子のパネル内のスクロヌルに察応しおいたす。</p>",
+ "<p>Target fields anywhere on the page through selectors or snapshot references. Fill text, check or uncheck boxes, select radio buttons, and choose one or more native dropdown options by label. Replace or clear text, or type at the current caret. Keyboard shortcuts use the current focus. Slow mode adds random pauses between typed characters and all actions.</p>": "<p>セレクタヌやスナップショットの参照で、ペヌゞ䞊の入力欄を指定したす。テキスト入力、チェックボックスのオンずオフ、ラゞオボタンの遞択、暙準のドロップダりンでラベルに基づく 1 ぀以䞊の遞択ができたす。テキストの眮き換えや消去、珟圚のカヌ゜ル䜍眮ぞの入力もできたす。キヌボヌドショヌトカットは珟圚のフォヌカスに䜜甚したす。䜎速モヌドは、入力文字の間ず各操䜜の間にランダムな埅ち時間を入れたす。</p>",
+ "<p>Wait for content or loading overlays through selectors or snapshot references, wait for page load events or settled network activity, or add a fixed pause before continuing.</p>": "<p>セレクタヌやスナップショットの参照で内容や読み蟌み䞭のオヌバヌレむを埅ちたす。ペヌゞの読み蟌みむベントやネットワヌクの通信が萜ち着くたで埅぀こずも、䞀定時間停止しおから続けるこずもできたす。</p>",
+ "<p><strong><code>browser_evaluate</code></strong>: Run JavaScript on the current page to extract custom data, calculate results, read application state, or update page content. Supports asynchronous scripts and returns their results as JSON.</p>": "<p><strong><code>browser_evaluate</code></strong>珟圚のペヌゞで JavaScript を実行し、独自のデヌタ抜出、蚈算、アプリ状態の読み取り、ペヌゞ内容の曎新を行いたす。非同期スクリプトにも察応し、結果を JSON で返したす。</p>",
+ "<p>Create a Scrapling MCP server.</p>": "<p>Scrapling MCP サヌバヌを䜜成したす。</p>",
+ "<p>Optional global Chromium-compatible browser executable path for browser tools.\nIf omitted, the SCRAPLING_EXECUTABLE_PATH environment variable is used when set.</p>": "<p>ブラりザツヌル党䜓で䜿う、Chromium 互換ブラりザの実行ファむルのパスです。省略できたす。省略した堎合、SCRAPLING_EXECUTABLE_PATH 環境倉数が蚭定されおいればその倀を䜿いたす。</p>",
+ "<p>Optional shared token that clients must send as <code>Authorization: Bearer &lt;token&gt;</code>.\nIf omitted, the SCRAPLING_MCP_AUTH_TOKEN environment variable is used when set. It only applies\nto the streamable-http transport.</p>": "<p>クラむアントが <code>Authorization: Bearer &lt;token&gt;</code> で送る共有トヌクンです。省略できたす。省略した堎合、SCRAPLING_MCP_AUTH_TOKEN 環境倉数が蚭定されおいればその倀を䜿いたす。streamable-http だけに適甚されたす。</p>",
+ "<p>Open a reusable stealthy browser session. Pass per-request options to <code>browser_fetch</code>.</p>": "<p>再利甚できるステルスブラりザセッションを開きたす。リク゚スト単䜍のオプションは <code>browser_fetch</code> に枡しおください。</p>",
+ "<p>Save browser cookies, local storage and IndexedDB as Playwright-compatible JSON. Excludes sessionStorage.</p>": "<p>ブラりザの Cookie、ロヌカルストレヌゞ、IndexedDB を Playwright 互換の JSON ずしお保存したす。sessionStorage は含みたせん。</p>",
+ "<p>Replace browser cookies, local storage and IndexedDB from a Playwright-compatible JSON file.</p>": "<p>Playwright 互換の JSON ファむルを䜿っお、ブラりザの Cookie、ロヌカルストレヌゞ、IndexedDB を眮き換えたす。</p>",
+ "<p>Leaves sessionStorage and open tabs unchanged. Fetch or reload pages to use the restored login.</p>": "<p>sessionStorage ず開いおいるタブは倉曎したせん。埩元したログむン状態を䜿うには、ペヌゞを取埗するか再読み蟌みしおください。</p>",
+ "<p>Open a reusable HTTP session for <code>session_make_request</code>, keeping cookies, connections, and request settings.</p>": "<p><code>session_make_request</code> 甚の再利甚できる HTTP セッションを開き、Cookie、接続、リク゚スト蚭定を保持したす。</p>",
+ "<p>Close a session and free its resources.</p>": "<p>セッションを閉じ、リ゜ヌスを解攟したす。</p>",
+ "<p>List registered sessions, their status, and effective settings.</p>": "<p>登録枈みのセッション、その状態、有効な蚭定を䞀芧衚瀺したす。</p>",
+ "<p>List completed requests across page changes, with IDs and pagination. Recording starts when the browser session opens.</p>": "<p>ペヌゞの倉曎をたたいで、完了したリク゚ストを䞀芧衚瀺したす。ID ずペヌゞ分割に察応しおいたす。ブラりザセッションを開いた時点で蚘録を開始したす。</p>",
+ "<p>Read a complete saved request part without resending it, with structured data and availability notes.</p>": "<p>保存したリク゚ストの指定郚分を、再送せずに省略なしで読み取りたす。構造化されたデヌタず、利甚できる内容に぀いおの説明を返したす。</p>",
+ "<p>Read the current page or one element as snapshot, HTML, Markdown, or text without navigating.\nReturn plain text; snapshot search keeps refs, ancestor paths and three lines of nearby context.</p>": "<p>ペヌゞを移動せずに、珟圚のペヌゞや 1 ぀の芁玠をスナップショット、HTML、Markdown、テキストずしお読み取りたす。プレヌンテキストを返したす。スナップショット怜玢では、参照、祖先のパス、前埌 3 行の文脈を保持したす。</p>",
+ "<p>Run mouse, field, key, dialog, and wait actions in order; return plain text without a snapshot.\nStop on the first error, identifying its action; partial effects remain. No retries.\nElement mouse targets auto-wait and scroll into view; coordinates and wheel do not wait for navigation or scrolling.\nCancelled/timed-out clicks attempt button release. Load waits observe the current document, not future navigation.</p>": "<p>マりス、入力欄、キヌ、ダむアログ、埅機の操䜜を順に実行し、スナップショットなしのプレヌンテキストを返したす。最初の゚ラヌで停止し、倱敗した操䜜を瀺したす。それたでの操䜜の効果は残り、再詊行はしたせん。芁玠を察象ずするマりス操䜜は、自動で埅機しお衚瀺範囲たでスクロヌルしたす。座暙ずホむヌルの操䜜は、ペヌゞ移動やスクロヌルを埅ちたせん。クリックがキャンセルたたはタむムアりトした堎合は、ボタンの解攟を詊みたす。読み蟌み埅機は珟圚の文曞を監芖し、埌のペヌゞ移動は察象にしたせん。</p>",
+ "<p>Run JavaScript on the current page, await promises, and return JSON text without a snapshot.\nReturn JSON-compatible values; null/undefined become null. Script effects are not undone on failure.\nCancellation stops waiting, but may not stop the script.</p>": "<p>珟圚のペヌゞで JavaScript を実行し、Promise の完了を埅ち、スナップショットなしの JSON テキストを返したす。JSON 互換の倀を返しおください。null/undefined は null になりたす。倱敗しおも、スクリプトによる倉曎は元に戻したせん。キャンセルは埅機を止めたすが、スクリプトが止たるずは限りたせん。</p>",
+ "<p>Capture the current page or one element without navigating; return the image and current URL.\nElement capture waits and scrolls into view. Use browser_actions for other waits before capture.</p>": "<p>ペヌゞを移動せずに、珟圚のペヌゞや 1 ぀の芁玠を撮圱し、画像ず珟圚の URL を返したす。芁玠の撮圱では、埅機しお衚瀺範囲たでスクロヌルしたす。撮圱前に他の埅機が必芁な堎合は browser_actions を䜿っおください。</p>",
+ "<p>Make an HTTP request without JavaScript. Suitable for low-to-mid protection.</p>": "<p>JavaScript を䜿わずに HTTP リク゚ストを送りたす。保護レベルが䜎い、たたは䞭皋床のサむトに適しおいたす。</p>",
+ "<p>Fetch a page with a stealth browser and JavaScript rendering.</p>": "<p>ステルスブラりザず JavaScript の実行によっおペヌゞを取埗したす。</p>",
+ "<p>Fetch a URL in an open stealthy browser session. Options apply only to this request.</p>": "<p>開いおいるステルスブラりザセッションで URL を取埗したす。オプションはこのリク゚ストだけに適甚されたす。</p>",
+ "<p>Make an HTTP request using the session's cookies, connections, impersonation, and proxy. Options apply to this request.</p>": "<p>セッションの Cookie、接続、ブラりザの暡倣蚭定、プロキシを䜿っお HTTP リク゚ストを送りたす。オプションはこのリク゚ストに適甚されたす。</p>",
+ "<p>Serve the MCP server.</p>": "<p>MCP サヌバヌを起動したす。</p>",
+ "<p>Serve over the streamable-http transport instead of stdio.</p>": "<p>stdio の代わりに streamable-http でサヌビスを提䟛したす。</p>",
+ "<p>The host to bind to when <code>http</code> is enabled.</p>": "<p><code>http</code> が有効な堎合にバむンドするホストです。</p>",
+ "<p>The port to bind to when <code>http</code> is enabled.</p>": "<p><code>http</code> が有効な堎合にバむンドするポヌトです。</p>",
+ "<p>Host names to accept, which turns on DNS-rebinding protection.</p>": "<p>受け付けるホスト名です。指定するず DNS リバむンディング察策が有効になりたす。</p>",
+ "<p>Start the streamable-http transport without a token. The transport\nrequires authentication by default, so this is the explicit opt-out.</p>": "<p>トヌクンなしで streamable-http を起動したす。デフォルトでは認蚌が必芁なため、このオプションで明瀺的に無効にしたす。</p>",
+ "<p>The <code>Selectors</code> class is a subclass of the builtin <code>List</code> class, which provides a few additional methods.</p>": "<p><code>Selectors</code> クラスは、組み蟌みの <code>List</code> クラスを継承し、いく぀かのメ゜ッドを远加しおいたす。</p>",
+ "<p>Returns the first Selector item of the current list or <code>None</code> if the list is empty</p>": "<p>珟圚のリストの最初の Selector 芁玠を返したす。リストが空なら <code>None</code> を返したす。</p>",
+ "<p>Returns the last Selector item of the current list or <code>None</code> if the list is empty</p>": "<p>珟圚のリストの最埌の Selector 芁玠を返したす。リストが空なら <code>None</code> を返したす。</p>",
+ "<p>Returns the length of the current list</p>": "<p>珟圚のリストの長さを返したす。</p>",
+ "<p>Call the <code>.xpath()</code> method for each element in this list and return\ntheir results as another <code>Selectors</code> class.</p>": "<p>リスト内の各芁玠に <code>.xpath()</code> を呌び出し、結果を別の <code>Selectors</code> オブゞェクトずしお返したす。</p>",
+ "<p>A string that will be used to retrieve element's data in adaptive,\notherwise the selector will be used.</p>": "<p>適応型解析で芁玠のデヌタを取埗するための文字列です。指定しない堎合はセレクタヌを䜿いたす。</p>",
+ "<p>Call the <code>.css()</code> method for each element in this list and return\ntheir results flattened as another <code>Selectors</code> class.</p>": "<p>リスト内の各芁玠に <code>.css()</code> を呌び出し、結果を 1 ぀の <code>Selectors</code> オブゞェクトにたずめお返したす。</p>",
+ "<p>Call the <code>.re()</code> method for each element in this list and return\ntheir results flattened as List of TextHandler.</p>": "<p>リスト内の各芁玠に <code>.re()</code> を呌び出し、結果を TextHandler の List にたずめお返したす。</p>",
+ "<p>if disabled, function will set the regex to ignore the letters case while compiling it</p>": "<p>無効にするず、正芏衚珟のコンパむル時に倧文字ず小文字を区別しない蚭定にしたす。</p>",
+ "<p>Loop over all current elements and return the first element that matches the passed function</p>": "<p>珟圚のすべおの芁玠を順に調べ、枡された関数の条件に合う最初の芁玠を返したす。</p>",
+ "<p>A function that takes each element as an argument and returns True/False</p>": "<p>各芁玠を匕数ずしお受け取り、True/False を返す関数です。</p>",
+ "<p>The first element that match the function or <code>None</code> otherwise.</p>": "<p>関数の条件に合う最初の芁玠を返したす。該圓する芁玠がなければ <code>None</code> を返したす。</p>",
+ "<p>Filter current elements based on the passed function</p>": "<p>枡された関数で珟圚の芁玠を絞り蟌みたす。</p>",
+ "<p>The new <code>Selectors</code> object or empty list otherwise.</p>": "<p>新しい <code>Selectors</code> オブゞェクトを返したす。該圓する芁玠がなければ空のリストを返したす。</p>",
+ "<p>Returns the serialized string of the first element, or <code>default</code> if empty.</p>": "<p>最初の芁玠をシリアラむズした文字列を返したす。空なら <code>default</code> を返したす。</p>",
+ "<p>Serialize all elements and return as a TextHandlers list.</p>": "<p>すべおの芁玠をシリアラむズし、TextHandlers リストずしお返したす。</p>",
+ "<p>An abstract base class for creating web spiders.</p>": "<p>Web Spider を䜜成するための抜象基底クラスです。</p>",
+ "<p>Check the documentation website for more information.</p>": "<p>詳しくはドキュメントサむトをご芧ください。</p>",
+ "<p>Initialize the spider.</p>": "<p>Spider を初期化したす。</p>",
+ "<p>Directory for checkpoint files. If provided, enables pause/resume.</p>": "<p>チェックポむントファむルのディレクトリです。指定するず䞀時停止ず再開が有効になりたす。</p>",
+ "<p>Seconds between periodic checkpoint saves (default 5 minutes).</p>": "<p>チェックポむントを定期保存する間隔を秒で指定したす。デフォルトは 5 分です。</p>",
+ "<p>Access current crawl stats (works during streaming).</p>": "<p>珟圚のクロヌル統蚈にアクセスしたす。ストリヌミング䞭も䜿えたす。</p>",
+ "<p>Generate initial requests to start the crawl.</p>": "<p>クロヌルを開始するための初期リク゚ストを生成したす。</p>",
+ "<p>By default, this generates Request objects for each URL in <code>start_urls</code>\nusing the session manager's default session and <code>parse()</code> as callback.</p>": "<p>デフォルトでは、<code>start_urls</code> の各 URL に察しお Request オブゞェクトを生成したす。セッションマネヌゞャヌのデフォルトセッションを䜿い、コヌルバックに <code>parse()</code> を指定したす。</p>",
+ "<p>Override this method for more control over initial requests\n(e.g., to add custom headers, use different callbacks, etc.)</p>": "<p>このメ゜ッドをオヌバヌラむドするず、独自のヘッダヌや別のコヌルバックの指定など、初期リク゚ストを现かく蚭定できたす。</p>",
+ "<p>Default callback for processing responses</p>": "<p>レスポンスを凊理するデフォルトのコヌルバックです。</p>",
+ "<p>Called before crawling starts. Override for setup logic.</p>": "<p>クロヌル開始前に呌ばれたす。準備凊理を远加する堎合はオヌバヌラむドしおください。</p>",
+ "<p>It's enabled if the spider is resuming from a checkpoint, left for the user to use.</p>": "<p>Spider がチェックポむントから再開する堎合に有効になりたす。必芁に応じお䜿えたす。</p>",
+ "<p>Called after crawling finishes. Override for cleanup logic.</p>": "<p>クロヌル完了埌に呌ばれたす。終了凊理を远加する堎合はオヌバヌラむドしおください。</p>",
+ "<p>Handle request errors for all spider requests.</p>": "<p>Spider のすべおのリク゚ストに察しお、リク゚スト゚ラヌを凊理したす。</p>",
+ "<p>Override for custom error handling.</p>": "<p>独自の゚ラヌ凊理を行う堎合はオヌバヌラむドしおください。</p>",
+ "<p>A hook to be overridden by users to do some processing on scraped items, return <code>None</code> to drop the item silently.</p>": "<p>取埗したデヌタ項目を凊理するためにオヌバヌラむドできるフックです。<code>None</code> を返すず、その項目を通知せずに砎棄したす。</p>",
+ "<p>Check if the response is blocked. Users should override this for custom detection logic.</p>": "<p>レスポンスがブロックされおいるかを確認したす。独自の怜出方法を䜿う堎合はオヌバヌラむドしおください。</p>",
+ "<p>Users should override this to prepare the blocked request before retrying, if needed.</p>": "<p>ブロックされたリク゚ストを再詊行前に調敎する必芁がある堎合は、オヌバヌラむドしおください。</p>",
+ "<p>String representation of the spider.</p>": "<p>Spider の文字列衚珟です。</p>",
+ "<p>Configure sessions for this spider.</p>": "<p>この Spider のセッションを蚭定したす。</p>",
+ "<p>Override this method to add custom sessions.\nThe default implementation creates a FetcherSession session.</p>": "<p>独自のセッションを远加する堎合は、このメ゜ッドをオヌバヌラむドしおください。デフォルトの実装は FetcherSession セッションを䜜りたす。</p>",
+ "<p>The first session added becomes the default for <code>start_requests()</code> unless specified otherwise.</p>": "<p>別の指定がなければ、最初に远加したセッションが <code>start_requests()</code> のデフォルトになりたす。</p>",
+ "<p>SessionManager to configure</p>": "<p>蚭定する SessionManager です。</p>",
+ "<p>Request graceful shutdown of the crawling process.</p>": "<p>凊理䞭のタスクが終わるのを埅っお、クロヌルを終了するよう芁求したす。</p>",
+ "<p>Run the spider and return results.</p>": "<p>Spider を実行しお結果を返したす。</p>",
+ "<p>This is the main entry point for running a spider.\nHandles async execution internally via anyio.</p>": "<p>Spider を実行するための䞻な入口です。内郚では anyio を䜿っお非同期実行を凊理したす。</p>",
+ "<p>Pressing Ctrl+C will initiate graceful shutdown (waits for active tasks to complete).\nPressing Ctrl+C a second time will force immediate stop.</p>": "<p>Ctrl+C を抌すず、実行䞭のタスクの完了を埅っお終了したす。もう䞀床 Ctrl+C を抌すず、盎ちに匷制停止したす。</p>",
+ "<p>If crawldir is set, a checkpoint will also be saved on graceful shutdown,\nallowing you to resume the crawl later by running the spider again.</p>": "<p>crawldir を蚭定しおいる堎合、凊理䞭のタスクを埅っお終了するずきにチェックポむントも保存したす。埌で Spider をもう䞀床実行するず、クロヌルを再開できたす。</p>",
+ "<p>Whether to use the faster uvloop/winloop event loop implementation, if available.</p>": "<p>利甚できる堎合に、高速な uvloop/winloop のむベントルヌプ実装を䜿うかどうかを指定したす。</p>",
+ "<p>Asyncio backend options to be used with <code>anyio.run</code></p>": "<p><code>anyio.run</code> に枡す Asyncio バック゚ンドのオプションです。</p>",
+ "<p>Stream items as they're scraped. Ideal for long-running spiders or building applications on top of the spiders.</p>": "<p>デヌタ項目を取埗するたびにストリヌミングで枡したす。長時間動く Spider や、Spider を基にアプリを䜜る堎合に適しおいたす。</p>",
+ "<p>Must be called from an async context. Yields items one by one as they are scraped.\nAccess <code>spider.stats</code> during iteration for real-time statistics.</p>": "<p>非同期コンテキストから呌び出す必芁がありたす。デヌタ項目を取埗するたびに 1 ぀ず぀ yield したす。反埩䞭に <code>spider.stats</code> でリアルタむムの統蚈を確認できたす。</p>",
+ "<p>Note: SIGINT handling for pause/resume is not available in stream mode.</p>": "<p>泚意ストリヌミングモヌドでは、䞀時停止ず再開のための SIGINT 凊理は䜿えたせん。</p>",
+ "<p>Create a copy of this request.</p>": "<p>このリク゚ストのコピヌを䜜りたす。</p>",
+ "<p>Generate a unique fingerprint for deduplication.</p>": "<p>重耇排陀のための䞀意のフィンガヌプリントを生成したす。</p>",
+ "<p>Caches the result in self._fp after first computation.</p>": "<p>初回の蚈算埌、結果を self._fp にキャッシュしたす。</p>",
+ "<p>Compare requests by priority</p>": "<p>リク゚ストを優先床で比范したす。</p>",
+ "<p>Requests are equal if they have the same fingerprint.</p>": "<p>同じフィンガヌプリントを持぀リク゚ストは等しいず刀断したす。</p>",
+ "<p>Prepare state for pickling - store callback as name string for pickle compatibility.</p>": "<p>pickle 甚の状態を準備したす。互換性のため、コヌルバックを名前の文字列ずしお保存したす。</p>",
+ "<p>Restore state from pickle - callback restored later via _restore_callback().</p>": "<p>pickle から状態を埩元したす。コヌルバックは埌で _restore_callback() によっお埩元したす。</p>",
+ "<p>Complete result from a spider run.</p>": "<p>Spider の 1 回の実行結果党䜓です。</p>",
+ "<p>True if the crawl completed normally (not paused).</p>": "<p>クロヌルが䞀時停止せずに正垞完了した堎合は True です。</p>",
+ "<p>Statistics for a crawl run.</p>": "<p>1 回のクロヌル実行の統蚈です。</p>",
+ "<p>A list of scraped items with export capabilities.</p>": "<p>゚クスポヌト機胜を持぀、取埗したデヌタ項目のリストです。</p>",
+ "<p>Export items to a JSON file.</p>": "<p>デヌタ項目を JSON ファむルに゚クスポヌトしたす。</p>",
+ "<p>Path to the output file</p>": "<p>出力ファむルのパスです。</p>",
+ "<p>Pretty-print with 2-space indentation (slightly slower)</p>": "<p>2 個のスペヌスでむンデントし、読みやすく出力したす。少し遅くなりたす。</p>",
+ "<p>Export items as JSON Lines (one JSON object per line).</p>": "<p>デヌタ項目を JSON Lines ずしお゚クスポヌトしたす。1 行に 1 ぀の JSON オブゞェクトを曞きたす。</p>",
+ "<p>Export items to a CSV file.</p>": "<p>デヌタ項目を CSV ファむルに゚クスポヌトしたす。</p>",
+ "<p>Items that don't share the same keys are still written, with the missing cells left empty, and any value\nthat isn't a scalar (a nested dictionary or a list) is written as JSON.</p>": "<p>キヌが揃っおいない項目も曞き蟌み、倀のないセルは空にしたす。スカラヌでない倀、぀たり入れ子の蟞曞やリストは、JSON ずしお曞き蟌みたす。</p>",
+ "<p>The columns to write, defaulting to every key found in the items, in the order they appeared</p>": "<p>曞き蟌む列です。デフォルトでは、デヌタ項目に含たれるすべおのキヌを、最初に珟れた順で䜿いたす。</p>",
+ "<p>The character separating the columns</p>": "<p>列を区切る文字です。</p>",
+ "<p>Export items to an XML file.</p>": "<p>デヌタ項目を XML ファむルに゚クスポヌトしたす。</p>",
+ "<p>Each item becomes an element whose children are named after the item's keys. Keys that aren't valid XML\nnames are rewritten and keep the original in a <code>name</code> attribute, and any value that isn't a scalar\n(a nested dictionary or a list) is written as JSON.</p>": "<p>各デヌタ項目は 1 ぀の芁玠になり、その子芁玠の名前には項目のキヌを䜿いたす。XML の名前ずしお無効なキヌは曞き換え、元の名前を <code>name</code> 属性に保存したす。スカラヌでない倀、぀たり入れ子の蟞曞やリストは、JSON ずしお曞き蟌みたす。</p>",
+ "<p>The name of the element wrapping all the items</p>": "<p>すべおのデヌタ項目を囲む芁玠の名前です。</p>",
+ "<p>The name of the element wrapping every item</p>": "<p>各デヌタ項目を囲む芁玠の名前です。</p>",
+ "<p>Pretty-print the file instead of writing it on a single line</p>": "<p>1 行にたずめず、ファむルを読みやすく敎圢したす。</p>",
+ "<p>Manages pre-configured session instances.</p>": "<p>蚭定枈みのセッションむンスタンスを管理したす。</p>",
+ "<p>Register a session instance.</p>": "<p>セッションむンスタンスを登録したす。</p>",
+ "<p>Name to reference this session in requests</p>": "<p>リク゚ストでこのセッションを指定するための名前です。</p>",
+ "<p>Your pre-configured session instance</p>": "<p>蚭定枈みのセッションむンスタンスです。</p>",
+ "<p>If True, this becomes the default session</p>": "<p>True の堎合、このセッションがデフォルトになりたす。</p>",
+ "<p>If True, the session will be started only when a request uses its ID.</p>": "<p>True の堎合、リク゚ストがこの ID を䜿ったずきにだけセッションを開始したす。</p>",
+ "<p>Removes a session.</p>": "<p>セッションを削陀したす。</p>",
+ "<p>ID of session to remove</p>": "<p>削陀するセッションの ID です。</p>",
+ "<p>Remove and returns a session.</p>": "<p>セッションを削陀しお返したす。</p>",
+ "<p>Start all sessions that aren't already alive.</p>": "<p>ただ実行されおいないすべおのセッションを開始したす。</p>",
+ "<p>Close all registered sessions.</p>": "<p>登録枈みのすべおのセッションを閉じたす。</p>",
+ "<p>Check if a session ID is registered.</p>": "<p>セッション ID が登録されおいるかを確認したす。</p>",
+ "<p>Number of registered sessions.</p>": "<p>登録枈みのセッション数です。</p>"
+} %}
+{% macro translate(value) %}
+ {% set result = namespace(html=value | replace("Bases:", "基底クラス")) %}
+ {% for source, target in translations.items() %}
+ {% set result.html = result.html | replace(source, target | safe) %}
+ {% endfor %}
+ {{ result.html | safe }}
+{% endmacro %}
diff --git a/zensical-base.yml b/zensical-base.yml
index 25e5ea0..9951700 100644
--- a/zensical-base.yml
+++ b/zensical-base.yml
@@ -135,6 +135,9 @@ extra:
- name: 简䜓䞭文
link: https://scrapling.readthedocs.io/en/latest/zh/
lang: zh
+ - name: 日本語
+ link: https://scrapling.readthedocs.io/en/latest/ja/
+ lang: ja
watch:
- zensical-base.yml
- docs/assets
diff --git a/zensical.ja.yml b/zensical.ja.yml
new file mode 100644
index 0000000..a3f3dfc
--- /dev/null
+++ b/zensical.ja.yml
@@ -0,0 +1,99 @@
+INHERIT: zensical-base.yml
+site_description: Scrapling - 珟代のりェブを手軜にスクレむピング。
+site_url: https://scrapling.readthedocs.io/en/latest/ja/
+docs_dir: docs/locales/ja
+site_dir: site/ja
+edit_uri: edit/main/docs/locales/ja/
+copyright: Copyright &copy; 2025 Karim Shoair - <a href="#__consent">Cookie の蚭定を倉曎</a>
+nav:
+- 玹介: index.md
+- はじめに: overview.md
+- 性胜テスト: benchmarks.md
+- 䜿い方:
+ - ペヌゞの解析:
+ - 芁玠の遞択: parsing/selection.md
+ - 䞻なクラス: parsing/main_classes.md
+ - 適応型スクレむピング: parsing/adaptive.md
+ - ペヌゞの取埗:
+ - Fetcher の遞び方: fetching/choosing.md
+ - HTTP リク゚スト: fetching/static.md
+ - ブラりザでの取埗: fetching/stealthy.md
+ - Spider:
+ - 仕組み: spiders/architecture.md
+ - はじめおの Spider: spiders/getting-started.md
+ - リク゚ストずレスポンス: spiders/requests-responses.md
+ - セッション: spiders/sessions.md
+ - プロキシずブロック察策: spiders/proxy-blocking.md
+ - 汎甚テンプレヌト: spiders/generic-templates.md
+ - プラットフォヌム別テンプレヌト: spiders/platform-templates.md
+ - 応甚機胜: spiders/advanced.md
+ - コマンドラむン:
+ - 抂芁: cli/overview.md
+ - 察話型シェル: cli/interactive-shell.md
+ - 抜出コマンド: cli/extract-commands.md
+ - AI ずの連携:
+ - MCP サヌバヌ: ai/mcp-server.md
+ - Agent Skill: ai/agent-skill.md
+ - RAG システムの構築: ai/building-rag-systems.md
+ - 連携ず移行:
+ - Scrapy ずの連携: integrations/scrapy.md
+ - BeautifulSoup からの移行: tutorials/migrating_from_beautifulsoup.md
+- チュヌトリアル:
+ - AI デヌタ抜出サヌビスの無料の代替手段: tutorials/replacing_ai.md
+- 開発:
+ - API リファレンス:
+ - Selector: api-reference/selector.md
+ - Fetcher: api-reference/fetchers.md
+ - MCP サヌバヌ: api-reference/mcp-server.md
+ - 独自の型: api-reference/custom-types.md
+ - Response: api-reference/response.md
+ - Spider: api-reference/spiders.md
+ - プロキシの切り替え: api-reference/proxy-rotation.md
+ - 独自の保存システムを䜜る: development/adaptive_storage_system.md
+ - Scrapling の型を䜿う: development/scrapling_custom_types.md
+- 支揎ず広告: donate.md
+- 開発ぞの参加: https://github.com/D4Vinci/Scrapling/blob/main/CONTRIBUTING.md
+- 倉曎履歎: https://github.com/D4Vinci/Scrapling/blob/main/CHANGELOG.md
+theme:
+ language: ja
+ palette:
+ - media: '(prefers-color-scheme: light)'
+ scheme: default
+ accent: green
+ primary: deep purple
+ toggle:
+ icon: lucide/sun
+ name: ダヌクモヌドに切り替え
+ - media: '(prefers-color-scheme: dark)'
+ scheme: slate
+ accent: light green
+ primary: deep purple
+ toggle:
+ icon: lucide/moon
+ name: ラむトモヌドに切り替え
+markdown_extensions:
+ toc:
+ permalink_title: この芋出しぞのリンク
+plugins:
+ mkdocstrings:
+ locale: ja
+extra:
+ analytics:
+ feedback:
+ title: このペヌゞは圹に立ちたしたか
+ ratings:
+ - icon: material/heart
+ name: 圹に立ちたした
+ data: 1
+ note: ご意芋ありがずうございたす
+ - icon: material/heart-broken
+ name: 改善が必芁です
+ data: 0
+ note: 'ご意芋ありがずうございたす。<a href="https://github.com/D4Vinci/Scrapling/issues/new?template=04-docs_issue.yml" target="_blank" rel="noopener">ドキュメントの問題を報告</a>しお、改善にご協力ください。'
+ consent:
+ title: Cookie の䜿甚に぀いお
+ description: 蚭定の保存ず、ドキュメントが圹に立っおいるかの確認に Cookie を䜿いたす。同意しおいただくず、ドキュメントの改善に圹立ちたす。
+ actions:
+ - accept
+ - reject
+ - manage