Keyword Volume Tool

Keyword Volume Tool is a local command-line helper Cyanvid is setting up for internal SEO keyword research. It is not publicly available, and its Google Ads account access and live API requests have not yet been verified.

Google Ads data and authorization

The helper is designed to request approximate historical keyword search-volume metrics from the Google Ads API. These estimates inform internal SEO research; they are not exact search counts or organic traffic measurements.

The operator authorizes a Google account in a browser. The helper reads a local OAuth client file and receives the authorization callback on the same computer. Its Google Ads OAuth scope (https://www.googleapis.com/auth/adwords) is broad: Google describes it as allowing Ads accounts and data to be viewed, modified, created, and deleted. The CLI is implemented to request keyword metrics; it does not create or change ads.

How data is handled

The CLI reads keywords from standard input or a local file. For a metrics request, it sends the keywords, Ads customer ID, access token, and any specified manager ID, geographic targets, language, and search network directly to Google. OAuth requests also go to Google. The helper has no application-owned server or other third-party service in this flow; browser networking is controlled separately by the browser. Google's processing is subject to Google's Privacy Policy.

By default, the CLI stores the refresh token and associated OAuth client ID unencrypted in ~/.config/kw-volume-api/refresh-token.json, with file permissions set to 0600. A different token file can be selected. The token remains until local logout or manual deletion; logout does not revoke the Google authorization. The operator can revoke access through their Google Account. Access tokens are held in process memory.

The CLI does not by default write keywords or results to application logs or files; it prints results to standard output. An input file, redirected output, terminal, browser, operating system, backups, and Google's own data handling are outside the CLI's control.

See the Privacy Policy for more information.

Contact

Questions about the helper or privacy: support@cyanvid.com.