Post-Publish Monitoring
Track citations, detect decay, stay visible
Publishing is step one. AEOForged's monitoring system tracks your content across Brave AI, Google AI Overviews, and Perplexity — detecting when you gain or lose citations, when your AEO score decays, and when competitors overtake your position. Alerts fire in real time so you can act before traffic drops.
Setup
Register any URL you want to monitor. You can do this from your agent or via the API directly.
Via MCP (agent)
Call the aeo_track tool with the URL and one or more target queries. Your agent can register URLs as part of a publish workflow.
aeo_track url: "https://example.com/my-guide" queries: ["answer engine optimization", "AEO tips"]
Via REST API
Send a POST to /api/v1/track with your API key. Useful for CI/CD pipelines, batch registration, or custom integrations.
POST /api/v1/track
{
"url": "https://example.com/my-guide",
"queries": ["answer engine optimization"]
}What Gets Tracked
Citations per engine
Whether your URL appears in Brave AI, Google AI Overviews, or Perplexity results for tracked queries.
Position in results
Where your content ranks within the AI-generated answer — first source cited, second, inline reference, etc.
Score over time
AEO score re-evaluated on each check. Trend line shows whether content quality is holding, improving, or decaying.
Time-to-first-citation
How long after publishing before an answer engine first references your content. Key metric for content velocity.
Alerts
Alerts fire when a meaningful change is detected. They're grouped into a 24-hour digest so you get one notification per day, not a flood.
| Type | Severity | Description |
|---|---|---|
first_cited | info | Your content was cited by an answer engine for the first time. |
lost_citation | critical | A previously held citation disappeared from an engine's results. |
position_improved | info | Your content moved to a more prominent position in AI answers. |
position_dropped | warning | Your content dropped to a lower position or moved from primary to inline reference. |
score_decayed | critical | AEO score fell below your configured threshold since the last check. |
content_stale | warning | Content hasn't been updated in a configurable window and freshness signals are weakening. |
milestone | info | A tracked URL hit a milestone — 10 citations, 30-day streak, top position held, etc. |
Dashboard
/monitoring
Overview of all tracked URLs. Sortable by score, citation count, last checked, and alert status. Quick-glance health indicators show which content needs attention.
/monitoring/[id]
Per-URL detail view. Full check history, citation timeline per engine, score trend chart, position changes, and all alerts for that URL.
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/track | Register a URL for monitoring |
| GET | /api/v1/track | List all tracked URLs |
| GET | /api/v1/track/:id | Get tracking detail for a single URL |
| DELETE | /api/v1/track/:id | Stop tracking a URL |
| GET | /api/v1/track/:id/checks | Check history for a URL |
| GET | /api/v1/track/:id/alerts | Alerts for a tracked URL |
| GET | /api/v1/alerts | All alerts (filterable by severity/type) |
| POST | /api/v1/alerts/:id/dismiss | Dismiss an alert |
Cron Schedule
Monitoring checks run automatically. Both are triggered by cron endpoints secured with CRON_SECRET.
Citation checks
Runs daily. Queries each tracked URL against Brave AI, Google AI Overviews, and Perplexity. Records citation presence, position, and any changes since the last check.
Decay checks
Runs daily. Re-scores tracked content and compares against the previous score. Fires score_decayed and content_stale alerts when thresholds are breached.
Share of Voice
Share of Voice tracking is now available via the aeo_share_of_voice tool — measure your client's percentage of AI answer visibility vs competitors across multiple engines. Track up to 20 keywords against 5 competitor domains across Brave, Google AI, and Perplexity. Returns SOV %, coverage gaps, and domination keywords. Best run monthly alongside your citation monitoring for a complete visibility picture.
Start tracking your content
Register your first URL and see how answer engines treat your content.