# MSC Tracker API

> Web scraping API for MSC container tracking. Uses an anti-detect
> headless browser (Camoufox, a C++-patched Firefox) to bypass Akamai's
> bot protection. Returns JSON with the full tracking data plus a
> full-page screenshot (PNG, base64-encoded). Public access via
> Tailscale Funnel. Authenticated with a single shared API key.

This API is designed to replace legacy Node.js endpoints of the form
`http://<host>:<port>/track/{container}`. It is meant to be called from
cron jobs, server-side PHP/Node/Python, or any backend that needs to
query MSC's container tracking without being blocked.

Base URL: `https://miopenclaw-vnic.tail9799d2.ts.net/msc-api`

- API key (treat as a secret): `camaronnochacarron`
- Auth header: `X-Api-Key: <key>`
- Content-Type for POSTs: `application/json`
- TLS: always on (HTTPS via Tailscale)

## Getting Started

- [Overview](llms-full.txt#overview): What this is, who it's for, architecture
- [Authentication](llms-full.txt#authentication): How to authenticate
- [Quick Start](llms-full.txt#quick-start): First call in 30 seconds
- [Base URL](llms-full.txt#base-url): Where to send requests

## API Reference

- [GET /track/{container}](llms-full.txt#get-trackcontainer): Track a container (recommended endpoint, returns JSON + screenshot)
- [POST /api/track](llms-full.txt#post-apitrack): Same but POST with JSON body (no screenshot)
- [GET /api/containers](llms-full.txt#get-apicontainers): List containers in the persistent list
- [POST /api/containers](llms-full.txt#post-apicontainers): Add a container to the persistent list
- [PATCH /api/containers/{id}](llms-full.txt#patch-apicontainersid): Update a container's poll interval
- [DELETE /api/containers/{id}](llms-full.txt#delete-apicontainersid): Remove a container
- [POST /api/containers/{id}/track](llms-full.txt#post-apicontainersidtrack): Force a track now
- [GET /api/worker/status](llms-full.txt#get-apiworkerstatus): Health check
- [GET /api/worker/logs](llms-full.txt#get-apiworkerlogs): Last N log lines

## Reference

- [Response Format](llms-full.txt#response-format): JSON schema for tracking data
- [Error Codes](llms-full.txt#error-codes): What each HTTP status means
- [Rate Limits & Best Practices](llms-full.txt#rate-limits): How to avoid getting your IP blocked
- [Code Examples](llms-full.txt#code-examples): curl, Python, PHP, JavaScript
- [Migration Guide](llms-full.txt#migration): Replacing an old `/track/{container}` endpoint

## Operations

- [Worker Behavior](llms-full.txt#worker-behavior): What runs under the hood
- [Screenshot Format](llms-full.txt#screenshot-format): How the image is encoded
- [Caching](llms-full.txt#caching): When the same response is reused
- [Troubleshooting](llms-full.txt#troubleshooting): Common error patterns