LogoGEOLY Docs
LogoGEOLY Docs
Homepage
What‘s the GEOly?PromptsShopping
Basic Management Function
GEOly CLI: Use GEOly from Your Own AgentGeoly Integration with CloudflareGA4 Operation Manual —— AI Agent AnalyticsGEOly MCP User Guide
Explore: AI Market & Brand Research
How to create an llms.txt file for my websiteKnow What's the llms.txt
How to SetupWhat is Catalog Optimization
Development

Geoly Integration with Cloudflare

I. Integration Background & Value

By integrating with Cloudflare, Geoly enables brand owners to conduct in-depth analysis of server-side AI crawler traffic. Unlike Google Analytics (GA4), which focuses on "human users clicking AI links to visit a site," Cloudflare specifically addresses:

  • Which AI bots are crawling my site? (e.g., GPTBot, ClaudeBot, PerplexityBot)
  • What specific content are they crawling? (Top crawled pages)
  • What are the crawling frequencies and trends?
  • Which crawlers are being intercepted by security rules?

II. Connection Steps

To complete the connection, you will need:

  1. Zone ID
  2. API Token

1️⃣ Get Zone ID

  1. Log in to the Cloudflare Dashboard.
  2. Navigate to Websites and select your target domain. obtain zone_id
  3. Scroll down to the API section on the right side of the Overview page. copied zone_id show zone_id
  4. Copy the Zone ID.

2️⃣ Create API Token

It is recommended to create a token with minimum required permissions:

  1. Click Get your API token → Go to API Tokens → Click Create Token. create api_token
  2. Select Create Custom Token.
  3. Configure as follows:
    • Token Name: Geoly AI Analytics
    • Permissions (Required):
      • Account → Account Analytics → Read
      • Zone → Zone → Read
      • Zone → Analytics → Read
    • Zone Resources:
      • Include → Specific zone → Select your domain configuration
  4. Click Continue to summary. continue_summary
  5. After creation, copy the API Token (it will only be displayed once).

3️⃣ Bind in Geoly

  1. Go to: Agent Analytics → Platform Settings.
  2. Locate Cloudflare and click Connect Cloudflare.
  3. Enter the:
    • Zone ID
    • API Token
  4. Submit and complete the verification. submit

III. Feature Overview

3.1 Core Metrics

MetricDescription
AI Bot RequestsTotal volume of HTTP requests from all AI crawlers
Traffic ShareAI bot traffic as a percentage of total traffic
Detected BotsNumber of active AI platforms identified
Blocked EventsNumber of interceptions by WAF / Bot rules

3.2 Visualized Data

  • AI Traffic Trends: Daily visualization of access frequency by AI platform (ChatGPT, Claude, Gemini, etc.). cloudflare data
  • Top Crawled Pages: Ranking of URLs accessed most frequently by bots.
  • Crawler Distribution: Geographical distribution (typically concentrated in data centers). data
  • Blocked Event Logs: Details including bot name, crawl path, action taken (Block/Challenge), and timestamp.

IV. FAQ

Q1: Why is there no data after connecting?

  • Data Latency: It usually takes 1–2 hours for data to sync.
  • No Bot Activity: No AI crawlers have visited your site yet.
  • Insufficient Permissions: Ensure the token includes Analytics Read permissions.

Q2: Which crawlers are currently supported? Currently supported bots include: GPTBot (ChatGPT), ClaudeBot, Google-Extended (Gemini), Perplexity, Grok, Cohere, Bytespider (ByteDance), and more.

Q3: Will this affect website performance? No.

  • Data is retrieved solely via Cloudflare's backend API.
  • No frontend scripts are injected.
  • It does not impact user traffic or page loading speeds.

GEOly CLI: Use GEOly from Your Own Agent

Install the GEOly CLI, authorize once, and your coding agent — Claude Code, Codex, Cursor, or any agent that can run shell commands — can query your brand's AI visibility data directly. The credential stays on your machine and usage draws on your organization's own credits.

GA4 Operation Manual —— AI Agent Analytics

Next

Table of Contents

I. Integration Background & Value
II. Connection Steps
1️⃣ Get Zone ID
2️⃣ Create API Token
3️⃣ Bind in Geoly
III. Feature Overview
3.1 Core Metrics
3.2 Visualized Data
IV. FAQ