MercariClient

公開エントリポイント。import mercari 後のメインクラスです。

import mercari

c = mercari.MercariClient(
    dry_run=False,
    auto_bootstrap=True,
    session_path=None,      # 既定: ワークスペース session.json
    keystore_path=None,     # 既定: ワークスペース dpop_key.pem
    timeout=30.0,
)

コンストラクタ引数

引数	説明
session	既存 MercariSession（省略時は path から load）
access_token / dpop	手動で載せる場合
dry_run	True ならネットワークなしでリクエスト形を返す
auto_bootstrap	ライブ時に ensure_guest_auth を自動実行
session_path	セッション JSON のパス
keystore_path	DPoP PEM のパス
timeout	HTTP タイムアウト秒

主なメソッド

メソッド	説明
search(**kwargs)	検索。dry_run / live
item(item_id, source=...)	商品詳細
items([id, ...])	複数詳細
ensure_guest_auth(try_pfat=True)	ゲスト identity 準備
guest_ready()	DPoP 準備済みか
auth_status()	状態 dict
set_token(...)	キャプチャ Bearer を設定
save_session() / load_session()	セッション永続化

エイリアス: MercariSearchClient = MercariClient。