README

Any product page for omnisense/omnitrade: the page is fetched and its own markup read as an Omnitrade Product - the JSON-LD Product (or ProductGroup and its variants) most shops publish for search engines, else schema.org microdata, else the OpenGraph tags. No account, no key. And affiliate links, by host.

$gateway = (new WebGatewayFactory($http))->create([]);   // $http: the application's HTTP client; none given, the factory makes its own

No framework needed: the package requires omnisense/omnitrade and symfony/http-client. In a Symfony application, the same through the bundle's configuration:

omnitrade:
    gateways:
        web:
            factory: web
            options:
                currency: EUR                    # a price found without a currency
                affiliate:                       # host (or a suffix of it) => query parameters
                    amazon.fr: { tag: 'mysite-21' }
                    fnac.com: { awc: '1234_5678' }

$product = $registry->get('web')->fetchProduct('https://boutique.example/p/poussette-yoyo');
$product->title; $product->brand; $product->price(); $product->media[0]->url; $product->merchant->name;

$registry->get('web')->affiliateLink('https://www.amazon.fr/dp/B0C1234567?psc=1');   // …/dp/B0C1234567?tag=mysite-21

Nothing is bought here: supports(Purchase::class) is false, as for FetchProducts and FetchInventory (the web is not a catalogue to page through). See the manual, docs/index.md (the options, the addresses read, affiliate links, errors), and docs/reading-a-page.md for what is read where and the limits (pages drawn by JavaScript, shops that refuse robots).

Addresses are pasted by anyone: only http(s) is read, at most max_bytes, and never a machine of the local network unless allow_private says so.

Responsibility

This package is an independent client: it is not affiliated with, endorsed by or sponsored by any shop whose pages it reads, nor by any partner programme it writes links for. It reads a page on behalf of whoever runs it, and it does not redistribute what it reads beyond the short excerpts kept as test fixtures. Its MIT licence covers this package's code only and grants no right to the pages read or to their content.

Whoever installs and runs this package is responsible for complying with the terms of each site it reads (its robots rules and its conditions of use included) and of each partner programme whose links it writes, for obtaining whatever they require (an agreement, an attribution, a rate to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.

omnitrade / web

Package info

Security

Statistics

README

Responsibility