pyr0ball
58263d814a
- FastAPI service (port 8510) wrapping scraper + trust scorer - Playwright+Xvfb+stealth transport to bypass eBay Kasada bot protection - li.s-card selector migration (eBay markup change from li.s-item) - Three-layer caching: HTML (5min), phash (permanent), market comp (6h SQLite) - Batch DB writes (executemany + single commit) — warm requests <1s - Unique Xvfb display counter (:200–:299) prevents lock file collisions - Vue 3 nginx web service (port 8509) proxying /api/ to FastAPI - Auction card de-emphasis: opacity 0.72 for listings with >1h remaining - 35 scraper unit tests updated for new li.s-card fixture markup - tests/ volume-mounted in compose.override.yml for live test editing
337 lines
12 KiB
Python
337 lines
12 KiB
Python
"""Scraper-based eBay adapter — free tier, no API key required.
|
||
|
||
Data available from search results HTML (single page load):
|
||
✅ title, price, condition, photos, URL
|
||
✅ seller username, feedback count, feedback ratio
|
||
❌ account registration date → account_age_score = None (score_is_partial)
|
||
❌ category history → category_history_score = None (score_is_partial)
|
||
|
||
This is the MIT discovery layer. EbayAdapter (paid/CF proxy) unlocks full trust scores.
|
||
"""
|
||
from __future__ import annotations
|
||
|
||
import hashlib
|
||
import itertools
|
||
import re
|
||
import time
|
||
from datetime import datetime, timedelta, timezone
|
||
from typing import Optional
|
||
|
||
from bs4 import BeautifulSoup
|
||
from playwright.sync_api import sync_playwright
|
||
from playwright_stealth import Stealth
|
||
|
||
from app.db.models import Listing, MarketComp, Seller
|
||
from app.db.store import Store
|
||
from app.platforms import PlatformAdapter, SearchFilters
|
||
|
||
EBAY_SEARCH_URL = "https://www.ebay.com/sch/i.html"
|
||
_HTML_CACHE_TTL = 300 # seconds — 5 minutes
|
||
|
||
# Module-level cache persists across per-request adapter instantiations.
|
||
# Keyed by URL; value is (html, expiry_timestamp).
|
||
_html_cache: dict[str, tuple[str, float]] = {}
|
||
|
||
# Cycle through display numbers :200–:299 so concurrent/sequential Playwright
|
||
# calls don't collide on the Xvfb lock file from the previous run.
|
||
_display_counter = itertools.cycle(range(200, 300))
|
||
|
||
_HEADERS = {
|
||
"User-Agent": (
|
||
"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 "
|
||
"(KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36"
|
||
),
|
||
"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
|
||
"Accept-Language": "en-US,en;q=0.5",
|
||
"Accept-Encoding": "gzip, deflate, br",
|
||
"DNT": "1",
|
||
"Connection": "keep-alive",
|
||
"Upgrade-Insecure-Requests": "1",
|
||
}
|
||
|
||
_SELLER_RE = re.compile(r"^(.+?)\s+\(([0-9,]+)\)\s+([\d.]+)%")
|
||
_FEEDBACK_RE = re.compile(r"([\d.]+)%\s+positive\s+\(([0-9,]+)\)", re.I)
|
||
_PRICE_RE = re.compile(r"[\d,]+\.?\d*")
|
||
_ITEM_ID_RE = re.compile(r"/itm/(\d+)")
|
||
_TIME_LEFT_RE = re.compile(r"(?:(\d+)d\s*)?(?:(\d+)h\s*)?(?:(\d+)m\s*)?(?:(\d+)s\s*)?left", re.I)
|
||
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# Pure HTML parsing functions (unit-testable, no HTTP)
|
||
# ---------------------------------------------------------------------------
|
||
|
||
def _parse_price(text: str) -> float:
|
||
"""Extract first numeric value from price text.
|
||
|
||
Handles '$950.00', '$900.00 to $1,050.00', '$1,234.56/ea'.
|
||
Takes the lower bound for price ranges (conservative for trust scoring).
|
||
"""
|
||
m = _PRICE_RE.search(text.replace(",", ""))
|
||
return float(m.group()) if m else 0.0
|
||
|
||
|
||
def _parse_seller(text: str) -> tuple[str, int, float]:
|
||
"""Parse eBay seller-info text into (username, feedback_count, feedback_ratio).
|
||
|
||
Input format: 'tech_seller (1,234) 99.1% positive feedback'
|
||
Returns ('tech_seller', 1234, 0.991).
|
||
Falls back gracefully if the format doesn't match.
|
||
"""
|
||
text = text.strip()
|
||
m = _SELLER_RE.match(text)
|
||
if not m:
|
||
return (text.split()[0] if text else ""), 0, 0.0
|
||
return m.group(1).strip(), int(m.group(2).replace(",", "")), float(m.group(3)) / 100.0
|
||
|
||
|
||
def _parse_time_left(text: str) -> Optional[timedelta]:
|
||
"""Parse eBay time-left text into a timedelta.
|
||
|
||
Handles '3d 14h left', '14h 23m left', '23m 45s left'.
|
||
Returns None if text doesn't match (i.e. fixed-price listing).
|
||
"""
|
||
if not text:
|
||
return None
|
||
m = _TIME_LEFT_RE.search(text)
|
||
if not m or not any(m.groups()):
|
||
return None
|
||
days = int(m.group(1) or 0)
|
||
hours = int(m.group(2) or 0)
|
||
minutes = int(m.group(3) or 0)
|
||
seconds = int(m.group(4) or 0)
|
||
if days == hours == minutes == seconds == 0:
|
||
return None
|
||
return timedelta(days=days, hours=hours, minutes=minutes, seconds=seconds)
|
||
|
||
|
||
def _extract_seller_from_card(card) -> tuple[str, int, float]:
|
||
"""Extract (username, feedback_count, feedback_ratio) from an s-card element.
|
||
|
||
New eBay layout has seller username and feedback as separate su-styled-text spans.
|
||
We find the feedback span by regex, then take the immediately preceding text as username.
|
||
"""
|
||
texts = [s.get_text(strip=True) for s in card.select("span.su-styled-text") if s.get_text(strip=True)]
|
||
username, count, ratio = "", 0, 0.0
|
||
for i, t in enumerate(texts):
|
||
m = _FEEDBACK_RE.search(t)
|
||
if m:
|
||
ratio = float(m.group(1)) / 100.0
|
||
count = int(m.group(2).replace(",", ""))
|
||
# Username is the span just before the feedback span
|
||
if i > 0:
|
||
username = texts[i - 1].strip()
|
||
break
|
||
return username, count, ratio
|
||
|
||
|
||
def scrape_listings(html: str) -> list[Listing]:
|
||
"""Parse eBay search results HTML into Listing objects."""
|
||
soup = BeautifulSoup(html, "lxml")
|
||
results = []
|
||
|
||
for item in soup.select("li.s-card"):
|
||
# Skip promos: no data-listingid or title is "Shop on eBay"
|
||
platform_listing_id = item.get("data-listingid", "")
|
||
if not platform_listing_id:
|
||
continue
|
||
|
||
title_el = item.select_one("div.s-card__title")
|
||
if not title_el or "Shop on eBay" in title_el.get_text():
|
||
continue
|
||
|
||
link_el = item.select_one('a.s-card__link[href*="/itm/"]')
|
||
url = link_el["href"].split("?")[0] if link_el else ""
|
||
|
||
price_el = item.select_one("span.s-card__price")
|
||
price = _parse_price(price_el.get_text()) if price_el else 0.0
|
||
|
||
condition_el = item.select_one("div.s-card__subtitle")
|
||
condition = condition_el.get_text(strip=True).split("·")[0].strip().lower() if condition_el else ""
|
||
|
||
seller_username, _, _ = _extract_seller_from_card(item)
|
||
|
||
img_el = item.select_one("img.s-card__image")
|
||
photo_url = img_el.get("src") or img_el.get("data-src") or "" if img_el else ""
|
||
|
||
# Auction detection via time-left text patterns in card spans
|
||
time_remaining = None
|
||
for span in item.select("span.su-styled-text"):
|
||
t = span.get_text(strip=True)
|
||
td = _parse_time_left(t)
|
||
if td:
|
||
time_remaining = td
|
||
break
|
||
buying_format = "auction" if time_remaining is not None else "fixed_price"
|
||
ends_at = (datetime.now(timezone.utc) + time_remaining).isoformat() if time_remaining else None
|
||
|
||
results.append(Listing(
|
||
platform="ebay",
|
||
platform_listing_id=platform_listing_id,
|
||
title=title_el.get_text(strip=True),
|
||
price=price,
|
||
currency="USD",
|
||
condition=condition,
|
||
seller_platform_id=seller_username,
|
||
url=url,
|
||
photo_urls=[photo_url] if photo_url else [],
|
||
listing_age_days=0,
|
||
buying_format=buying_format,
|
||
ends_at=ends_at,
|
||
))
|
||
|
||
return results
|
||
|
||
|
||
def scrape_sellers(html: str) -> dict[str, Seller]:
|
||
"""Extract Seller objects from search results HTML.
|
||
|
||
Returns a dict keyed by username. account_age_days and category_history_json
|
||
are left empty — they require a separate seller profile page fetch, which
|
||
would mean one extra HTTP request per seller. That data gap is what separates
|
||
free (scraper) from paid (API) tier.
|
||
"""
|
||
soup = BeautifulSoup(html, "lxml")
|
||
sellers: dict[str, Seller] = {}
|
||
|
||
for item in soup.select("li.s-card"):
|
||
if not item.get("data-listingid"):
|
||
continue
|
||
username, count, ratio = _extract_seller_from_card(item)
|
||
if username and username not in sellers:
|
||
sellers[username] = Seller(
|
||
platform="ebay",
|
||
platform_seller_id=username,
|
||
username=username,
|
||
account_age_days=0, # not available from search HTML
|
||
feedback_count=count,
|
||
feedback_ratio=ratio,
|
||
category_history_json="{}", # not available from search HTML
|
||
)
|
||
|
||
return sellers
|
||
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# Adapter
|
||
# ---------------------------------------------------------------------------
|
||
|
||
class ScrapedEbayAdapter(PlatformAdapter):
|
||
"""
|
||
Scraper-based eBay adapter implementing PlatformAdapter with no API key.
|
||
|
||
Extracts seller feedback directly from search result cards — no extra
|
||
per-seller page requests. The two unavailable signals (account_age,
|
||
category_history) cause TrustScorer to set score_is_partial=True.
|
||
"""
|
||
|
||
def __init__(self, store: Store, delay: float = 1.0):
|
||
self._store = store
|
||
self._delay = delay
|
||
|
||
def _get(self, params: dict) -> str:
|
||
"""Fetch eBay search HTML via a stealthed Playwright Chromium instance.
|
||
|
||
Uses Xvfb virtual display (headless=False) to avoid Kasada's headless
|
||
detection — same pattern as other CF scrapers that face JS challenges.
|
||
|
||
Results are cached for _HTML_CACHE_TTL seconds so repeated searches
|
||
for the same query return immediately without re-scraping.
|
||
"""
|
||
url = EBAY_SEARCH_URL + "?" + "&".join(f"{k}={v}" for k, v in params.items())
|
||
|
||
cached = _html_cache.get(url)
|
||
if cached and time.time() < cached[1]:
|
||
return cached[0]
|
||
|
||
time.sleep(self._delay)
|
||
|
||
import subprocess, os
|
||
display_num = next(_display_counter)
|
||
display = f":{display_num}"
|
||
xvfb = subprocess.Popen(
|
||
["Xvfb", display, "-screen", "0", "1280x800x24"],
|
||
stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
|
||
)
|
||
env = os.environ.copy()
|
||
env["DISPLAY"] = display
|
||
|
||
try:
|
||
with sync_playwright() as pw:
|
||
browser = pw.chromium.launch(
|
||
headless=False,
|
||
env=env,
|
||
args=["--no-sandbox", "--disable-dev-shm-usage"],
|
||
)
|
||
ctx = browser.new_context(
|
||
user_agent=_HEADERS["User-Agent"],
|
||
viewport={"width": 1280, "height": 800},
|
||
)
|
||
page = ctx.new_page()
|
||
Stealth().apply_stealth_sync(page)
|
||
page.goto(url, wait_until="domcontentloaded", timeout=30_000)
|
||
page.wait_for_timeout(2000) # let any JS challenges resolve
|
||
html = page.content()
|
||
browser.close()
|
||
finally:
|
||
xvfb.terminate()
|
||
xvfb.wait()
|
||
|
||
_html_cache[url] = (html, time.time() + _HTML_CACHE_TTL)
|
||
return html
|
||
|
||
def search(self, query: str, filters: SearchFilters) -> list[Listing]:
|
||
params: dict = {"_nkw": query, "_sop": "15", "_ipg": "48"}
|
||
|
||
if filters.max_price:
|
||
params["_udhi"] = str(filters.max_price)
|
||
if filters.min_price:
|
||
params["_udlo"] = str(filters.min_price)
|
||
if filters.condition:
|
||
cond_map = {
|
||
"new": "1000", "used": "3000",
|
||
"open box": "2500", "for parts": "7000",
|
||
}
|
||
codes = [cond_map[c] for c in filters.condition if c in cond_map]
|
||
if codes:
|
||
params["LH_ItemCondition"] = "|".join(codes)
|
||
|
||
html = self._get(params)
|
||
listings = scrape_listings(html)
|
||
|
||
# Cache seller objects extracted from the same page
|
||
self._store.save_sellers(list(scrape_sellers(html).values()))
|
||
|
||
return listings
|
||
|
||
def get_seller(self, seller_platform_id: str) -> Optional[Seller]:
|
||
# Sellers are pre-populated during search(); no extra fetch needed
|
||
return self._store.get_seller("ebay", seller_platform_id)
|
||
|
||
def get_completed_sales(self, query: str) -> list[Listing]:
|
||
query_hash = hashlib.md5(query.encode()).hexdigest()
|
||
if self._store.get_market_comp("ebay", query_hash):
|
||
return [] # cache hit — comp already stored
|
||
|
||
params = {
|
||
"_nkw": query,
|
||
"LH_Sold": "1",
|
||
"LH_Complete": "1",
|
||
"_sop": "13", # price + shipping: lowest first
|
||
"_ipg": "48",
|
||
}
|
||
try:
|
||
html = self._get(params)
|
||
listings = scrape_listings(html)
|
||
prices = sorted(l.price for l in listings if l.price > 0)
|
||
if prices:
|
||
median = prices[len(prices) // 2]
|
||
self._store.save_market_comp(MarketComp(
|
||
platform="ebay",
|
||
query_hash=query_hash,
|
||
median_price=median,
|
||
sample_count=len(prices),
|
||
expires_at=(datetime.now(timezone.utc) + timedelta(hours=6)).isoformat(),
|
||
))
|
||
return listings
|
||
except Exception:
|
||
return []
|