アーキテクチャ（ライブラリ vs アプリ）

層	置くもの	置かないもの
mercari ライブラリ	API メソッド・変換・汎用フィルタ・ポーラ基盤・ゲスト DPoP	「安値通知」「AI 判定」などの完成プロダクト
examples/ / あなたのコード	条件・相場の組み合わせ・Webhook・AI	プロトコル詳細の再実装

mercari.MercariClient
  .search(**filters)
  .item(id) / .items([...])
  .ensure_guest_auth / .auth_status

mercari.MercariSearchPoller + PollerConfig
mercari.ItemFilter / peer_prices_for_market / compute_market_stats
mercari.souba.* / recommended_market_price

拡張するときは ライブラリにメソッドを足す → サンプルで機能を組む。