A local-first Python tool for static ecommerce sites and Jamstack storefronts. It scans your markdown and MDX product files, compares promotional end-dates against the current time, and strips expired sale tags, discount banners, and clearance frontmatter—creating automatic .bak safety backups before touching any file.
Directory of markdown (.md/.mdx) product or promotion files.
Local Python script parses YAML frontmatter dates, identifies expired promos, and strips tags.
Cleaned markdown files, automatic .bak backup files, and markdown_cleanup_summary.json.
Setup scope covers installation on customer-controlled infrastructure, configuration of authorised integrations, functional testing and handover.
Hosting, third-party charges and ongoing support are excluded unless separately agreed. Free workflows must never run on Sanocea-hosted infrastructure.
After seasonal sales (like Diwali or Black Friday) end, clearance tags and promo badges linger on markdown product pages, confusing customers who expect expired discounts.
Leaving expired promo banners on your website damages credibility, creates customer service complaints, and leads to checkout discount disputes.
Scans your product markdown directory, checks promotion end-dates in frontmatter, creates a .bak backup file, and strips expired promotional tags cleanly.
Your site automatically clears expired promotional copy on time, without developers manually editing dozens of markdown files.
Shows how expired Diwali or Black Friday tags are stripped from a product markdown file.
---
title: "Handmade Brass Table Lamp"
price: 1899
tags:
- home-decor
- clearance-sale-diwali-2024
promo_expires: "2024-11-15"
------
title: "Handmade Brass Table Lamp"
price: 1899
tags:
- home-decor
---
[Safety copy created at lamp.md.bak]Expired clearance tag removed cleanly. Original preserved in lamp.md.bak.
Technical Setup Guidance:
Every deliverable is clean, self-contained, and ready for immediate deployment. You receive the complete files, configuration templates, setup guides, and automated tests.
| File Name | Deliverable Description |
|---|---|
clearance_scheduler.py | Core markdown clearance tag cleaner and campaign expiry engine |
run.sh | Execution wrapper script |
requirements.txt | Test execution requirements (standard library only for runtime) |
README.md | Operational usage guide & schema specifications |
SETUP.md | Step‑by‑step local setup instructions & cron scheduling |
COSTS.md | Zero recurring cost declaration |
LICENSING.md | Sanocea Commercial License |
tests/test_clearance_scheduler.py | Pytest suite covering frontmatter, HTML blocks, inline tags, and backups |
data/catalog_markdown/linen_shirt.md | Sample product with frontmatter clearance tags |
data/catalog_markdown/denim_jacket.md | Sample product with timed HTML banner block |
data/catalog_markdown/silk_scarf.md | Sample product with active future promotion |
data/catalog_markdown/chelsea_boots.md | Sample clean catalog item |
For technical teams or developers assisting your business, below is the visual execution architecture and automated verification breakdown:
The script parses YAML frontmatter tag arrays, sanitizes status and boolean attributes, strips timed HTML comment banners, and removes inline tags while generating automatic .bak backups.
Parses YAML header arrays and attributes to remove expired campaign markers without corrupting file structure
Evaluates expires attributes on HTML comment blocks and strips expired banners while preserving active campaigns
Creates automatic timestamped .bak backups and outputs modified_files.csv and cleanup_summary.json
We believe in complete transparency. Review the documented technical boundaries and external service fee breakdown below prior to obtaining the package:
| Component | Estimated Cost | Details & Free Tier Allowances |
|---|---|---|
| Markdown Clearance-Tag Scheduler Toolkit | ₹0 (Free to self-host) | Download full source code and self-host |
| Optional Assisted Setup | ₹500 one-time | Assisted installation, environment setup, and handover |
| Hosting & Third-Party Fees | ₹0 recurring | Standard Python local execution, no third-party APIs needed |
Receive the complete distributable archive containing clearance_scheduler.py, step-by-step setup guides, mock fixtures, and automated test suites.
Setup scope covers installation on customer-controlled infrastructure, configuration of authorised integrations, functional testing and handover.
Hosting, third-party charges and ongoing support are excluded unless separately agreed. Free workflows must never run on Sanocea-hosted infrastructure.
The scheduler strips YAML frontmatter tags (e.g. tags: [clearance, ...]), updates status fields (status: clearance to status: active), removes timed HTML comment blocks (<!-- clearance:start -->...<!-- clearance:end -->), and removes inline @clearance markers.
Yes. If an HTML banner or inline tag includes an explicit expires="YYYY-MM-DD" attribute, the engine evaluates whether that date has passed. Active future promotions are preserved untouched.
Yes. By default, when --apply is passed, the engine creates an exact .bak copy of each modified file. You can disable this in version-controlled Git repos by passing --no-backup.
Yes. The tool runs locally via pure Python standard library with zero external dependencies, making it ideal for scheduled nightly cron jobs or automated Git CI/CD workflow triggers.
How expired promotion tags linger on headless commerce sites, why stale clearance callouts confuse buyers, and how scheduled cleaners sanitize frontmatter.
Read Field Guide on Sanocea Insights →A local-first Python tool that audits your Shopify catalog exports before publishing new products or syndicating to Google Shopping. It identifies duplicate SKUs, missing UPC/EAN barcodes, empty shipping weights, and discount pricing errors, quarantining flawed listings into an exception file with exact line numbers.
A local-first Python tool that prevents lost traffic and Google rankings when products are discontinued. When you unpublish out-of-stock items, it generates clean 301 redirect mappings pointing visitors and search bots to the closest relevant category or parent product, complete with cyclic redirect loop protection.
A local-first Python tool that solves the bundled kit inventory dilemma. It reads your component stock levels and kit recipe formulas (e.g. 1 Gift Box = 2 Soaps + 1 Towel + 1 Candle), calculates the exact limiting component, applies safety buffer reserves, and outputs true sellable bundle quantities to prevent overselling.
A local-first Python tool that solves artificial stockouts. When customers start checkout or place unpaid bank-transfer orders, inventory is often locked for days. This engine scans reservation timestamps, identifies orders exceeding your expiry threshold (e.g. 30 minutes for cart locks or 24 hours for unpaid wire orders), and outputs a release manifest to restock items for paying buyers.