Skip to content

Releases: williamtcastro/nota-parser

Release list

v1.0.0 - Initial Release: The Structural NFC-e Scraper

v1.0.0 - Initial Release: The Structural NFC-e Scraper Latest
Latest

Choose a tag to compare

View all tags
@williamtcastro williamtcastro released this 03 Mar 03:02
v1.0.0
bcc7a58
This commit was signed with the committer’s verified signature.
williamtcastro William de Castro
GPG key ID: 762E18FC2CF0CDF7
Verified
Learn about vigilant mode.

We are excited to announce the initial release of NFC-e QRCode Portal Scraper (nota-parser)! 🎉

State SEFAZ portals rarely provide open APIs for consumers to extract their own receipt data. This project solves that problem by providing a fast, highly-resilient scraping API that turns standard NFC-e QRCode URLs into clean, structured JSON.

✨ Key Features

  • Structural Heuristics: The scraper uses raw DOM parsing via Cheerio, relying on structural logic rather than fragile text strings, meaning it won't break if a state changes "Total a Pagar" to "Total".
  • Strict Validation: Every parsed payload is strictly validated using Zod.
  • Lightning Fast: Built on Bun and Elysia for sub-millisecond route handling.
  • Docker Ready: Ships with a multi-stage Dockerfile that builds down into a tiny, standalone Alpine binary.
  • CLI Agent: Can be run completely detached from the web server as a CLI script for local batch processing.

🌎 Supported States

  • Minas Gerais (MG): Fully supported and rigorously tested with anonymized structural HTML fixtures.

🤝 Call for Contributions

The architecture of this project is explicitly modular. If you live in SP, RJ, RS, or any other state, we highly encourage you to fork this repo and write an adapter for your local SEFAZ portal! Check out our Development Guidelines to get started.

Note: This project was heavily "vibe-coded" using AI to quickly generate robust DOM-traversal heuristics and boilerplate! 🤖✨

Assets 2
Loading