メインコンテンツまでスキップ

相場ヘルパ / SOUBA

ピア価格 → 統計​

import mercari

# items: search の hits（正規化済み）
f = mercari.ItemFilter.from_args(keyword="iPhone", conditions=["目立った傷や汚れなし"])
prices = mercari.peer_prices_for_market(items, f)
stats = mercari.compute_market_stats(prices)
# stats.median, stats.mean, ...

cheap = mercari.is_below_market(listing_price, stats, discount_ratio=0.85)

既定は 中央値（median） です。手数料や利益率は織り込みません（買い値は運用者の裁量）。

from mercari import recommended_market_price, market_price_stats

# hits は search の item dict 列（price キー）
st = market_price_stats([
    {"price": 8000},
    {"price": 10000},
    {"price": 12000},
])
rec = recommended_market_price(st)  # default style=median → recommended_price 10000
# style="mean" / "ratio" / "fee_adjusted" も利用可

SOUBA ファイル​

data/souba.json 形式のエントリに対する title マッチと上限価格比較。

from mercari import load_souba, match_souba, draft_pattern_from_name

entries = load_souba()
# match_souba(title, price, entries) → マッチしたエントリ or None

ポーラ例: examples/22_souba_poller.py（オークションはスキップ、価格は SOUBA.price 以下 でヒット）。