Compare commits
2 commits
0430454dad
...
0a93b7386a
| Author | SHA1 | Date | |
|---|---|---|---|
| 0a93b7386a | |||
| 860276420e |
2 changed files with 17 additions and 17 deletions
16
README.md
16
README.md
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
> *Part of the Circuit Forge LLC "AI for the tasks you hate most" suite.*
|
> *Part of the Circuit Forge LLC "AI for the tasks you hate most" suite.*
|
||||||
|
|
||||||
**Status:** Active — eBay listing search + seller trust scoring MVP complete. Auction sniping engine and multi-platform support are next.
|
**Status:** Active — eBay listing intelligence MVP complete (search, trust scoring, affiliate links, feedback FAB, vision task scheduling). Auction sniping engine and multi-platform support are next.
|
||||||
|
|
||||||
## What it does
|
## What it does
|
||||||
|
|
||||||
|
|
@ -68,6 +68,20 @@ Scans listing titles for signals the item may have undisclosed damage or problem
|
||||||
- **On-demand**: ↻ button on any listing card triggers `POST /api/enrich` — runs enrichment and re-scores without waiting for a second search
|
- **On-demand**: ↻ button on any listing card triggers `POST /api/enrich` — runs enrichment and re-scores without waiting for a second search
|
||||||
- **Category history**: derived from the seller's accumulated listing data (Browse API `categories` field); improves with every search, no extra API calls
|
- **Category history**: derived from the seller's accumulated listing data (Browse API `categories` field); improves with every search, no extra API calls
|
||||||
|
|
||||||
|
### Affiliate link builder
|
||||||
|
|
||||||
|
Listing cards surface eBay affiliate-wrapped URLs. Uses `circuitforge_core.affiliates.wrap_url` — resolution order: user opted out → plain URL; user has BYOK affiliate ID → their ID; CF env var set (`EBAY_AFFILIATE_ID`) → CF's ID; otherwise plain URL. Users can configure their own eBay Partner Network ID or opt out entirely in Settings.
|
||||||
|
|
||||||
|
Disclosure tooltip appears on first encounter per-session and on each wrapped link (per-retailer copy from `get_disclosure_text`).
|
||||||
|
|
||||||
|
### Feedback FAB
|
||||||
|
|
||||||
|
In-app feedback button (bottom-right FAB) opens a modal: title, description, optional screenshot. Posts to the CF feedback endpoint. Status probed on load; FAB hidden if endpoint unreachable.
|
||||||
|
|
||||||
|
### Vision task scheduling
|
||||||
|
|
||||||
|
Photo condition assessment tasks queued through `circuitforge_core.tasks.TaskScheduler` — VRAM-aware slot management shared with any other LLM workloads on the same host. Runs moondream2 locally (free tier) or Claude vision (paid/cloud). Results stored per-listing and update the trust score card.
|
||||||
|
|
||||||
### Market price comparison
|
### Market price comparison
|
||||||
Completed sales fetched via eBay Marketplace Insights API (with Browse API fallback for app tiers that don't have Insights access). Median stored per query hash, used to score `price_vs_market` across all listings in a search.
|
Completed sales fetched via eBay Marketplace Insights API (with Browse API fallback for app tiers that don't have Insights access). Median stored per query hash, used to score `price_vs_market` across all listings in a search.
|
||||||
|
|
||||||
|
|
|
||||||
18
api/main.py
18
api/main.py
|
|
@ -23,6 +23,7 @@ from pydantic import BaseModel
|
||||||
from fastapi.middleware.cors import CORSMiddleware
|
from fastapi.middleware.cors import CORSMiddleware
|
||||||
|
|
||||||
from circuitforge_core.config import load_env
|
from circuitforge_core.config import load_env
|
||||||
|
from circuitforge_core.affiliates import wrap_url as _wrap_affiliate_url
|
||||||
from app.db.store import Store
|
from app.db.store import Store
|
||||||
from app.db.models import SavedSearch as SavedSearchModel, ScammerEntry
|
from app.db.models import SavedSearch as SavedSearchModel, ScammerEntry
|
||||||
from app.platforms import SearchFilters
|
from app.platforms import SearchFilters
|
||||||
|
|
@ -69,21 +70,6 @@ def _ebay_creds() -> tuple[str, str, str]:
|
||||||
client_secret = (os.environ.get("EBAY_CERT_ID") or os.environ.get("EBAY_CLIENT_SECRET", "")).strip()
|
client_secret = (os.environ.get("EBAY_CERT_ID") or os.environ.get("EBAY_CLIENT_SECRET", "")).strip()
|
||||||
return client_id, client_secret, env
|
return client_id, client_secret, env
|
||||||
|
|
||||||
def _affiliate_url(url: str) -> str:
|
|
||||||
"""Append EPN affiliate params when EBAY_AFFILIATE_CAMPAIGN_ID is configured.
|
|
||||||
|
|
||||||
If the env var is absent or blank, the original URL is returned unchanged.
|
|
||||||
Params follow the standard EPN deep-link format; siteid=0 = US.
|
|
||||||
"""
|
|
||||||
campaign_id = os.environ.get("EBAY_AFFILIATE_CAMPAIGN_ID", "").strip()
|
|
||||||
if not campaign_id:
|
|
||||||
return url
|
|
||||||
sep = "&" if "?" in url else "?"
|
|
||||||
return (
|
|
||||||
f"{url}{sep}mkcid=1&mkrid=711-53200-19255-0"
|
|
||||||
f"&siteid=0&campid={campaign_id}&toolid=10001&mkevt=1"
|
|
||||||
)
|
|
||||||
|
|
||||||
|
|
||||||
app = FastAPI(title="Snipe API", version="0.1.0", lifespan=_lifespan)
|
app = FastAPI(title="Snipe API", version="0.1.0", lifespan=_lifespan)
|
||||||
app.include_router(ebay_webhook_router)
|
app.include_router(ebay_webhook_router)
|
||||||
|
|
@ -413,7 +399,7 @@ def search(
|
||||||
|
|
||||||
def _serialize_listing(l: object) -> dict:
|
def _serialize_listing(l: object) -> dict:
|
||||||
d = dataclasses.asdict(l)
|
d = dataclasses.asdict(l)
|
||||||
d["url"] = _affiliate_url(d["url"])
|
d["url"] = _wrap_affiliate_url(d["url"], retailer="ebay")
|
||||||
return d
|
return d
|
||||||
|
|
||||||
return {
|
return {
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue