Skip to content

Flag Circulars

Flag-state circulars, current.

Never wonder whether the local library is behind the authority’s website again.

flag statedifferential syncdocument registryPanamaSingapore MPA

What it does

The Flag Circulars skill keeps the local document library current with official maritime circulars from flag-state authorities. It checks each authority’s website, identifies new circulars, downloads them, and registers them so they become searchable. Each flag has a dedicated scraper — new flags are auto-discovered without config changes.

Supported flags: Panama, Singapore (MPA), Hong Kong, Marshall Islands, Liberia, Malta, Bahamas.

How it works

  1. Status check — shows current sync state per flag: last run timestamp, total circulars downloaded, count of new circulars waiting.
  2. Differential download — compares the authority’s published index against the local registry and fetches only what’s new. Existing circulars are not re-fetched.
  3. Registry update — each new circular is registered with its number, title, issue date, and source URL.
  4. Notification — a summary email goes to the maritime team listing what was added.

Output

  • Newly downloaded circular PDFs in the document library
  • Registry entries linking each PDF to its metadata
  • A per-flag status report with sync state and counts