--- name: cloudflare description: Cloudflare CLI - manage DNS records, purge cache, and control Workers routes. version: 1.0.0 author: dbhurley homepage: https:\/\/cloudflare.com metadata: clawdis: emoji: "🔶" requires: bins: ["python3", "uv"] env: - CLOUDFLARE_API_TOKEN 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`: ```json { "skills": { "cloudflare": { "env": { "CLOUDFLARE_API_TOKEN": "your-token" } } } } ``` ## 📋 Commands ### Verify Token ```bash # Test that your token works uv run {baseDir}\/scripts\/cloudflare.py verify ``` ### Zones (Domains) ```bash # List all zones uv run {baseDir}\/scripts\/cloudflare.py zones # Get zone details uv run {baseDir}\/scripts\/cloudflare.py zone ``` ### DNS Records ```bash # List DNS records for a zone uv run {baseDir}\/scripts\/cloudflare.py dns list # Add DNS record uv run {baseDir}\/scripts\/cloudflare.py dns add --type A --name www --content 1.2.3.4 uv run {baseDir}\/scripts\/cloudflare.py dns add --type CNAME --name blog --content example.com # Update DNS record uv run {baseDir}\/scripts\/cloudflare.py dns update --content 5.6.7.8 # Delete DNS record (asks for confirmation) uv run {baseDir}\/scripts\/cloudflare.py dns delete # Delete without confirmation uv run {baseDir}\/scripts\/cloudflare.py dns delete --yes ``` ### Cache ```bash # Purge everything uv run {baseDir}\/scripts\/cloudflare.py cache purge --all # Purge specific URLs uv run {baseDir}\/scripts\/cloudflare.py cache purge --urls "https:\/\/example.com\/page1,https:\/\/example.com\/page2" # Purge by prefix uv run {baseDir}\/scripts\/cloudflare.py cache purge --prefix "\/blog\/" ``` ### Workers Routes ```bash # List routes uv run {baseDir}\/scripts\/cloudflare.py routes list # Add route uv run {baseDir}\/scripts\/cloudflare.py routes add --pattern "*.example.com\/*" --worker my-worker ``` ## 📤 Output Formats All commands support `--json` for machine-readable output: ```bash uv run {baseDir}\/scripts\/cloudflare.py dns list example.com --json ``` ## 🔗 Common Workflows ### Point domain to Vercel ```bash # 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 ```bash cloudflare cache purge example.com --all ``` ## 📦 Installation ```bash clawdhub install cloudflare ```