Field guide
Quick reference for common actions.
Create project
- Add canonical root URL (for example
https://example.com). - Projects are used by incidents, timeline, and deep audit views.
Run scan
- Use the main scan input on Dashboard.
- Scan API endpoint:
POST /api/v1/scan.
Deep Audit
- Open Deep Audit to start and monitor crawl jobs.
- Jobs endpoint:
GET /api/v1/deep-audit/.
Google Search Console setup (Pro)
Use this once per environment. After these steps, refresh the project page and click Connect Google.
- In Google Cloud Console, create (or use) an OAuth 2.0 Web application client.
- Add this Authorized redirect URI:
https://seodiff.io/oauth/google/callback. - On your API host, set these env vars in
/etc/seodiff/seodiff.env:SEODIFF_GSC_CLIENT_IDSEODIFF_GSC_CLIENT_SECRETSEODIFF_GSC_REDIRECT_URI=https://seodiff.io/oauth/google/callbackSEODIFF_GSC_TOKEN_ENCRYPTION_KEY(32-byte raw key or base64)
- Restart API service:
sudo systemctl restart seodiff.service. - Deploy UI Worker so callback routing is live:
npx wrangler deploy --config wrangler.toml. - Open your project page, click Connect Google, select property, then click Refresh data.