用途：为需要 Google Keyword Planner 关键词创意或历史月度指标的场景，在明确语言、地域、时间范围和网络上下文中做只读采集，并把证据离线留存。返回的搜索量与出价属于 Planner 信号，不是 YouTube 实测需求、RPM 或收入。
主要能力：ideas 采集全部创意页；historical 按有界批次采集指定词；portfolio 子命令可 list/show/search/export，并支持 trace、coverage、diff、variants、integrity、safe-stats，用于回溯收据、查看覆盖状态、比较已存快照、保留近似变体谱系、校验完整性及计算不含异常与不完整行的描述性统计。
用法：先安装并验证 CLI：npx -y @mvanhorn/printing-press-library install keyword-planner --cli-only，再运行 keyword-planner-pp-cli --version 与 doctor --json。认证使用 OAuth 刷新令牌，从 ~/.env 读取 GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_REFRESH_TOKEN，另有 GOOGLE_ADS_CUSTOMER_ID 与可选 GOOGLE_ADS_LOGIN_CUSTOMER_ID；授权需具备 AdWords 范围，Cloud 项目需启用 Google Ads API 并有 Basic 或 Standard 访问权限，令牌不进入证据库。数据策略建议六到八个主题级种子词，语言与地域须用官方资源名，默认范围为最近十二个已结束 UTC 月份；缺失月份与缺失 CPC 记为不可用，不推断为零，重复请求会生成新快照。
限制：不用于广告系列或出价变更、账号管理、Google Trends、自动评分、预测、排程或收入预测；空地域需显式确认；当前或未来请求月份会被拒绝；配额错误仅可对瞬时限流做有界重试。