Skip to main content

Find cloudflare DNS records using fuzzy search.

Project description

CloudFlare Fuzzy Finder

Build Status Downloads Latest version Format Status License Support version

cloudflare-fuzzy-finder aims at checking DNS record more easily. It will connect to CloudFlare's API and get all DNS records from your account, and allow to search on fuzzy finder. Once pressing Enter on highlighted record, it will popup to the CloudFlare website for you to manage the record on that domain.


It is inspired by pmazurek/aws-fuzzy-finder and built on top of fzf binaries and python-cloudflare.


To install use the following command:

pip install cloudflare-fuzzy-finder

This package uses cloudflare-python to authenticate, so if you haven't used before, you have to get the api key from your profile and put into following files like:

$ cat ~/.cloudflare/cloudflare.cfg
email =
token = 00000000000000000000000000000000
certtoken = v1.0-...
extras =

More information on alternative ways of configuring your CF_API_EMAIL, CF_API_KEY and CF_API_CERTKEY variables can be found here:


The loading time on records list highly dependent on the API calls to CloudFlare to fetch all the DNS records across the domain belongs to you.

The cache on DNS records is turn on by default and keep for 1 hour.

If you want to fine tune the duration on keeping the record locally, you can update by CF_FUZZ_CACHE_EXPIRY.

Or if you want to perform the search without using the cache, cau use cf-fuzzy --no-cache.

Or you can append this to your ~/.bashrc to make the settings permamant:

export CF_FUZZ_USE_CACHE=true
export CF_FUZZ_CACHE_EXPIRY=3600 # in terms of seconds
export CF_RECORD_TYPES=cname,a

Remeber that every change to ~/.bashrc requires you to re-load it: source ~/.bashrc or restart terminal.


To run, use the following command:


To search any records other than CNAME & A, use the following command:

cf-fuzzy --record-types mx,txt


If you are managing lots of domains and downloading the data takes too long, you can use the built in cache. To enable it set the following variables in your .bashrc:

export CF_FUZZ_USE_CACHE=true
export CF_FUZZ_CACHE_EXPIRY=3600 # in terms of seconds

To invalidate cache and refresh data, run with --no-cache param Cache will be stored as a file in ~/.cloudflare_fuzzy_finder.cache.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cloudflare-fuzzy-finder-0.1.4.tar.gz (3.5 MB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page