该工具围绕 DataForSEO API 提供 SEO 关键词研究工作流，主要面向需要做关键词分析、YouTube 内容研究、竞争对手分析、SERP 分析和趋势追踪的场景。
使用方式：先安装依赖，运行 pip install -r scripts/requirements.txt；然后在项目根目录创建 .env 文件，配置 DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD，凭据可从 https://app.dataforseo.com/api-access 获取。脚本从 scripts/main.py 导入函数调用，例如 keyword_research("AI website builders")。
主要能力：提供多个高层函数，覆盖单关键词深挖、YouTube 内容研究、落地页 SEO、战略内容规划、竞争对手情报和当前趋势查询。keyword_research 收集 overview、suggestions、related keywords、difficulty；youtube_keyword_research 收集 overview、suggestions、YouTube SERP rankings、YouTube trends；landing_page_keyword_research 收集 overview、intent、difficulty、SERP analysis、competitor keywords；full_keyword_analysis 收集 overview、difficulty、intent、keyword ideas、historical volume、Google Trends；competitor_analysis 收集 domain keywords、Google Ads keywords、competitor domains；trending_topics 收集当前 trending searches。
工作流程：每次研究任务分为研究、自动保存、摘要三阶段。调用 API 函数后，结果自动以带时间戳的 JSON 文件保存到 results/{category}/，命名格式为 YYYYMMDD_HHMMSS__operation__keyword__extra_info.json；随后读取保存的 JSON 文件，在 results/summary/ 生成 Markdown 摘要，包含数据表格、机会排序和战略建议。
结果管理：可通过 core.storage 的 list_results、load_result、get_latest_result 列出、加载或获取最新结果；也可通过 main 的 get_recent_results、load_latest 做类似操作。结果目录按 keywords_data、labs、serp、trends、summary 分类。
参数与限制：函数接受可选 location_name 参数，默认 "United States"，也提供布尔开关跳过特定子分析。默认位置为美国（代码 2840），语言为英文。API 限制为：volume/overview 700 个关键词，difficulty/intent 1000 个，trends 5 个，keyword ideas 200 个。更细粒度的 API 函数见 references/api-reference.md，其中列出 25 个 API 函数及参数、限制和示例。
适用场景：SEO 关键词研究、YouTube 内容选题、竞争对手关键词分析、落地页关键词规划、趋势发现和内容策略制定。