Appearance
client-reporting
FreshSource: BIBLE.md (Phase 12 Phase 2, client-reporting 4 routes)
Auto-generated reports per client: ranks, clicks, links, activity, recommendations.
Routes (4)
| Method | Route | What |
|---|---|---|
| POST | /reports/generate | Generate report for a client |
| GET | /reports/:clientId | Latest report |
| GET | /reports/:clientId/history | Past reports |
| GET | /reports/:clientId/recommendations | Auto recommendations |
Example payload
bash
curl -X POST http://localhost:4700/reports/generate \
-H "Content-Type: application/json" \
-d '{
"clientId": "journey-junk",
"period": "last-30-days",
"format": "html"
}'Formats: html, json, pdf (planned).
What's in a report
- Rank trends per keyword
- Total clicks across campaigns
- New backlinks placed
- Account health summary
- Recommended next actions
Recommendations engine
Auto-recommendations based on results:
- Rank declining: increase clicks-per-day
- Rank stable at 10-15: layer in cascades
- Account attrition high: reduce concurrency, run warmup
- New competitor: monitor and run brand-bomb