README

Generates an OpenAI (ChatGPT) product feed per store view so your Magento catalog can be discovered — and purchased — inside ChatGPT.

The exported CSV is compliant with the OpenAI Product Feed file-upload specification (Stable) and covers all Magento product types: simple, virtual, downloadable, configurable, bundle and grouped.

Features

Feed columns aligned with the OpenAI Product Feed file-upload specification (Stable): item_id, is_eligible_search, is_eligible_checkout, image_url, item_weight_unit, return_deadline_in_days, and more
All Magento product types: simple, virtual, downloadable, configurable, bundle, grouped
Configurable products exported as parent listing + child variant rows (group_id, variant_dict, item_group_title)
Grouped products linked via related_product_id / relationship_type
Digital goods flagged with is_digital
Fault-tolerant generation: failing products are logged and skipped, never abort the run
Dedicated log file: var/log/angeo_openai_feed.log
Optional attributes (media gallery, reviews, Q&A)
Test coverage

Requirements

PHP >= 8.1
Magento 2.4.x (Open Source or Adobe Commerce)

Installation

You can install this module as a Composer package.

composer require angeo/module-openai-product-feed
Run bin/magento setup:upgrade

As a module

Download latest release files and extract them under app/code/Angeo/OpenAiProductFeed
Run bin/magento setup:upgrade

Upgrading from 1.x

Version 2.0.0 is a breaking release. Feed columns were renamed to match the OpenAI specification (item_id, is_eligible_search, is_eligible_checkout, image_url, item_weight_unit, return_deadline_in_days, …) and ProductMapperInterface::map() now returns a list of rows. See CHANGELOG.md for the full list.

No data migration is needed: the enable_search / enable_checkout product attributes are unchanged — only the exported column names differ.

Configuration

You can find the module's configuration under Stores -> Settings -> Configuration -> Angeo: seller identity (name, URL, privacy policy, terms of service) and return policy (URL, return window in days). Per the OpenAI specification, seller_privacy_policy and seller_tos are required when checkout is enabled for a product.

Two product attributes control per-product eligibility (found in the "OpenAI Configurations" attribute group):

Enable Search → exported as is_eligible_search
Enable Checkout → exported as is_eligible_checkout (automatically forced to false in the feed when search is not enabled, per the specification)

Product Feed

To generate the product feeds manually, use the angeo:product-feed:generate Magento command:

  bin/magento angeo:product-feed:generate

A cron job (angeo_generate_openai_feed) also runs daily at 02:00.

Output file path, relative to the var directory: var/angeo/openai_feed/<store_code>.csv

Skipped products and per-store summaries are written to var/log/angeo_openai_feed.log.

Product type handling

Type	Behavior
Simple	One row
Virtual / Downloadable	One row, `is_digital=true`, no weight
Configurable	Parent row (`listing_has_variations=true`) + one row per enabled child with `group_id`, `item_group_title` and JSON `variant_dict`
Grouped	One row, minimal price, children listed in `related_product_id` with `relationship_type=part_of_set`
Bundle	One row, minimal ("from") price for dynamic bundles, fixed price otherwise

Contributing

Found a bug, have a feature suggestion or just want to help in general? Contributions are very welcome! Check out the list of active issues or submit one yourself.

Need help with agentic commerce for Magento? Professional support, AEO audits and implementation at angeo.dev. Check how your store looks to AI agents with the free scanner at api.angeo.dev.

Questions? Contact me at info@angeo.dev

angeo / module-openai-product-feed

Maintainers

Package info

Statistics

Security