PyPIパッケージ: olostep | 要件: Python 3.11+

インストール

pip install olostep

pip3 install olostep

poetry add olostep

uv pip install olostep

認証

Olostep DashboardからAPIキーを取得してください。

クイックスタート

SDKは、使用ケースに応じて2つのクライアントオプションを提供します：

同期クライアント (`Olostep`)

最適な用途: スクリプトや、ブロッキング操作を好むシンプルな使用ケース。

同期クライアントは、非同期/待機に不慣れな場合に始めやすいシンプルなブロッキングインターフェースを提供します。

非同期クライアント (`AsyncOlostep`)

最適な用途: 本番アプリケーションや、多くの同時リクエストを処理する場合。

非同期クライアントはノンブロッキング操作を提供し、高スループットが必要な本番アプリケーションに推奨されます。

同期クライアント (Olostep)

同期クライアント (Olostep) は、スクリプトやシンプルな使用ケースに最適なブロッキングインターフェースを提供します。

from olostep import Olostep

# 'api_key'パラメータを渡すか、OLOSTEP_API_KEY環境変数を設定してAPIキーを提供します

# 同期クライアントはリソース管理を自動的に処理します
# 明示的なクローズは不要です - 各操作後にリソースがクリーンアップされます
client = Olostep(api_key="YOUR_REAL_KEY")
scrape_result = client.scrapes.create(url_to_scrape="https://example.com")

基本的なウェブスクレイピング

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# シンプルなスクレイピング
result = client.scrapes.create(url_to_scrape="https://example.com")
print(f"スクレイプされた文字数: {len(result.html_content)}")

# 複数フォーマット
result = client.scrapes.create(
    url_to_scrape="https://example.com",
    formats=["html", "markdown"]
)
print(f"HTML: {len(result.html_content)} 文字")
print(f"Markdown: {len(result.markdown_content)} 文字")

バッチ処理

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# 複数のURLを効率的に処理
batch = client.batches.create(
    urls=[
        "https://www.google.com/search?q=python",
        "https://www.google.com/search?q=javascript",
        "https://www.google.com/search?q=typescript"
    ]
)

# 完了を待ち、結果を処理
for item in batch.items():
    content = item.retrieve(["html"])
    print(f"処理済み {item.url}: {len(content.html_content)} バイト")

スマートウェブクロール

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# インテリジェントフィルタリングを使用してクロール
crawl = client.crawls.create(
    start_url="https://www.bbc.com",
    max_pages=100,
    include_urls=["/articles/**", "/blog/**"],
    exclude_urls=["/admin/**"]
)

for page in crawl.pages():
    content = page.retrieve(["html"])
    print(f"クロール済み: {page.url}")

サイトマッピング

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# ウェブサイトからすべてのリンクを抽出
maps = client.maps.create(url="https://example.com")

# 発見されたすべてのURLを取得
urls = []
for url in maps.urls():
    urls.append(url)
    if len(urls) >= 10:  # デモ用の制限
        break

print(f"発見されたURL数: {len(urls)}")

AI駆動の回答

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# AIを使用してウェブページから回答を取得
answer = client.answers.create(
    task="What is the main topic of https://example.com?"
)
print(f"回答: {answer.answer}")

非同期クライアント (AsyncOlostep)

非同期クライアント (AsyncOlostep) は、高性能アプリケーション、バックエンドサービス、および多くの同時リクエストを処理する必要がある場合に推奨されるクライアントです。

from olostep import AsyncOlostep

# 'api_key'パラメータを渡すか、OLOSTEP_API_KEY環境変数を設定してAPIキーを提供します

# リソース管理
# ===================
# SDKはリソース管理のための2つの使用パターンをサポートしています：

# 1. コンテキストマネージャー（ワンオフ使用に推奨）：
#    リソースのクリーンアップを自動的に処理
async with AsyncOlostep(api_key="YOUR_REAL_KEY") as client:
    scrape_result = await client.scrapes.create(url_to_scrape="https://example.com")
# トランスポートはここで自動的に閉じられます

# 2. 明示的なクローズ（長期間のサービス用）：
#    手動でのリソースクリーンアップが必要
client = AsyncOlostep(api_key="YOUR_REAL_KEY")
try:
    scrape_result = await client.scrapes.create(url_to_scrape="https://example.com")
finally:
    await client.close()  # トランスポートを手動で閉じる

基本的なウェブスクレイピング

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # シンプルなスクレイピング
        result = await client.scrapes.create(url_to_scrape="https://example.com")
        print(f"スクレイプされた文字数: {len(result.html_content)}")

        # 複数フォーマット
        result = await client.scrapes.create(
            url_to_scrape="https://example.com",
            formats=["html", "markdown"]
        )
        print(f"HTML: {len(result.html_content)} 文字")
        print(f"Markdown: {len(result.markdown_content)} 文字")

asyncio.run(main())

バッチ処理

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # 複数のURLを効率的に処理
        batch = await client.batches.create(
            urls=[
                "https://www.google.com/search?q=python",
                "https://www.google.com/search?q=javascript",
                "https://www.google.com/search?q=typescript"
            ]
        )

        # 完了を待ち、結果を処理
        async for item in batch.items():
            content = await item.retrieve(["html"])
            print(f"処理済み {item.url}: {len(content.html_content)} バイト")

asyncio.run(main())

スマートウェブクロール

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # インテリジェントフィルタリングを使用してクロール
        crawl = await client.crawls.create(
            start_url="https://www.bbc.com",
            max_pages=100,
            include_urls=["/articles/**", "/blog/**"],
            exclude_urls=["/admin/**"]
        )

        async for page in crawl.pages():
            content = await page.retrieve(["html"])
            print(f"クロール済み: {page.url}")

asyncio.run(main())

サイトマッピング

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # ウェブサイトからすべてのリンクを抽出
        maps = await client.maps.create(url="https://example.com")

        # 発見されたすべてのURLを取得
        urls = []
        async for url in maps.urls():
            urls.append(url)
            if len(urls) >= 10:  # デモ用の制限
                break

        print(f"発見されたURL数: {len(urls)}")

asyncio.run(main())

AI駆動の回答

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # AIを使用してウェブページから回答を取得
        answer = await client.answers.create(
            task="What is the main topic of https://example.com?"
        )
        print(f"回答: {answer.answer}")

asyncio.run(main())

SDKリファレンス

メソッド構造

両方のSDKクライアントは、論理的な名前空間に整理されたクリーンでPython的なインターフェースを提供します：

名前空間	目的	主なメソッド
`scrapes`	単一URL抽出	`create()`, `get()`
`batches`	複数URL処理	`create()`, `info()`, `items()`
`crawls`	ウェブサイトのトラバース	`create()`, `info()`, `pages()`
`maps`	リンク抽出	`create()`, `urls()`
`answers`	AI駆動の抽出	`create()`, `get()`
`retrieve`	コンテンツ取得	`get()`

各操作は、後続の操作のためのエルゴノミックなメソッドを持つステートフルオブジェクトを返します。

エラーハンドリング

すべてのSDKエラーを基本例外クラスでキャッチします：

from olostep import Olostep, Olostep_BaseError

client = Olostep(api_key="your-api-key")

try:
    result = client.scrapes.create(url_to_scrape="https://example.com")
except Olostep_BaseError as e:
    print(f"エラーが発生しました: {type(e).__name__}")
    print(f"エラーメッセージ: {e}")

詳細なエラーハンドリング情報、完全な例外階層、および詳細なエラーハンドリングオプションについては、詳細なエラーハンドリングを参照してください。

自動リトライ

SDKは一時的なエラー（ネットワークの問題、一時的なサーバーの問題）に対して自動的にリトライを行います。RetryStrategy設定に基づいてリトライ動作をカスタマイズできます。クライアントを作成する際にRetryStrategyインスタンスを渡すことでリトライ動作をカスタマイズできます：

from olostep import Olostep, RetryStrategy

retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,
    jitter_max=0.8
)

client = Olostep(api_key="your-api-key", retry_strategy=retry_strategy)
result = client.scrapes.create("https://example.com")

詳細なリトライ設定オプションとベストプラクティスについては、リトライ戦略を参照してください。

高度な機能

スマート入力強制

SDKは、最大限の利便性を提供するためにさまざまな入力フォーマットをインテリジェントに処理します：

from olostep import Olostep, Country

client = Olostep(api_key="your-api-key")

# フォーマット: 文字列、リスト、または列挙型
client.scrapes.create(url_to_scrape="https://example.com", formats="html")
client.scrapes.create(url_to_scrape="https://example.com", formats=["html", "markdown"])

# 国: 大文字小文字を区別しない文字列または列挙型
client.scrapes.create(url_to_scrape="https://example.com", country="us")
client.scrapes.create(url_to_scrape="https://example.com", country=Country.US)

# リスト: 単一値またはリスト
client.batches.create(urls="https://example.com")    # 単一URL
client.batches.create(urls=["https://a.com", "https://b.com"])  # 複数URL

高度なスクレイピングオプション

from olostep import Olostep, Format, Country, WaitAction, FillInputAction

client = Olostep(api_key="your-api-key")

# スクレイピング動作を完全に制御
result = client.scrapes.create(
    url_to_scrape="https://news.google.com/",
    wait_before_scraping=3000,
    formats=[Format.HTML, Format.MARKDOWN],
    remove_css_selectors=["script", ".popup"],
    actions=[
        WaitAction(milliseconds=1500),
        FillInputAction(selector="searchbox", value="olostep")
    ],
    parser="@olostep/google-news",
    country=Country.US,
    remove_images=True
)

キャッシング

デフォルトでは、すべてのスクレイプリクエストは新しいページを取得します（max_age=0）。同じパラメータで最近の結果を再利用し、応答時間を改善するためにmax_ageを渡します。値は秒で、最大は7日間（604800）です。詳細については、キャッシングを参照してください。

# キャッシングをオプトイン: 最大1日（86400秒）古い結果を受け入れる
result = client.scrapes.create(
    url_to_scrape="https://example.com",
    formats=["markdown"],
    max_age=86400
)

カスタムIDを使用したバッチ処理

from olostep import Olostep, Country

client = Olostep(api_key="your-api-key")

batch = client.batches.create([
    {"url": "https://www.google.com/search?q=python", "custom_id": "search_1"},
    {"url": "https://www.google.com/search?q=javascript", "custom_id": "search_2"},
    {"url": "https://www.google.com/search?q=typescript", "custom_id": "search_3"}
],
country=Country.US,
parser="@olostep/google-search"
)

# カスタムIDで結果を処理
# パーサーを使用する場合、HTMLの代わりにJSONコンテンツを取得
for item in batch.items():
    if item.custom_id == "search_2":
        content = item.retrieve(["json"])
        print(f"検索結果: {content.json_content}")

インテリジェントクロール

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# インテリジェントフィルタリングを使用してクロール
crawl = client.crawls.create(
    start_url="https://www.bbc.com",
    max_pages=1000,
    max_depth=3,
    include_urls=["/articles/**", "/news/**"],
    exclude_urls=["/ads/**", "/tracking/**"],
    include_external=False,
    include_subdomain=True,
)

for page in crawl.pages():
    content = page.retrieve(["html"])
    print(f"クロール済み: {page.url}")

フィルター付きサイトマッピング

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# 高度なフィルタリングを使用してすべてのリンクを抽出
maps = client.maps.create(
    url="https://www.bbc.com",
    include_subdomain=True,
    include_urls=["/articles/**", "/news/**"],
    exclude_urls=["/ads/**", "/tracking/**"]
)

# フィルターされたURLを取得
urls = []
for url in maps.urls():
    urls.append(url)

print(f"関連するURL数: {len(urls)}")

回答の取得

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# まず回答を作成
created_answer = client.answers.create(
    task="What is the main topic of https://example.com?"
)

# 次にIDを使用して取得
answer = client.answers.get(answer_id=created_answer.id)
print(f"回答: {answer.answer}")

コンテンツの取得

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# 取得IDでコンテンツを取得
result = client.retrieve.get(retrieve_id="ret_123")

# 複数フォーマットを取得
result = client.retrieve.get(retrieve_id="ret_123", formats=["html", "markdown", "text", "json"])

ロギング

問題をデバッグするためにロギングを有効にします：

import logging

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger("olostep")
logger.setLevel(logging.INFO)  # 詳細な出力にはDEBUGを使用

ログレベル: INFO（推奨）、DEBUG（詳細）、WARNING、ERROR

リトライ戦略の設定

RetryStrategyクラスは、Olostep SDKが一時的なAPIエラーを自動リトライでどのように処理するかを制御します。これにより、一時的なネットワーク問題、レート制限、サーバーの過負荷が原因で発生する断続的な失敗がある場合でも、信頼性の高い運用が可能になります。

デフォルトの動作

デフォルトでは、SDKは以下のリトライ設定を使用します：

最大リトライ回数: 5回の試行
初期遅延: 2秒
バックオフ: 指数関数（2^試行回数）
ジッター: 遅延の10-90%（ランダム化）

これにより：

試行1: 即時
試行2: 約2-3.6秒の遅延
試行3: 約4-7.2秒の遅延
試行4: 約8-14.4秒の遅延
試行5: 約16-28.8秒の遅延

最大持続時間: すべてのリトライで約57秒（最悪の場合）

カスタム設定

from olostep import AsyncOlostep, RetryStrategy

# カスタムリトライ戦略を作成
retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,  # 最小ジッター20%
    jitter_max=0.8,  # 最大ジッター80%
)

# クライアントで使用
async with AsyncOlostep(
    api_key="your-api-key",
    retry_strategy=retry_strategy
) as client:
    result = await client.scrapes.create("https://example.com")

リトライが発生する場合

SDKは以下の場合に自動的にリトライします：

一時的なサーバーの問題 (OlostepServerError_TemporaryIssue)
タイムアウト応答 (OlostepServerError_NoResultInResponse)

その他のエラー（認証、検証、リソースが見つからないなど）は、即座に失敗し、リトライされません。

トランスポートと呼び出し元のリトライ

SDKには2つのリトライ層があります：

トランスポート層: ネットワークレベルの接続失敗を処理（DNS、タイムアウトなど）
呼び出し元層: APIレベルの一時的なエラーを処理（RetryStrategyによって制御）

両方の層は独立しており、別々の設定があります。合計最大持続時間は両方の層の合計です。

最大持続時間の計算

retry_strategy = RetryStrategy(max_retries=5, initial_delay=2.0)
max_duration = retry_strategy.max_duration()
print(f"最大呼び出し持続時間: {max_duration:.2f}s")

設定例

異なる使用ケースに対するリトライ戦略の設定例をいくつか示します。

保守的な戦略

# リトライ回数を減らし、遅延を短く
retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,
    jitter_max=0.8
)
# 最大持続時間: 約12.6秒

積極的な戦略

# 重要な操作のためにリトライ回数を増やす
retry_strategy = RetryStrategy(
    max_retries=10,
    initial_delay=0.5
)
# 最大持続時間: 約969.75秒

リトライなし（即時失敗）

# 即時失敗フィードバックのためにリトライを無効化
retry_strategy = RetryStrategy(max_retries=0)

client = AsyncOlostep(api_key="your-api-key", retry_strategy=retry_strategy)

高スループット戦略

# 高ボリューム操作に最適化
retry_strategy = RetryStrategy(
    max_retries=2,
    initial_delay=0.5,
    jitter_min=0.1,
    jitter_max=0.3  # より予測可能なタイミングのためにジッターを低く設定
)
# 最大持続時間: 約1.95秒

ジッターの理解

ジッターは、多くのクライアントが同時にリトライする際の「雷鳴の群れ」問題を防ぐためにランダム化を追加します。ジッターは次のように計算されます：

base_delay = initial_delay * (2 ** attempt)
jitter_range = base_delay * (jitter_max - jitter_min)
jitter = random.uniform(base_delay * jitter_min, base_delay * jitter_min + jitter_range)
final_delay = base_delay + jitter

例えば、initial_delay=2.0、jitter_min=0.1、jitter_max=0.9の場合：

試行0: base=2.0s, jitter=0.2-1.8s, final=2.2-3.8s
試行1: base=4.0s, jitter=0.4-3.6s, final=4.4-7.6s
試行2: base=8.0s, jitter=0.8-7.2s, final=8.8-15.2s

ベストプラクティス

本番アプリケーション用

# 本番用のバランスの取れたアプローチ
retry_strategy = RetryStrategy(
    max_retries=5,
    initial_delay=2.0,
    jitter_min=0.1,
    jitter_max=0.9
)

開発/テスト用

# 開発用の迅速なフィードバック
retry_strategy = RetryStrategy(
    max_retries=2,
    initial_delay=0.5,
    jitter_min=0.1,
    jitter_max=0.3
)

バッチ操作用

# 大規模バッチジョブ用の保守的なアプローチ
retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,
    jitter_max=0.8
)

モニタリングとデバッグ

SDKはリトライ情報をDEBUGレベルでログに記録します：

DEBUG: 一時的な問題、2.34秒後にリトライ
DEBUG: 応答に結果がないため、4.67秒後にリトライ

リトライ動作をモニタリングするためにデバッグロギングを有効にします：

import logging
logging.getLogger("olostep").setLevel(logging.DEBUG)

エラーハンドリング

すべてのリトライが尽きた場合、元のエラーが発生します：

try:
    result = await client.scrapes.create("https://example.com")
except OlostepServerError_TemporaryIssue as e:
    print(f"すべてのリトライ後に失敗しました: {e}")
    # 永続的な失敗を処理

パフォーマンスの考慮事項

メモリ: 各リトライ試行はリクエスト/レスポンスオブジェクトの追加メモリを使用します
時間: リトライが有効な場合、総操作時間が大幅に長くなる可能性があります
API制限: リトライはAPI使用制限にカウントされます
ネットワーク: リトライ試行によるネットワークトラフィックの増加

信頼性とパフォーマンスの要件に基づいてリトライ戦略を選択してください。

詳細なエラーハンドリング

例外階層

Olostep SDKは、さまざまな失敗シナリオに対する包括的な例外階層を提供します。すべての例外はOlostep_BaseErrorから継承されます。 Olostep_BaseErrorから直接継承される3つの主要なエラータイプがあります：

Olostep_APIConnectionError - ネットワークレベルの接続失敗
OlostepServerError_BaseError - APIサーバーによって（ある種）発生したエラー
OlostepClientError_BaseError - クライアントSDKによって発生したエラー

なぜ接続エラーが別なのか

Olostep_APIConnectionErrorは、サーバーエラーとは別で、APIがリクエストを処理する前に発生するネットワークレベルの失敗を表します。これらはトランスポート層の問題（DNSまたはHTTPの失敗、タイムアウト、接続拒否など）であり、APIレベルのエラーではありません。HTTPステータスコード（4xx、5xx）はAPI応答と見なされ、サーバーエラーとして分類されますが、問題を示しています。

Olostep_BaseError
├── Olostep_APIConnectionError
├── OlostepServerError_BaseError
│   ├── OlostepServerError_TemporaryIssue
│   │   ├── OlostepServerError_NetworkBusy
│   │   └── OlostepServerError_InternalNetworkIssue
│   ├── OlostepServerError_RequestUnprocessable
│   │   ├── OlostepServerError_ParserNotFound
│   │   └── OlostepServerError_OutOfResources
│   ├── OlostepServerError_BlacklistedDomain
│   ├── OlostepServerError_FeatureApprovalRequired
│   ├── OlostepServerError_AuthFailed
│   ├── OlostepServerError_CreditsExhausted
│   ├── OlostepServerError_InvalidEndpointCalled
│   ├── OlostepServerError_ResourceNotFound
│   ├── OlostepServerError_NoResultInResponse
│   └── OlostepServerError_UnknownIssue
└── OlostepClientError_BaseError
    ├── OlostepClientError_RequestValidationFailed
    ├── OlostepClientError_ResponseValidationFailed
    ├── OlostepClientError_NoAPIKey
    ├── OlostepClientError_AsyncContext
    ├── OlostepClientError_BetaFeatureAccessRequired
    └── OlostepClientError_Timeout

推奨エラーハンドリング

ほとんどの使用ケースでは、基本エラーをキャッチしてエラー名を出力します：

from olostep import AsyncOlostep, Olostep_BaseError

try:
    result = await client.scrapes.create(url_to_scrape="https://example.com")
except Olostep_BaseError as e:
    print(f"エラーが発生しました: {type(e).__name__}")
    print(f"エラーメッセージ: {e}")

このアプローチは、すべてのSDKエラーをキャッチし、何が問題であったかについての明確な情報を提供します。エラー名（例：OlostepServerError_AuthFailed）は、問題を理解するのに十分な説明的です。

詳細なエラーハンドリング

より具体的なエラーハンドリングが必要な場合は、直接特定のエラータイプをキャッチします。OlostepServerError_BaseErrorまたはOlostepClientError_BaseErrorを使用しないでください - これらの基本クラスは、エラーを誰が発生させたかを示すだけで、誰が修正する責任があるかを示しません。これはエラーハンドリングロジックには役立たない実装の詳細です。代わりに、実際の問題を示す特定のエラータイプをキャッチします：

from olostep import (
    AsyncOlostep,
    Olostep_BaseError,
    Olostep_APIConnectionError,
    OlostepServerError_AuthFailed,
    OlostepServerError_CreditsExhausted,
    OlostepClientError_NoAPIKey,
)

try:
    result = await client.scrapes.create(url_to_scrape="https://example.com")
except Olostep_APIConnectionError as e:
    print(f"ネットワークエラー: {type(e).__name__}")
except OlostepServerError_AuthFailed:
    print("無効なAPIキー")
except OlostepServerError_CreditsExhausted:
    print("クレジットが尽きました")
except OlostepClientError_NoAPIKey:
    print("APIキーが提供されていません")
except Olostep_BaseError as e:
    print(f"エラーが発生しました: {type(e).__name__}")

設定

環境変数

変数	説明	デフォルト
`OLOSTEP_API_KEY`	あなたのAPIキー	必須
`OLOSTEP_BASE_API_URL`	APIベースURL	`https://api.olostep.com/v1`
`OLOSTEP_API_TIMEOUT`	リクエストタイムアウト（秒）	`150`

​インストール

​認証

​クイックスタート

同期クライアント (`Olostep`)

非同期クライアント (`AsyncOlostep`)

​同期クライアント (Olostep)

​基本的なウェブスクレイピング

​バッチ処理

​スマートウェブクロール

​サイトマッピング

​AI駆動の回答

​非同期クライアント (AsyncOlostep)

​基本的なウェブスクレイピング

​バッチ処理

​スマートウェブクロール

​サイトマッピング

​AI駆動の回答

​SDKリファレンス

​メソッド構造

​エラーハンドリング

​自動リトライ

​高度な機能

​スマート入力強制

​高度なスクレイピングオプション

​キャッシング

​カスタムIDを使用したバッチ処理

​インテリジェントクロール

​フィルター付きサイトマッピング

​回答の取得

​コンテンツの取得

​ロギング

​リトライ戦略の設定

​デフォルトの動作

​カスタム設定

​リトライが発生する場合

​トランスポートと呼び出し元のリトライ

​最大持続時間の計算

​設定例

​保守的な戦略

​積極的な戦略

​リトライなし（即時失敗）

​高スループット戦略

​ジッターの理解

​ベストプラクティス

​本番アプリケーション用

​開発/テスト用

​バッチ操作用

​モニタリングとデバッグ

​エラーハンドリング

​パフォーマンスの考慮事項

​詳細なエラーハンドリング

​例外階層

​なぜ接続エラーが別なのか

​推奨エラーハンドリング

​詳細なエラーハンドリング

​設定

​環境変数

​ヘルプを得る

​リソース

PyPIパッケージ

APIキーを取得

インストール

認証

クイックスタート

同期クライアント (Olostep)

基本的なウェブスクレイピング

バッチ処理

スマートウェブクロール

サイトマッピング

AI駆動の回答

非同期クライアント (AsyncOlostep)

基本的なウェブスクレイピング

バッチ処理

スマートウェブクロール

サイトマッピング

AI駆動の回答

SDKリファレンス

メソッド構造

エラーハンドリング

自動リトライ

高度な機能

スマート入力強制

高度なスクレイピングオプション

キャッシング

カスタムIDを使用したバッチ処理

インテリジェントクロール

フィルター付きサイトマッピング

回答の取得

コンテンツの取得

ロギング

リトライ戦略の設定

デフォルトの動作

カスタム設定

リトライが発生する場合

トランスポートと呼び出し元のリトライ

最大持続時間の計算

設定例

保守的な戦略

積極的な戦略

リトライなし（即時失敗）

高スループット戦略

ジッターの理解

ベストプラクティス

本番アプリケーション用

開発/テスト用

バッチ操作用

モニタリングとデバッグ

エラーハンドリング

パフォーマンスの考慮事項

詳細なエラーハンドリング

例外階層

なぜ接続エラーが別なのか

推奨エラーハンドリング

詳細なエラーハンドリング

設定

環境変数

ヘルプを得る

リソース