Keyword Volume Tool 关键词研究助手

Keyword Volume Tool 是 Cyanvid 正在筹备的本地命令行助手，用于内部 SEO 关键词研究。该助手不对公众开放，Google Ads 账号访问和实时 API 请求尚未验证。

Google Ads 数据与授权

该助手旨在通过 Google Ads API 获取关键词的近似历史搜索量指标，为内部 SEO 研究提供参考。这些数据是估算值，并非精确搜索次数或自然搜索流量。

操作人员在浏览器中授权 Google 账号；助手读取本地 OAuth 客户端文件，并在同一台电脑上接收授权回调。Google Ads OAuth 权限范围（https://www.googleapis.com/auth/adwords）较广：Google 对该权限的描述包括查看、修改、创建和删除 Ads 账号及数据。该命令行工具实现的用途是请求关键词指标，不会创建或修改广告。

数据处理方式

命令行工具从标准输入或本地文件读取关键词。请求指标时，它会将关键词、Ads 客户 ID、访问令牌，以及指定的管理账号 ID、地理位置、语言和搜索网络直接发送给 Google；OAuth 请求也发送给 Google。此流程没有使用应用自有服务器或其他第三方服务；浏览器的网络连接由浏览器另行控制。Google 对数据的处理适用 Google 隐私权政策。

默认情况下，命令行工具将刷新令牌和对应的 OAuth 客户端 ID 不加密地保存在 ~/.config/kw-volume-api/refresh-token.json，文件权限设为 0600；也可选择其他令牌文件。令牌保留至本地退出登录或手动删除；退出登录不会撤销 Google 授权，操作人员可在 Google 账号中撤销访问。访问令牌保存在进程内存中。

命令行工具默认不将关键词或结果写入应用日志或文件，而是将结果输出到标准输出。输入文件、重定向的输出、终端、浏览器、操作系统、备份以及 Google 自身的数据处理不受该工具控制。

详情见隐私政策。

联系我们

如对该助手或隐私有疑问，请联系 support@cyanvid.com。