03 · Selected work
Hawk AEO / NIGHTHAWK
An honest teaser that hands off to a product: free discovery, then a web interface, API, and Telegram bot. Not a third-party NightHawk trademark.
- Problem — Invisible in AI search; product never gets a chance.
- Built — Free discovery → web interface, API, and Telegram bot.
- Result — Live defence-aerospace product surfaces; no ranking claims.
- Your role — Builder / operator (ML-Nightworx).
hawk-aeo.ml-nightworx.io nighthawk.ml-nightworx.io nighthawk-api.ml-nightworx.io
“Hawk” here is ML-NIGHTWORX’s acquisition surface and product host. The case study evidence contains no files referencing Hawk Information Services NightHawk™. Do not conflate them.
Live with TLS and custom domains: hawk-aeo, NIGHTHAWK glass, nighthawk-api (v2.2), nighthawk-bot (v2.0).
Built and operated as an ML-NIGHTWORX product — not a named client engagement.
AEO → web interface with attributed handoff. Pages web product, API worker (21 endpoints, v2.2), Telegram @nighthawk_intel_bot (v2.0). GDELT + Gemini; Stripe checkout; USDC micropayments at $0.01/call; EIP-191 agent auth. Limitations are published on the consumer surfaces.
Affiliation with Hawk Information Services NightHawk™. Platform KPIs (tracked market, NATO share, programme percentages) as personal financial results. Named enterprise clients.
The system
NIGHTHAWK aggregates military-aircraft production forecasts, live global-defence events (GDELT / DELTA), and Gemini analysis into three delivery channels, plus a free discovery layer:
- HAWK AEO (Cloudflare Pages) — no auth, no API access. Teaser KPIs, FAQ chips, an eight-item programme catalogue, API health badge,
llms.txt, attributed handoff (src=aeo2+ UTM). - NIGHTHAWK glass — dashboard, API docs, payments, procurement, terms. Free tier 100 req/day, then Stripe or USDC.
- API worker — GDELT feeds, Gemini chat, Stripe, USDC agent deposits, key management, spending policy. Secrets stay server-side.
- Telegram bot — freemium cap,
/linkwallet for unlimited USDC-paid access,/briefdefence summary.
Data layers confirmed in code: HAWK1 military-aircraft CSV (97 programmes, 2015–2039); Teal Group rotorcraft forecast (84 programmes, 2025–2034); DELTA Cloud API v2 (24h window); Gemini 2.5 Flash default (2.5 Pro available). SIENNA audit methodology is documented on the about surface: duplicate groups resolved, 0% discrepancy on units × price = total value across audited rows.
Platform-published KPIs on HAWK AEO include tracked market $997B, 181 programmes, NATO 80.8%, F-35 26.8% of global market. Treat them as intel outputs of the product, not as ML-Nightworx revenue.
- Cloudflare Pages + Workers
- Workers KV
- GDELT Cloud API v2
- Gemini 2.5 Flash
- Stripe
- USDC · EIP-191
- Telegram Bot API
- GA4 (unified)
Design decisions worth copying
- Server-side secrets for GDELT, Gemini, Stripe, Telegram — never on the client.
- USDC contract-address enforcement on deposits (audit hardening).
- Canonical treasury address across API, bot, and static pages.
- Acquisition (AEO) separated from product. Teasers; no bulk data; no live feeds on the free surface.
- Blended monetisation: USDC pay-per-call with zero sign-up, API self-serve Free/Pro/Enterprise, consultative white-label escalator.
- HTTPS and security headers on Worker responses and both Pages projects.
- One GA4 property across AEO and glass, with cross-domain linker and handoff UTM.
- EIP-191 agent auth, nonce replay protection, spending-policy hard stops.
- Freemium bot with a persistent API key and wallet linking.
- Limitations baked into every consumer surface — not a footnote in a PDF.
Limitations (published with the product)
- Dataset is 4.5-gen sunset era only. Missing J-20, Su-57, PAK DA, NGAD, GCAP/FCAS, UCAV programmes.
- Surfaces state $250–400B hidden value outside the forecast; valid through 2028.
- Russia’s rotorcraft fleet is absent from the Teal data used.
- USDC verification is a static contract-address check — no native chain-deposit indexing.
- KV balance/rate increments use
waitUntil; cross-edge race is a documented theoretical/MEDIUM.
A standalone legacy dashboard file exists outside the sitemap and is not canonical. API worker apex/zone routes were intentionally removed in favour of the nighthawk-api host only.