Yandex

Yandex Market YML Feed Generator for Medusa

A Medusa plugin that generates a product feed in YML (Yandex Market Language) format.

Features

• ✅ Export product feeds in Yandex Market YML format
• ✅ Easily access feed URLs for integration with Yandex Market
• ✅ Internalized interface in Medusa Admin
• ✅ Schedule automatic feed exports at intervals
• ✅ Select specific product categories for export
• ✅ Manual feed generation
• ✅ Uses Medusa File Module with built-in file provider support

💬 Support & Community on Telegram

Join the Medusa Telegram community chat to discuss features, get support, and connect with developers building on Medusa.

Prerequisites

• Medusa server v2.8.0 or later
• Node.js v20 or later

Installation

123
yarn add @gorgo/medusa-feed-yandex
# or
npm install @gorgo/medusa-feed-yandex

Configuration

Add the provider configuration in your Copy to clipboardmedusa-config.js file of the Medusa admin application:

1234567891011121314151617181920
# ...
module.exports = defineConfig({
  # ...
  modules: [
    {
      resolve: "@gorgo/medusa-feed-yandex/modules/feed",
    },
    {
      resolve: "@medusajs/medusa/file",
      options: {
        providers: [
          {
            resolve: "@medusajs/medusa/file-local",
            id: "local",
            options: {
              upload_dir: "static",
              backend_url: "http://localhost:9000/static"
            },
          },
        ],

The plugin is currently tested with Medusa’s local file module (Copy to clipboardfile-local) and saves the generated XML feeds to the local static directory.

Usage

Open the Medusa Admin dashboard and navigate to Settings -> Feeds section in the Extensions — this is where the plugin interface is available.

The page displays all existing feeds with their key information.

Feed URLs follow this format, allowing direct access to the generated XML files (in YML format):

1
http://{YOUR_MEDUSA_DOMAIN}/feeds/{ID}/{FILE_NAME}.xml

Selecting a feed opens a detailed view where you can edit metadata, adjust export schedules, choose product categories, and access the feed URL. A Launch now button lets you manually trigger feed generation.

The feed shown in the screenshot above exports all product from all categories every 30 minutes to a file named Copy to clipboardexample1.xml. It sets Copy to clipboardExample shop name, Copy to clipboardExample company name, Copy to clipboardhttps://www.example.com/, and Copy to clipboardMedusa as values for the corresponding XML properties. It is accessible via the link Copy to clipboardhttp://localhost:9000/feeds/01JWTC5VDW8EAGHWRDQG2GKAQJ/example1.xml, while the actual file is stored in gzip-compressed format at Copy to clipboardhttp://localhost:9000/static/1748937061705-example1.xml.gz.

Below is an example of a generated YML-file:

1234567891011121314151617181920
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2025-06-03 16:31">
  <shop>
    <name>Example shop name</name>
    <company>Example company name</company>
    <url>https://www.example.com/</url>
    <platform>Medusa</platform>
    <categories>
      <category id="pcat_01JWBFYPTZNKZT0BRWECQF84J9" value="Shirts"/>
      <category id="pcat_01JWBFYPV0KQV6VY4HKW4W6JTN" value="Sweatshirts"/>
      <category id="pcat_01JWBFYPV16CG0MN8TF1EM4T4N" value="Pants"/>
      <category id="pcat_01JWBFYPV1CTZAK4JBKV0R2JZW" value="Merch"/>
    </categories>
    <offers>
      <offer id="prod_01JWBFYPVZ21W4XQRSPAVW3QBN">
        <name>Medusa T-Shirt</name>
        <categoryId>pcat_01JWBFYPTZNKZT0BRWECQF84J9</categoryId>
        <picture>https://medusa-public-images.s3.eu-west-1.amazonaws.com/tee-black-front.png</picture>
        <description>
          <![CDATA[Reimagine the feeling of a classic T-shirt. With our cotton T-shirts, everyday essentials no longer have to be ordinary.]]>

Testing

To run tests, navigate to the Copy to clipboardexamples/feed-yandex/medusa directory:

1
cd examples/feed-yandex/medusa

Make sure your Copy to clipboard.env.test file includes the following variables: Copy to clipboardDB_USERNAME, Copy to clipboardDB_PASSWORD:

1
cp .env.test.example .env.test

Then, run tests:

1234567
# Run module tests
# These verify the internal logic, such as services and models
yarn test:integration:modules

# Run integration tests
# Integration tests include tests for API Routes and Workflows
yarn test:integration:http

License

Licensed under the MIT License.