用途：基于 Yandex Cloud Search API v2 的 Wordstat API 分析搜索需求、语义核心、查询频次与季节性，用于关键词研究与广告投放前的需求调研。
主要能力：提供多个脚本。quota.sh 检查 API 连接；top_requests.sh 获取高频搜索短语，支持最多 2000 条结果与 CSV 导出，输出分为 top（含原词的高频变体）和 assoc（语义相关词）两部分；dynamics.sh 获取搜索量随时间的变化，支持 daily、weekly、monthly；regions_stats.sh 获取地域分布；regions_tree.sh 列出常用地区 ID；search_region.sh 按名称查找地区 ID。
使用方式：需先配置授权，可选服务账号 JSON 密钥的 IAM（脚本自动获取并刷新令牌）或服务账号 API 密钥（不自动刷新），配置说明见 config/README.md。使用前应先询问用户目标地区和所售产品，再运行分析，并对每个候选查询用网络搜索验证意图，报告中区分目标与非目标查询并说明理由。常用命令如 bash scripts/quota.sh、bash scripts/top_requests.sh --phrase "юрист дтп" --regions "213" --devices "all"、bash scripts/dynamics.sh --phrase "юрист дтп" --period "monthly" --from-date "2025-01-01"。
限制：dynamics 在 --period weekly|monthly 时仅支持 + 操作符，减号词、引号、分组和精确形式仅在 daily 下有效，脚本会在发送请求前校验并报错。CSV 为 UTF-8 带 BOM，列为 n;phrase;impressions;type。配额与限制以 Yandex Search API 文档为准。资料未提供具体收费与价格信息。