---
name: macro-scout
description: >-
  Use Macro Scout — web verification API (screenshots, assert, crawl, extract,
  browser facts). Separate from the CMS SDK. Use when calling api.scout,
  sk_scout_ keys, @macrocontent/scout, scout-cli, or scout-action.
---

# Macro Scout

Separate product from the macrocontent CMS. Do not confuse with other public “Scout” projects.

## Agent entrypoints (fetch these — not HTML alone)

| Resource | URL |
|----------|-----|
| Scout brief | https://docs.macrocontent.dev/scout.md |
| Setup | https://docs.macrocontent.dev/scout/setup.md |
| Auth | https://docs.macrocontent.dev/scout/auth.md |
| **OpenAPI** | https://api.scout.macrocontent.dev/openapi.json |
| OpenAPI mirror | https://docs.macrocontent.dev/openapi/scout.json |
| Full docs TOC | https://docs.macrocontent.dev/llms.txt |

HTML handbook (humans / richer prose): https://docs.macrocontent.dev/scout/

## Hosts

- API: `https://api.scout.macrocontent.dev`
- Console (keys UI): early access / may be separate host — do not invent paths; use docs + OpenAPI
- Auth: `Authorization: Bearer sk_scout_…` or `X-Scout-Key: sk_scout_…`

## Clients

- `@macrocontent/scout` (npm)
- `@macrocontent/scout-cli` (npm)
- `macrocontent/scout-action` (GitHub Action)
- `macrocontent-scout` (PyPI when published)

## Rules

1. Fetch **OpenAPI JSON** before inventing endpoints — never scrape Swagger UI HTML.
2. Prefer `scout.md` / `setup.md` / `auth.md` over fetching `/scout/` HTML when the tool only handles markdown/plain text.
3. Scout keys are server secrets — never in `macro.config.js` or browser bundles.
4. Empty credits → `402`; rate limit → `429` (different).
5. Production hosts only in customer-facing examples (`api.scout.macrocontent.dev`).