mercari ライブラリ
メルカリ JP の ゲスト検索・商品詳細・ポーリング を、Python から requests や discord.py と同じ感覚で使える薄いライブラリです。
import mercari
c = mercari.MercariClient()
result = c.search(keyword="iPhone", category_id=3833, sort="新しい順")
for item in result.get("items") or []:
print(item["name"], item["price"])
何ができるか
| 機能 | 入口 |
|---|---|
| 検索（出品中 / 売切込み） | MercariClient.search |
| 商品詳細 | MercariClient.item |
| 新着ポーリング | MercariSearchPoller / examples/13_* |
| 相場・安値判定ヘルパ | compute_market_stats / is_below_market / SOUBA |
| ゲスト identity（DPoP） | クライアント内部で自動 |
設計方針
- ライブラリ = API メソッドとデータ変換（ヘッダやトークンの手組みは不要）
- アプリ（
examples/） = 安値判定・Webhook・Discord など完成プロダクト - ゲスト前提: 永続 RSA 鍵 +
device_uuidが「端末」。Bearer（PFAT）は任意
よく使うトピック
- HTTP プロキシ — 全リクエストをプロキシ経由
- dry_run とは — ネットワークなしでリクエストを組み立てる仕組み
- 高度な検索 JSON —
search_conditionを貼って検索 - Webapp バックエンド — Flask SPA とライブラリの対応