MAHMOUD ABDELNABY
E Commerce · CLI SCRIPT · 2

Google Merchant Center Feed Diagnostics & Catalog Integrity Linter

Stop product disapprovals in Google Shopping. Audit XML and CSV product feeds against Google Merchant Center specifications in seconds.

Problem it addresses

Develop a pure Python Google Merchant Center feed linter (gmc_feed_linter.py): 1) Parses XML (RSS 2.0 / Atom) and TSV/CSV product feeds, 2) Validates mandatory attributes (id, title, description, link, image_link, availability, price with ISO currency, brand, gtin), 3) Checks for prohibited title formatting (ALL CAPS, marketing fluff), 4) Outputs an executive terminal error summary and CSV export of defective SKUs.

Who it is for

PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • LICENSE
  • playbooks/merchant-center-suspension-recovery.md
  • README.md
  • reports/sample_error_report.csv
  • sample_data/sample_broken_feed.xml
  • src/gmc_feed_linter.py
  • tests/test_linter.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/gmc_feed_linter.py --help

Scope and limitations

  • Mandatory XML/TSV Attribute Completeness: Validates presence of id, title, description, link, image_link, availability, price, gtin, and brand.
  • Currency & VAT Inclusivity: Enforces localized ISO 4217 currencies (SAR, AED, EGP) and mandates prices inclusive of statutory VAT for consumer feeds.
  • Google Taxonomy Categorization: Validates that product_type and google_product_category conform to Google's official taxonomy numerical IDs.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories