Skip to content

client-reporting

Fresh

Source: BIBLE.md (Phase 12 Phase 2, client-reporting 4 routes)

Auto-generated reports per client: ranks, clicks, links, activity, recommendations.

Routes (4)

MethodRouteWhat
POST/reports/generateGenerate report for a client
GET/reports/:clientIdLatest report
GET/reports/:clientId/historyPast reports
GET/reports/:clientId/recommendationsAuto 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