MAHMOUD ABDELNABY
E Commerce · CLI SCRIPT · 2

Amazon & Noon Regional Listing SEO & Keyword Parity Linter

Prevent Amazon and Noon listing suppression. Audit title length, bullet point formatting, and backend Arabic search terms in seconds.

Problem it addresses

Build an open-source marketplace listing optimization and linting CLI (marketplace_linter.py): 1) Validates title length (200 chars), bullet point count (5 bullets, 150-250 chars), and backend search terms (250 bytes limit, UTF-8 aware for Arabic characters), 2) Detects 100+ prohibited promotional terms, 3) Compares listing text against top competitor keyword lists to output a keyword coverage gap score.

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:

  • data/marketplace_rules.json
  • data/prohibited_terms_amazon_noon.json
  • examples/sample_product_listing.json
  • LICENSE
  • README.md
  • reports/listing_qa_report.json
  • src/marketplace_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/marketplace_linter.py --help

Scope and limitations

  • Backend Search Terms Limits: Enforces strict byte limits (249 bytes on Amazon.sa, 250 characters on Noon) without repeating words already in the title.
  • Bilingual Keyword Parity: Ensures high-volume Arabic search terms are present alongside English brand names in titles, bullet points, and A+ content.
  • Prohibited Promotional Phrases: Screens text to prevent terms like 'Best Seller', 'Free Shipping', or warranty claims that trigger listing suppression.

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

Related repositories