MAHMOUD ABDELNABY
Seo · CLI SCRIPT · 2

Arabic Schema.org JSON-LD Linter & Entity Validator

Validate JSON-LD syntax and flag selected Arabic text or encoding issues. Passing checks cannot guarantee rich results or search eligibility.

Problem it addresses

Build an Arabic-focused Schema.org JSON-LD linter in pure Python. It must validate: 1) UTF-8 encoding and character escaping for Arabic text, 2) Schema.org Organization, LocalBusiness, Product, and FAQPage schemas, 3) Middle East specific business fields (taxID, vatID, addressCountry, telephone E.164). Include 12 pre-tested JSON-LD templates.

Who it is for

BOTH 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
  • README.md
  • src/schema_linter.py
  • templates/ecommerce-product-salla-zid.json
  • templates/local-business-ksa-eg.json
  • templates/organization-bilingual.json
  • 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/schema_linter.py --help

Scope and limitations

  • Valid Schema.org Types: Validates standard schema vocabularies including Organization, LocalBusiness, Product, and FAQPage.
  • Arabic UTF-8 & Right-to-Left Encoding: Ensures JSON-LD entity names, descriptions, and localized strings are properly formatted in UTF-8 without corrupting Arabic characters.
  • MENA Regional Business Identifiers: Supports regional business fields such as VAT registration (taxID), commercial registration numbers, and E.164 regional phone formats.

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

Related repositories