Vercel Setup
Connect your Vercel project to track AI crawlers via Log Drains.
- Connect your Vercel account via OAuth
- Understand Log Drains and plan requirements
- Start receiving AI crawler data automatically
If your site is deployed on Vercel, you can connect directly via OAuth. Trakkr uses Vercel's Log Drains to detect AI crawler visits in real time.
Before you start
You'll need:
- A Vercel account with a deployed project
- A Vercel Pro or Enterprise plan (Log Drains are not available on Hobby)
Step 1: Connect via OAuth
- 1Navigate to the Crawler Tracking page in Trakkr
- 2Click Connect on the Vercel card
- 3Click Connect with Vercel
- 4You'll be redirected to Vercel to authorize Trakkr
Trakkr requests two permissions:
| Permission | Why |
|---|---|
| Read project list | So you can select which project to track |
| Create Log Drain | To receive AI crawler visit events |
- 1Click Authorize in Vercel
- 2You'll be redirected back to Trakkr
Step 2: Select a project
After authorization, select the Vercel project you want to track. Trakkr creates a Log Drain for that project, which streams request logs to our servers.
We filter these logs for AI crawler user agents and discard everything else. Human visitor data is never stored.
How Log Drains work
Vercel Log Drains stream server-side request logs to an external endpoint (Trakkr). For each request, Trakkr checks the user agent:
- AI crawler detected (GPTBot, ClaudeBot, etc.) → logged and shown in your dashboard
- Human visitor → immediately discarded, never stored
This runs entirely server-side, so it catches all AI crawlers regardless of JavaScript execution.
Troubleshooting
"Log drain setup failed"
- Confirm you're on a Vercel Pro or Enterprise plan
- Check that you authorized the correct Vercel team/account
- Try disconnecting and reconnecting
No data after connecting
- Log Drains can take a few minutes to activate
- Verify your project has recent deployments and is receiving traffic
- Check that AI crawlers aren't blocked by Vercel's edge middleware or firewall rules
OAuth redirect issues
- Make sure pop-ups aren't blocked in your browser
- Clear your browser cache and try again
- If you use multiple Vercel accounts, ensure you authorize the correct one
Revoking access
To disconnect:
- 1Remove the connection in Trakkr (Crawler Tracking page)
- 2Optionally, revoke Trakkr's access in Vercel: Settings > Integrations > Trakkr > Remove
The Log Drain is automatically removed when you disconnect.
Next steps
Netlify Setup
Connect Netlify for crawler tracking.
AI Pages
Optimize your AI crawler responses.
Was this helpful?