BUYGUARD

Privacy-first browser extension and local toolkit for spotting potentially misleading marketplace listings, price bait, hidden conditions and risky purchase patterns - rule-based first, optional AI later.

Estensione browser e toolkit locale orientati alla privacy per segnalare annunci potenzialmente fuorvianti, price bait, condizioni nascoste e pattern di acquisto rischiosi - prima regole deterministiche, AI opzionale in seguito.

Project status | Stato del progetto

Browser beta v0.2.0-beta.1. The extension reads page-published metadata on Vinted domains and locally applies two narrow text rules: PHOTO_ONLY and EXTERNAL_PAYMENT. It shows exact quoted wording, limitations, Italian/English explanations, and a report draft the person can edit. Vinted Italy reporting guidance is available only for vinted.it. No listing content is sent or stored by default. This beta does not inspect images, read the full listing reliably, provide numeric confidence, or guarantee safety.

Beta browser v0.2.0-beta.1. L'estensione legge i metadati pubblicati dalla pagina sui domini Vinted e applica localmente due regole testuali circoscritte: PHOTO_ONLY ed EXTERNAL_PAYMENT. Mostra citazioni esatte, limiti, spiegazioni in italiano/inglese e una bozza modificabile dalla persona. La guida alla segnalazione Vinted Italia e disponibile solo per vinted.it. Il contenuto dell'annuncio non viene inviato o salvato per default. La beta non analizza immagini, non legge in modo affidabile l'intero annuncio, non mostra confidenza numerica e non garantisce sicurezza.

Try the beta | Prova la beta

1. Download buyguard-browser-v0.2.0-beta.1.zip and its .sha256 file from the beta release, then compare the SHA-256 digest. Alternatively, build from source with Node 22+, pnpm 10 and pnpm install --frozen-lockfile && pnpm check && pnpm build.

2. Unzip the package. In Chrome or a compatible Chromium browser, open chrome://extensions, enable Developer mode and choose Load unpacked for the unzipped folder containing manifest.json. This is a development beta, not a Chrome Web Store listing.

3. Open a Vinted listing, click the BUYGUARD toolbar icon to open the side panel, choose Italiano or English and click Analyze page. Review the quoted words and edit any draft before reporting through Vinted yourself.

4. Scarica buyguard-browser-v0.2.0-beta.1.zip e il file .sha256 dalla release beta, poi confronta il digest SHA-256. In alternativa, compila dal sorgente con Node 22+, pnpm 10 e pnpm install --frozen-lockfile && pnpm check && pnpm build.

5. Estrai lo ZIP. In Chrome o un browser Chromium compatibile apri chrome://extensions, attiva la Modalita sviluppatore e scegli Carica estensione non pacchettizzata selezionando la cartella estratta che contiene manifest.json. Questa e una beta di sviluppo, non una pubblicazione sul Chrome Web Store.

6. Apri un annuncio Vinted, fai clic sull'icona BUYGUARD per aprire il pannello, scegli Italiano o English e premi Analizza la pagina. Controlla le citazioni e modifica la bozza prima di segnalare personalmente tramite Vinted.

The two rules were checked against synthetic development examples; the 90% precision target has not been measured on a representative independent dataset. A missing signal is not a safety finding.

Le due regole sono state controllate su esempi sintetici di sviluppo; il target del 90% di precisione non e stato misurato su un dataset indipendente rappresentativo. L'assenza di segnali non e una valutazione di sicurezza.

What BUYGUARD will do | Cosa fara BUYGUARD

• Analyze a listing page locally and show evidence-led visual and textual signals.

• Start with Chrome, Chromium and Edge through Manifest V3.

• Run deterministic detectors first: PHOTO_ONLY, SUBSTITUTE_ITEM, PRICE_BAIT, UNOFFICIAL_AUCTION, EXTERNAL_PAYMENT, OBJECT_MISMATCH and DISCLOSURE_BURIED.

• Prepare sourced, editable report guidance for supported marketplace and jurisdiction contexts.

• Provide web, desktop and local tools for user-supplied HTML, screenshots and text, with safe URL handling.

• Keep cloud AI disabled by default and optional through a replaceable provider gateway.

• Analizzare localmente una pagina di annuncio e mostrare segnali visivi e testuali basati su evidenze.

• Partire da Chrome, Chromium e Edge tramite Manifest V3.

• Usare prima detector deterministici: PHOTO_ONLY, SUBSTITUTE_ITEM, PRICE_BAIT, UNOFFICIAL_AUCTION, EXTERNAL_PAYMENT, OBJECT_MISMATCH e DISCLOSURE_BURIED.

• Preparare guide alla segnalazione documentate e modificabili per contesti marketplace e giurisdizioni supportate.

• Offrire strumenti web, desktop e locali per HTML, screenshot e testo forniti dall'utente, con gestione sicura degli URL.

• Mantenere la AI cloud disabilitata per impostazione predefinita e opzionale tramite un provider gateway sostituibile.

Principles | Principi

1. Browser-first and local-first. The browser extension is the first product. Mobile companions come later and reuse the core.

2. No AI required. The MVP works without an account, API key or AI request.

3. Evidence, not accusations. A risk signal explains its evidence and never labels a seller as a fraudster or makes legal conclusions.

4. Human-controlled reporting. BUYGUARD prepares evidence and instructions; the user reviews and submits through official channels.

5. Platform respect. No botting, mass scraping, protection bypasses, automatic purchases, credential capture, keylogging or continuous screen recording.

6. Minimal data. Listing content is not stored by default; telemetry is opt-in and minimized.

7. Browser-first e local-first. L'estensione browser e il primo prodotto. I companion mobile arriveranno dopo e riuseranno il core.

8. AI non richiesta. L'MVP funziona senza account, API key o richieste AI.

9. Evidenze, non accuse. Un segnale di rischio spiega le proprie evidenze e non definisce un venditore truffatore ne trae conclusioni legali.

10. Segnalazione controllata dalla persona. BUYGUARD prepara evidenze e istruzioni; l'utente verifica e invia tramite i canali ufficiali.

11. Rispetto delle piattaforme. Niente bot, scraping massivo, bypass di protezioni, acquisti automatici, cattura credenziali, keylogging o registrazione continua dello schermo.

12. Dati minimi. Il contenuto degli annunci non viene salvato per default; la telemetria e opt-in e ridotta al minimo.

Architecture | Architettura

The monorepo separates applications, platform adapters and reusable analysis packages. The canonical data flow is:

Page or local input -> platform adapter -> canonical Listing -> deterministic analysis -> policy context -> signals and report guidance -> optional AI review

Pagina o input locale -> adapter piattaforma -> Listing canonico -> analisi deterministica -> contesto policy -> segnali e guida alla segnalazione -> revisione AI opzionale

Read ARCHITECTURE.md for boundaries, docs/PRODUCT_REVIEW_V3.md for the revised product, and docs/impact-and-evaluation.md for the meaning of the 90% target.

Leggere ARCHITECTURE.md per i confini, docs/PRODUCT_REVIEW_V3.md per il prodotto rivisto e docs/impact-and-evaluation.md per il significato del target 90%.

Official-source research and the first editable reporting guides are in docs/research and docs/reporting-playbooks.

La ricerca su fonti ufficiali e le prime guide modificabili alla segnalazione sono in docs/research e docs/reporting-playbooks.

Repository layout | Struttura della repository

apps/       Product entry points: extension, local tool, future mobile companions
packages/   Reusable domain and analysis modules
docs/       Product requirements, detector specifications, platform rules and ADRs
fixtures/   Sanitized positive, negative and borderline test listings
tests/      Cross-package integration and end-to-end tests
.github/    CI, security automation and repository templates

Privacy and security | Privacy e sicurezza

Read PRIVACY.md, SECURITY.md and THREAT_MODEL.md before implementing a connector, persistence layer or AI provider. AI and outbound network actions require an explicit user choice and a clear disclosure of the data sent.

Leggere PRIVACY.md, SECURITY.md e THREAT_MODEL.md prima di implementare un connettore, un livello di persistenza o un provider AI. La AI e le azioni di rete in uscita richiedono una scelta esplicita dell'utente e una chiara informativa sui dati inviati.

License and contributions | Licenza e contributi

Code and documentation are licensed under Apache-2.0. Redistribution must preserve the applicable license, copyright and NOTICE attribution. CITATION.cff gives a recommended project citation; it does not add a license obligation. Brand use is covered separately in TRADEMARK.md. See COPYRIGHT.md, THIRD_PARTY_NOTICES.md and CONTRIBUTING.md.

Codice e documentazione sono concessi con Apache-2.0. La ridistribuzione deve conservare licenza, copyright e attribuzioni applicabili in NOTICE. CITATION.cff propone una citazione del progetto; non aggiunge obblighi di licenza. L'uso del brand e disciplinato separatamente in TRADEMARK.md. Vedere COPYRIGHT.md, THIRD_PARTY_NOTICES.md e CONTRIBUTING.md.

Provenance and commercial interest | Provenienza e interesse commerciale

The beta ZIP has a SHA-256 checksum and a detached SSH signature (.zip.sig). Its .pub key matched an authentication key listed on MRJonam91's GitHub profile at publication; compare the key yourself before trusting it. The release notes give verification commands. The GitHub merge commit is verified, while the release tag itself is unsigned. GitHub Actions is disabled for this account, so this beta has no build attestation. There are no covert identifiers or private keys inside the public code or extension; removable text markers are not proof of ownership.

Lo ZIP beta ha un checksum SHA-256 e una firma SSH separata (.zip.sig). La chiave .pub corrispondeva a una chiave di autenticazione elencata sul profilo GitHub di MRJonam91 al momento della pubblicazione: confrontala prima di considerarla attendibile. Le note di rilascio contengono i comandi di verifica. Il commit di merge GitHub e verificato, mentre il tag di release non e firmato. GitHub Actions e disabilitato per questo account, quindi questa beta non ha attestazione della build. Nel codice pubblico e nell'estensione non ci sono identificatori occulti o chiavi private; marcatori testuali rimovibili non provano la titolarita.

The owner is open to inquiries about acquiring the project or arranging separate commercial terms. Contact the owner through the GitHub profile. Any transaction would need a separate written agreement and review of contributor and third-party rights; rights already granted under Apache-2.0 remain in force.

Il titolare e disponibile a valutare proposte di acquisto del progetto o condizioni commerciali separate. Contattarlo tramite il profilo GitHub. Ogni operazione richiede un accordo scritto separato e la verifica dei diritti di contributori e terze parti; restano validi i diritti gia concessi da Apache-2.0.

Support and funding | Supporto e sostegno

For help, see SUPPORT.md; report vulnerabilities through SECURITY.md. Optional support is available through the repository Sponsor button, GitHub Sponsors, Ko-fi, Buy Me a Coffee or PayPal, subject to each service's availability. Donations grant no extra rights.

Per assistenza vedere SUPPORT.md; segnalare vulnerabilita tramite SECURITY.md. Il sostegno facoltativo e disponibile tramite il pulsante Sponsor della repository, GitHub Sponsors, Ko-fi, Buy Me a Coffee o PayPal, secondo la disponibilita dei servizi. Le donazioni non attribuiscono diritti aggiuntivi.

Limitations and disclaimer | Limiti e disclaimer

BUYGUARD provides decision-support signals, not legal, financial, safety or fraud determinations. A LOW score is not a guarantee; a HIGH score is not proof of wrongdoing. Users remain responsible for reviewing a listing and using marketplace safeguards.

BUYGUARD fornisce segnali di supporto alla decisione, non determinazioni legali, finanziarie, di sicurezza o di frode. Un punteggio LOW non e una garanzia; un punteggio HIGH non e prova di illecito. L'utente resta responsabile della valutazione dell'annuncio e dell'uso delle tutele del marketplace.