cloudflare
Cloudflare CLI - manage DNS records, purge cache, and control Workers routes.
When & Why to Use This Skill
The Cloudflare CLI skill empowers users to manage their web infrastructure directly through Claude. It provides a comprehensive interface for handling DNS records, purging edge cache, and configuring Workers routes, significantly streamlining DevOps workflows and domain management tasks without leaving the terminal or chat interface.
Use Cases
- DNS Management: Rapidly add, update, or delete A and CNAME records when migrating domains or deploying new web services.
- Automated Cache Purging: Instantly clear Cloudflare's global cache after a site deployment to ensure users receive the most up-to-date content.
- Serverless Routing: Manage and list Cloudflare Workers routes to control how traffic is directed to your serverless functions.
- Infrastructure Auditing: Retrieve detailed information about zones and DNS configurations for security audits and configuration reviews.
- Deployment Workflows: Integrate DNS updates and cache invalidation into automated deployment pipelines for platforms like Vercel or Netlify.
| name | cloudflare |
|---|---|
| description | Cloudflare CLI - manage DNS records, purge cache, and control Workers routes. |
| version | 1.0.0 |
| author | dbhurley |
| homepage | https://cloudflare.com |
| emoji | "🔶" |
| bins | ["python3", "uv"] |
| primaryEnv | CLOUDFLARE_API_TOKEN |
Cloudflare CLI
Manage Cloudflare DNS, cache, and Workers via the API.
🔑 Required Secrets
| Variable | Description | How to Get |
|---|---|---|
CLOUDFLARE_API_TOKEN |
Scoped API token | Cloudflare → My Profile → API Tokens |
Recommended token permissions:
- DNS:Read, DNS:Edit
- Cache Purge:Purge
- Workers Routes:Edit
⚙️ Setup
Configure in ~/.clawdis/clawdis.json:
{
"skills": {
"cloudflare": {
"env": {
"CLOUDFLARE_API_TOKEN": "your-token"
}
}
}
}
📋 Commands
Verify Token
# Test that your token works
uv run {baseDir}/scripts/cloudflare.py verify
Zones (Domains)
# List all zones
uv run {baseDir}/scripts/cloudflare.py zones
# Get zone details
uv run {baseDir}/scripts/cloudflare.py zone <zone_id_or_domain>
DNS Records
# List DNS records for a zone
uv run {baseDir}/scripts/cloudflare.py dns list <domain>
# Add DNS record
uv run {baseDir}/scripts/cloudflare.py dns add <domain> --type A --name www --content 1.2.3.4
uv run {baseDir}/scripts/cloudflare.py dns add <domain> --type CNAME --name blog --content example.com
# Update DNS record
uv run {baseDir}/scripts/cloudflare.py dns update <domain> <record_id> --content 5.6.7.8
# Delete DNS record (asks for confirmation)
uv run {baseDir}/scripts/cloudflare.py dns delete <domain> <record_id>
# Delete without confirmation
uv run {baseDir}/scripts/cloudflare.py dns delete <domain> <record_id> --yes
Cache
# Purge everything
uv run {baseDir}/scripts/cloudflare.py cache purge <domain> --all
# Purge specific URLs
uv run {baseDir}/scripts/cloudflare.py cache purge <domain> --urls "https://example.com/page1,https://example.com/page2"
# Purge by prefix
uv run {baseDir}/scripts/cloudflare.py cache purge <domain> --prefix "/blog/"
Workers Routes
# List routes
uv run {baseDir}/scripts/cloudflare.py routes list <domain>
# Add route
uv run {baseDir}/scripts/cloudflare.py routes add <domain> --pattern "*.example.com/*" --worker my-worker
📤 Output Formats
All commands support --json for machine-readable output:
uv run {baseDir}/scripts/cloudflare.py dns list example.com --json
🔗 Common Workflows
Point domain to Vercel
# Add CNAME for apex
cloudflare dns add example.com --type CNAME --name @ --content cname.vercel-dns.com --proxied false
# Add CNAME for www
cloudflare dns add example.com --type CNAME --name www --content cname.vercel-dns.com --proxied false
Clear cache after deploy
cloudflare cache purge example.com --all
📦 Installation
clawdhub install cloudflare