🔍 cloudflarefetchcli

Read-Only. Beautiful. Insightful.

Explore your Cloudflare infrastructure with zero risk. No changes, no deletions, just pure visibility.

✨ Why cloudflarefetchcli?

100% Read-Only Operations — Zero risk to your infrastructure. Perfect for:

• 🔍 Auditing your Cloudflare setup
• 📊 Monitoring traffic and security
• 🔎 Exploring DNS configurations
• 📋 Documenting your infrastructure
• 🛡️ Security reviews without touching anything

Beautiful Terminal Output — Because CLI tools should be gorgeous:

• 🎨 Color-coded status indicators
• 📊 Formatted tables with borders
• 🌍 Visual analytics and insights
• ✅ Clear success/error messaging

🚀 Installation

npm install -g cloudflarefetchcli

🔐 Quick Setup

1. Get Your Cloudflare API Token

1. Visit Cloudflare API Tokens
2. Click "Create Token"
3. Use the "Read all resources" template
4. Copy your token

2. Configure cloudflarefetchcli

# Save your API token (read-only recommended)
cloudflarefetchcli set-token YOUR_API_TOKEN

# Save your Account ID (optional, for Workers/Pages/Tunnels)
cloudflarefetchcli set-account YOUR_ACCOUNT_ID

# Verify configuration
cloudflarefetchcli config

💡 Security Tip: Create a token with read-only permissions for maximum safety. The CLI never modifies anything.

📚 Commands

🌐 Domain Exploration

# List all your domains with status and plan
cloudflarefetchcli domains

# Get comprehensive domain details
cloudflarefetchcli info example.com

# Check domain availability (WHOIS lookup)
cloudflarefetchcli check google.com

📋 DNS Inspection

# View all DNS records beautifully formatted
cloudflarefetchcli dns example.com

# Export DNS records as JSON
cloudflarefetchcli dns example.com --raw

📊 Analytics & Insights

# View domain analytics (requires Pro plan)
cloudflarefetchcli analytics example.com

# See traffic by country
cloudflarefetchcli countries example.com --days 7

🛡️ Security Audit

# Review firewall rules
cloudflarefetchcli firewall example.com

# Check SSL/TLS configuration
cloudflarefetchcli ssl example.com

# View page rules
cloudflarefetchcli pagerules example.com

⚡ Cloudflare Platform

# List Workers scripts
cloudflarefetchcli workers

# View KV namespaces
cloudflarefetchcli kv

# List D1 databases
cloudflarefetchcli d1

# View R2 buckets
cloudflarefetchcli r2

# List Cloudflare Tunnels
cloudflarefetchcli tunnels

# View Pages projects
cloudflarefetchcli pages

# Check registered domains
cloudflarefetchcli registered

🗑️ Cache Inspection

# View cache status (shows what would be purged)
cloudflarefetchcli purge example.com --dry-run

🎨 Beautiful Output Examples

Domain List

☁️  Your Cloudflare Domains

──────────────────────────────────────────────────────────────────────
Domain                         Status       Plan            Zone ID
──────────────────────────────────────────────────────────────────────
example.com                    active       Free Website    abc123...
mydomain.net                   active       Pro             def456...
──────────────────────────────────────────────────────────────────────
✓ 2 domain(s) found

DNS Records

📋 DNS Records for example.com

──────────────────────────────────────────────────────────────────────────
Type     Name                           Content                           TTL
──────────────────────────────────────────────────────────────────────────
A        @                              192.0.2.1                        3600 ☁️
CNAME    www                            example.com                      3600 ☁️
MX       @                              10 mail.example.com              3600
TXT      @                              v=spf1 include:_spf...           3600
──────────────────────────────────────────────────────────────────────────
✓ 4 record(s) found

WHOIS Lookup

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 Checking: example.com
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Status:      ❌ REGISTERED

Registrar:   Example Registrar, LLC

📅 Dates:
  Created:   2020-01-15
  Updated:   2024-01-10
  Expires:   2025-01-15
  ✓ Expires in 312 days

🔒 Domain Status:
  ✓ ok - Active
  ⛔ clientTransferProhibited - Transfer locked

🔒 Security & Privacy

• Read-Only by Design — No modifications, ever
• Local Config Storage — API tokens stored in ~/.config/cloudflarefetchcli/ with 0600 permissions
• No Telemetry — Zero tracking or analytics
• Environment Variable Support — Use CF_API_TOKEN and CF_ACCOUNT_ID if preferred

⚙️ Configuration

Environment Variables

export CF_API_TOKEN="your-api-token"
export CF_ACCOUNT_ID="your-account-id"

cloudflarefetchcli domains

Config File Location

• Linux/macOS: ~/.config/cloudflarefetchcli/config.json
• Windows: %APPDATA%\cloudflarefetchcli\config.json

📦 Requirements

• Node.js 18.0.0 or higher
• whois command (for domain availability checks)
• dig command (optional, for DNS resolution display)

Installing Dependencies

Ubuntu/Debian:

sudo apt-get install whois dnsutils

macOS:

brew install whois bind

RHEL/CentOS:

sudo yum install whois bind-utils

🤝 Contributing

Contributions welcome! This is a read-only tool focused on safe infrastructure exploration.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 Changelog

v1.0.0

• ✨ Initial release
• 🔍 Read-only domain exploration
• 📋 DNS record inspection
• 📊 Analytics viewing
• 🛡️ Security audit features
• ⚡ Workers, KV, D1, R2, Tunnels support
• 🎨 Beautiful terminal output

👥 Credits

• Created by: tri (@fevnem)
• Contributors: cakecommand — AI Assistant

📄 License

MIT © tri